Basic Authentication

This guide covers the simplest way to authenticate with LouieAI using PyGraphistry.

Quick Setup

LouieAI integrates seamlessly with PyGraphistry's authentication system:

import graphistry
import louieai

# Option 1: Using environment variables (recommended)
# Set these in your environment:
# export GRAPHISTRY_USERNAME="your_user"
# export GRAPHISTRY_PASSWORD="your_pass"
# export GRAPHISTRY_SERVER="hub.graphistry.com"  # Optional: defaults to hub.graphistry.com
lui = louieai()  # Automatically uses environment variables

# Option 2: Direct authentication with Graphistry Hub
g = graphistry.register(
    api=3, 
    server="hub.graphistry.com",  # Graphistry Hub (free tier)
    username="your_user", 
    password="your_pass"
)
lui = louieai(g, server_url="https://den.louie.ai")  # Louie cloud server

# Option 3: Direct authentication with Enterprise Server
g = graphistry.register(
    api=3,
    server="your-company.graphistry.com",  # Your enterprise server
    username="your_user",
    password="your_pass"
)
lui = louieai(g, server_url="https://louie.your-company.com")  # Your Louie server

# Option 4: Pass credentials directly (uses default servers)
lui = louieai(username="your_user", password="your_pass")

# Now you can make queries with any method
response = lui("What insights can you find in my data?")
print(lui.text)

That's it! LouieAI will automatically use your PyGraphistry credentials.

Server Configuration

LouieAI requires both a Graphistry server (for authentication) and a Louie server (for AI queries):

Setup	Graphistry Server	Louie Server
Graphistry Hub (Free)	hub.graphistry.com	https://den.louie.ai
Enterprise	your-company.graphistry.com	https://louie.your-company.com

Important: The servers must match - use Hub servers together or enterprise servers together.

How It Works

When you authenticate with PyGraphistry: 1. PyGraphistry handles the authentication with your Graphistry server 2. LouieAI extracts the JWT token from PyGraphistry 3. The token is used for all LouieAI API requests 4. Tokens are automatically refreshed when needed

Advanced Authentication

For more advanced authentication scenarios including: - API key authentication - Multi-tenant usage with isolated clients - Direct credential passing - Multi-server configurations - Error handling and troubleshooting

See the comprehensive Authentication Guide.

Next Steps

Once authenticated, try the Quick Start Guide to make your first queries.