# LouieAI Python Client
[](https://github.com/graphistry/louie-py/actions/workflows/ci.yml)
[](https://pypi.org/project/louieai/)
[](LICENSE)
**LouieAI** is an AI-driven investigative platform by [Graphistry](https://www.graphistry.com) that brings generative AI into your data analysis workflows. This Python client library enables you to programmatically interact with Louie.ai using natural language queries.
## Features
- **Simple API**: Send natural language queries and receive structured responses
- **Seamless Authentication**: Integrates with PyGraphistry authentication
- **Rich Responses**: Get text answers, dataframes, and Graphistry visualizations
- **Thread-based Conversations**: Maintain context across multiple queries
- **Type-safe**: Full type hints for better IDE support
*Alpha Release: Core functionality is available with more features coming soon.*
## Installation
Requires Python 3.10+ and an existing Graphistry account.
```bash
# Using uv (recommended)
uv pip install louieai
# Using pip
pip install louieai
```
## Quick Start
```python
import graphistry
import louieai as lui
# Authenticate with your Graphistry account
graphistry.register(api=3, username="your_user", password="your_pass")
# Create a client and ask questions
client = lui.Client()
response = client.ask("Show me patterns in the security logs")
# Access different response types
for text in response.text_elements:
print(text['text'])
for df in response.df_elements:
print(df['table']) # pandas DataFrame
```
## Documentation
- [User Guide](https://louieai.readthedocs.io) - Complete usage examples and tutorials
- [API Reference](https://louieai.readthedocs.io/en/latest/api/) - Detailed API documentation
- [Examples](https://louieai.readthedocs.io/en/latest/examples/) - Common patterns and use cases
## Links
- [Louie.ai Platform](https://louie.ai) - Learn about LouieAI
- [PyGraphistry](https://github.com/graphistry/pygraphistry) - Required for authentication
- [Support](https://github.com/graphistry/louie-py/issues) - Report issues or get help
## Contributing
We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
**For developers**: Check out [DEVELOP.md](DEVELOP.md) for technical setup and development workflow.
## License
Apache 2.0 - see [LICENSE](LICENSE)
The Apache-2.0 license enables easy integration in enterprise environments, Splunk apps, and Jupyter notebooks.
Raw data
{
"_id": null,
"home_page": null,
"name": "louieai",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "Louie.ai, Graphistry, AI, client, investigation",
"author": null,
"author_email": "\"Graphistry, Inc.\" <support@graphistry.com>",
"download_url": "https://files.pythonhosted.org/packages/28/07/909ef2fbbc7d03c1ab442309071a9fd923b00cd22d6c4266c1f4da2981c2/louieai-0.3.0.tar.gz",
"platform": null,
"description": "# LouieAI Python Client\n\n[](https://github.com/graphistry/louie-py/actions/workflows/ci.yml)\n[](https://pypi.org/project/louieai/)\n[](LICENSE)\n\n**LouieAI** is an AI-driven investigative platform by [Graphistry](https://www.graphistry.com) that brings generative AI into your data analysis workflows. This Python client library enables you to programmatically interact with Louie.ai using natural language queries.\n\n## Features\n\n- **Simple API**: Send natural language queries and receive structured responses\n- **Seamless Authentication**: Integrates with PyGraphistry authentication\n- **Rich Responses**: Get text answers, dataframes, and Graphistry visualizations\n- **Thread-based Conversations**: Maintain context across multiple queries\n- **Type-safe**: Full type hints for better IDE support\n\n*Alpha Release: Core functionality is available with more features coming soon.*\n\n## Installation\n\nRequires Python 3.10+ and an existing Graphistry account.\n\n```bash\n# Using uv (recommended)\nuv pip install louieai\n\n# Using pip\npip install louieai\n```\n\n## Quick Start\n\n```python\nimport graphistry\nimport louieai as lui\n\n# Authenticate with your Graphistry account\ngraphistry.register(api=3, username=\"your_user\", password=\"your_pass\")\n\n# Create a client and ask questions\nclient = lui.Client()\nresponse = client.ask(\"Show me patterns in the security logs\")\n\n# Access different response types\nfor text in response.text_elements:\n print(text['text'])\n \nfor df in response.df_elements:\n print(df['table']) # pandas DataFrame\n```\n\n## Documentation\n\n- [User Guide](https://louieai.readthedocs.io) - Complete usage examples and tutorials\n- [API Reference](https://louieai.readthedocs.io/en/latest/api/) - Detailed API documentation\n- [Examples](https://louieai.readthedocs.io/en/latest/examples/) - Common patterns and use cases\n\n## Links\n\n- [Louie.ai Platform](https://louie.ai) - Learn about LouieAI\n- [PyGraphistry](https://github.com/graphistry/pygraphistry) - Required for authentication\n- [Support](https://github.com/graphistry/louie-py/issues) - Report issues or get help\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n**For developers**: Check out [DEVELOP.md](DEVELOP.md) for technical setup and development workflow.\n\n## License\n\nApache 2.0 - see [LICENSE](LICENSE)\n\nThe Apache-2.0 license enables easy integration in enterprise environments, Splunk apps, and Jupyter notebooks.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Python client for Louie.ai (Graphistry's AI investigation platform)",
"version": "0.3.0",
"project_urls": {
"Changelog": "https://github.com/<owner>/louieai/blob/main/CHANGELOG.md",
"Documentation": "https://louieai.readthedocs.io",
"Issue Tracker": "https://github.com/<owner>/louieai/issues",
"Repository": "https://github.com/<owner>/louieai"
},
"split_keywords": [
"louie.ai",
" graphistry",
" ai",
" client",
" investigation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c4a0c73fe579a61d65d7524cf155f79957a1e7e59932b75bae8d4b454a296677",
"md5": "156e456ef6c63ff2bf798cfec7bde14c",
"sha256": "32f198249c66bb4c7930b894aaa1c255abccad71d596ab4c1a4675815e101fd0"
},
"downloads": -1,
"filename": "louieai-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "156e456ef6c63ff2bf798cfec7bde14c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 13397,
"upload_time": "2025-07-29T21:26:44",
"upload_time_iso_8601": "2025-07-29T21:26:44.710148Z",
"url": "https://files.pythonhosted.org/packages/c4/a0/c73fe579a61d65d7524cf155f79957a1e7e59932b75bae8d4b454a296677/louieai-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2807909ef2fbbc7d03c1ab442309071a9fd923b00cd22d6c4266c1f4da2981c2",
"md5": "0e0c86ac68ff8e752681f4159a796fda",
"sha256": "8347f8bc3dbb923d1aff9e3ea9177e7e21fd11e4911ce9a339aaee06f6d5cccc"
},
"downloads": -1,
"filename": "louieai-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "0e0c86ac68ff8e752681f4159a796fda",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 178349,
"upload_time": "2025-07-29T21:26:46",
"upload_time_iso_8601": "2025-07-29T21:26:46.176739Z",
"url": "https://files.pythonhosted.org/packages/28/07/909ef2fbbc7d03c1ab442309071a9fd923b00cd22d6c4266c1f4da2981c2/louieai-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-29 21:26:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "<owner>",
"github_project": "louieai",
"github_not_found": true,
"lcname": "louieai"
}
JSON
