> ## Documentation Index
> Fetch the complete documentation index at: https://uip-f4b0bbe5.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Python SDK

> pip install agcms

## Install

```bash theme={null}
pip install agcms
```

Requires Python 3.9+.

## AGCMSClient

```python theme={null}
from agcms import AGCMSClient

client = AGCMSClient(
    base_url="https://api.your-tenant.agcms.com",
    api_key="agc_live_...",
    user_id="alice@corp",       # optional — propagated to audit
    department="support",       # optional
)

resp = client.chat.completions.create(
    model="groq:llama-3.3-70b-versatile",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(client.last_interaction_id)
```

There is also `AsyncAGCMSClient` with the same API and `await client.chat.completions.create(...)`.

## openai\_wrap

3-line drop-in for the official `openai` client:

```python theme={null}
from openai import OpenAI
from agcms import openai_wrap

client = openai_wrap(OpenAI(api_key="..."), agcms_base_url="...", agcms_api_key="...")
```

`embeddings`, `files`, and other namespaces fall through to the original
OpenAI client unchanged — only `chat.completions.create(...)` is rerouted.

## Errors

```python theme={null}
from agcms import AGCMSError, BlockedError, RateLimitedError, AuthError, UpstreamError

try:
    client.chat.completions.create(...)
except BlockedError as e:
    # AGCMS policy refused this request
    log.warning("blocked", reason=str(e), interaction=e.interaction_id)
```

## CLI

```bash theme={null}
agcms verify bundle.zip
agcms version
```