{"id":30111074,"url":"https://github.com/graphistry/louie-py","last_synced_at":"2025-12-24T09:37:03.058Z","repository":{"id":306880155,"uuid":"1026531441","full_name":"graphistry/louie-py","owner":"graphistry","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-04T14:08:34.000Z","size":539,"stargazers_count":6,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-04T18:11:21.060Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/graphistry.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-26T04:39:29.000Z","updated_at":"2025-08-04T14:08:37.000Z","dependencies_parsed_at":"2025-07-28T08:26:10.880Z","dependency_job_id":"0878f3b3-567e-4019-8e92-d392fcd3facb","html_url":"https://github.com/graphistry/louie-py","commit_stats":null,"previous_names":["graphistry/louie-py"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/graphistry/louie-py","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphistry%2Flouie-py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphistry%2Flouie-py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphistry%2Flouie-py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphistry%2Flouie-py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/graphistry","download_url":"https://codeload.github.com/graphistry/louie-py/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphistry%2Flouie-py/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269677801,"owners_count":24457876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-10T05:07:00.266Z","updated_at":"2025-12-24T09:37:03.007Z","avatar_url":"https://github.com/graphistry.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LouieAI Python Client\n\n[![CI](https://github.com/graphistry/louie-py/actions/workflows/ci.yml/badge.svg)](https://github.com/graphistry/louie-py/actions/workflows/ci.yml)\n[![PyPI Version](https://img.shields.io/pypi/v/louieai.svg)](https://pypi.org/project/louieai/)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n\nAI-powered investigation platform for natural language data analysis.\n\n\n\nhttps://github.com/user-attachments/assets/de73f7b3-2862-4298-b9d8-2d38426ab255\n\n[Video: Louie \u003c\u003e Graphistry - Python edition!](https://www.loom.com/share/8d84c9abc0e34df6b233bd7b2e10af9a?sid=4a87707a-79e6-416b-a628-01b5c31c7db3)\n\n\n\n## 🚀 Get Started in 30 Seconds\n\n```python\n# 1. Install\n# pip install louieai\n\n# 2. Authenticate with your PyGraphistry server\nimport graphistry\ngraphistry.register(\n    api=3,\n    server=\"hub.graphistry.com\",  # or your enterprise server\n    username=\"bob@company.com\",   # your actual username\n    password=\"\u003cyour-password\u003e\"    # your actual password\n)\n\n# 3. Start analyzing with natural language\nfrom louieai.notebook import lui\nlui(\"Show me all suspicious transactions from the last week\")\n\n# 4. Access the results\nprint(lui.text)  # Natural language explanation\ndf = lui.df      # Pandas DataFrame with the data\n```\n\n## Install \u0026 Authenticate\n\n```bash\npip install louieai\n```\n\n### Authentication\n\nLouieAI uses PyGraphistry for authentication. You'll need a free account:\n\n1. **Get PyGraphistry credentials** at [hub.graphistry.com](https://hub.graphistry.com) (free signup)\n2. **Set environment variables** or authenticate in code:\n\n```bash\n# Option 1: Environment variables (recommended for notebooks/scripts)\nexport GRAPHISTRY_USERNAME=\"sarah@analytics.com\"\nexport GRAPHISTRY_PASSWORD=\"Analytics2024!\"\nexport GRAPHISTRY_SERVER=\"hub.graphistry.com\"  # or \"my-company.graphistry.com\"\n\n# Optional: Custom Louie endpoint (defaults to https://louie.ai)\nexport LOUIE_URL=\"https://louie-enterprise.company.com\"\n```\n\n```python\n# Option 2: Authenticate in code\nimport graphistry\ngraphistry.register(\n    api=3, \n    server=\"hub.graphistry.com\",  # or your enterprise server\n    username=\"mike@investigations.org\", \n    password=\"password123\"  # example password\n)\n\n# Optional: Use custom Louie server\nfrom louieai import LouieClient\nclient = LouieClient(\n    server_url=\"https://louie.ai\",  # Louie service endpoint (default)\n    server=\"hub.graphistry.com\"      # PyGraphistry server (default)\n)\n```\n\n### Quick Start\n\n```python\n# First, authenticate with your PyGraphistry server\nimport graphistry\ngraphistry.register(\n    api=3,\n    server=\"hub.graphistry.com\",  # or your private server\n    username=\"alice@example.com\",\n    password=\"password123\"  # example password\n)\n\n# Now import and use LouieAI (two options)\n\n# Option 1: New clean import (recommended)\nimport louieai\nlui = louieai()  # Automatically uses PyGraphistry auth\n\n# Option 2: Traditional import\nfrom louieai.notebook import lui\n\n# Ask questions in natural language  \nlui(\"Find accounts sharing payment methods or shipping addresses\")\n\n# Get fraud insights instantly\nprint(lui.text)\n# Output: \"Found 23 suspicious account clusters sharing payment/shipping details:\n# \n# **Payment Card Sharing**:\n# • Card ending 4789: Used by 8 different accounts in 3 days\n# • Card ending 2156: 5 accounts, all created within same hour\n# \n# **Address Clustering**:\n# • 123 Oak St: 12 accounts using same shipping address\n# • suspicious_email@temp.com: 7 accounts with similar email patterns\n# \n# **Risk Assessment**: 67% likely promotional abuse, 23% payment fraud\"\n\n# Access the connection data\nclusters_df = lui.df\nif clusters_df is not None:\n    print(clusters_df.head())\n    #     account_id shared_payment shared_address  cluster_size  risk_score\n    # 0   user_1234      card_4789    123_oak_st            12        7.2\n    # 1   user_5678      card_4789    456_elm_ave            8        6.8  \n    # 2   user_9012      card_2156    123_oak_st            5        8.1\n```\n\n## Documentation\n\n- [User Guide](https://louie-py.readthedocs.io) - Complete usage examples and tutorials\n- [API Reference](https://louie-py.readthedocs.io/en/latest/api/) - Detailed API documentation\n- [Examples](https://louie-py.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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgraphistry%2Flouie-py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgraphistry%2Flouie-py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgraphistry%2Flouie-py/lists"}