---
id: pyatlan
version: "10.0.0"
license: Apache LICENSE 2.0
license_treatment: permissive
maintenance: active
---

# pyatlan — Atlan Python Client

License: permissive · Maintenance: active · Downloads: 501.5K/mo

## What it is and what it does

Pyatlan is the official Python client library for Atlan, a metadata management and data governance platform. It provides typed, programmatic access to Atlan's REST API, enabling developers to query, create, update, and manage data assets, lineage, tags, and custom metadata from Python code. The SDK is built on a modern stack including pydantic for validation, httpx for HTTP operations, and msgspec for efficient serialization, with support for both synchronous and async patterns.

The package is designed for production use with active maintenance, comprehensive type hints, and support for current Python versions (3.9–3.14). It includes built-in caching for tags and metadata definitions, retry logic via tenacity, and templating support through Jinja2. Developers typically use it to automate metadata workflows, integrate Atlan with data pipelines, or build custom governance applications.

Use it for:

- Automate bulk asset registration and metadata enrichment across data catalogs.
- Build custom data lineage tracking and impact analysis workflows.
- Integrate Atlan metadata into CI/CD pipelines for automated governance checks.
- Query and manage business glossaries, tags, and custom metadata programmatically.
- Generate typed asset models from your Atlan instance for IDE autocomplete and type safety.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Official Python SDK for Atlan, providing programmatic access to metadata management, asset operations, and data governance features through a typed client interface.

Yes. The package is production-ready, actively maintained with zero known vulnerabilities, has low install friction, and uses a permissive license. Install it if you need to interact with Atlan's metadata platform from Python or automate data governance workflows. The main prerequisite is access to an Atlan instance and valid API credentials.

## Install

pip install pyatlan
uv add pyatlan
poetry add pyatlan

## Installing pyatlan

Before you install: Low friction installation with a pure-Python wheel and modern dependency stack. Active maintenance with a release 1 day old and no known vulnerabilities. Supports Python 3.9 through 3.14.

License in practice: Apache 2.0 permissive license allows commercial and private use with minimal restrictions, suitable for most production deployments.

Quickstart:

pip install pyatlan

from pyatlan.client import Client

client = Client(
    base_url="https://your-tenant.atlan.com",
    api_key="your_api_key"
)

Requires ATLAN_BASE_URL and ATLAN_API_KEY environment variables or explicit credentials to connect to an Atlan instance.

Verify before relying:

- Whether the SDK supports async operations beyond what httpx provides natively.
- Performance characteristics when working with large asset catalogs or complex queries.
- Completeness of type coverage for all Atlan asset types and custom metadata schemas.

## Package facts

- License: Apache LICENSE 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 501.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

atlan python sdk, metadata management client, data governance api, asset catalog python, atlan api client, metadata operations, data lineage sdk, metadata-management, data-governance, api-client

[View on SkillFed](https://skillfed.io/packages/pyatlan) · [View on PyPI](https://pypi.org/project/pyatlan/)