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:

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

Install optional tracing and LangChain support:

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

Management takes its Gateway origin and bearer explicitly:

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 for direct Registry configuration and the separate tracing environment. The generated Python reference covers every raw operation and model.