# Clavis

**Auth0 for AI Agents** — Authentication, token management, and rate limiting for AI agents.

## Installation
```bash
pip install clavis
```

## Quick Start
```python
from clavis import ClavisClient

# Initialize the client
client = ClavisClient(api_key="your-clavis-api-key")

# Get a valid token for any service
token = await client.get_token("my-openai-service")

# Or proxy requests with automatic auth injection
response = await client.proxy(
    "my-openai-service",
    "POST",
    "/v1/chat/completions",
    body={"model": "gpt-4", "messages": messages}
)
```

## Features

- 🔐 **Encrypted credentials** - All API keys encrypted at rest
- 🔄 **Automatic token refresh** - Tokens refreshed proactively before expiry
- 🚦 **Rate limiting** - Cross-agent rate limit tracking with Redis
- 📋 **Audit logging** - Complete history of all auth events
- 🔌 **Multi-service connectors** - OpenAI, Kalshi, Coinbase, and more

## Documentation

Visit [clavisagent.com/docs](https://clavisagent.com/docs) for full documentation.

## License

MIT
