Metadata-Version: 2.4
Name: atlanai
Version: 0.1.0
Summary: Unified Atlan Agent Gateway management and tracing SDK
License-Expression: Apache-2.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pydantic<3,>=2.10
Requires-Dist: python-dateutil<3,>=2.8.2
Requires-Dist: typing-extensions<5,>=4.12
Requires-Dist: urllib3<3,>=2.3
Provides-Extra: tracing
Requires-Dist: opentelemetry-api<2,>=1.39.0; extra == "tracing"
Requires-Dist: opentelemetry-sdk<2,>=1.39.0; extra == "tracing"
Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.39.0; extra == "tracing"
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.3; extra == "langchain"

# atlanai

Unified Python SDK for Atlan agents.

Use `AtlanClient` for the public Agent Gateway management API. Generated
clients are available under `client.raw` and `atlanai.raw`. Management
has no OpenTelemetry dependency or import-time tracing side effect.

Install `atlanai[tracing]` and import `atlanai.tracing` for the
OpenTelemetry-native tracing pipeline. Tracing has its own explicit API key,
workspace, exporter, and lifecycle; it does not reuse the management bearer or
generated REST transport. Existing `atlan_ai` and `atlan_ai.langchain` imports
remain available during the compatibility window.

## Local install

From the repository root, install management only:

```bash
uv venv .venv
source .venv/bin/activate
uv pip install --editable ./python
```

Install optional tracing and LangChain support:

```bash
uv pip install --editable './python[tracing,langchain]'
```

Management takes its Gateway origin and bearer explicitly:

```python
import os

from atlanai import AtlanClient

with AtlanClient(
    os.environ["ATLANAI_GATEWAY_URL"],
    bearer_token=os.environ["ATLANAI_TOKEN"],
) as client:
    page = client.agents.agent_list_agents(limit=10)
    print(len(page.items))
```

See [the complete local setup guide](../docs/getting-started.md) for direct
Registry configuration and the separate tracing environment. The
[generated Python reference](../docs/reference/README.md) covers every raw
operation and model.
