Metadata-Version: 2.4
Name: atlan-application-sdk
Version: 3.0.1
Summary: Atlan Application SDK is a Python library for developing applications on the Atlan Platform
Project-URL: Repository, https://github.com/atlanhq/application-sdk
Project-URL: Documentation, https://github.com/atlanhq/application-sdk/README.md
Project-URL: Changelog, https://github.com/atlanhq/application-sdk/blob/main/CHANGELOG.md
Author-email: Atlan App Team <connect@atlan.com>
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: app,atlan,development,platform,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: aiohttp<3.14.0,>=3.10.0
Requires-Dist: fastapi[standard]==0.127.0
Requires-Dist: httpx-retries<0.5.0,>=0.4.0
Requires-Dist: loguru<0.8.0,>=0.7.3
Requires-Dist: obstore<0.10.0,>=0.9.1
Requires-Dist: opentelemetry-exporter-otlp==1.39.1
Requires-Dist: opentelemetry-exporter-prometheus==0.60b1
Requires-Dist: orjson<3.12.0,>=3.11.6
Requires-Dist: psutil<7.3.0,>=7.0.0
Requires-Dist: pyatlan<10,>=9
Requires-Dist: pydantic<2.13.0,>=2.10.6
Requires-Dist: python-dotenv<1.3.0,>=1.1.0
Requires-Dist: pyyaml<6.1.0,>=6.0.2
Requires-Dist: temporalio<1.24.0,>=1.7.1
Requires-Dist: uvloop<0.23.0,>=0.21.0; sys_platform != 'win32'
Provides-Extra: azure
Requires-Dist: azure-identity>=1.15.0; extra == 'azure'
Requires-Dist: azure-storage-blob>=12.19.0; extra == 'azure'
Requires-Dist: azure-storage-file-datalake>=12.19.0; extra == 'azure'
Provides-Extra: daft
Requires-Dist: daft<0.8.0,>=0.7.1; extra == 'daft'
Provides-Extra: distributed-lock
Requires-Dist: redis[hiredis]<7.2.0,>=5.2.0; extra == 'distributed-lock'
Provides-Extra: iam-auth
Requires-Dist: boto3<1.43.0,>=1.38.6; extra == 'iam-auth'
Provides-Extra: incremental
Requires-Dist: daft<0.8.0,>=0.7.1; extra == 'incremental'
Requires-Dist: duckdb-engine<0.18.0,>=0.17.0; extra == 'incremental'
Requires-Dist: duckdb<1.5.0,>=1.1.3; extra == 'incremental'
Requires-Dist: pandas<2.4.0,>=2.2.3; extra == 'incremental'
Requires-Dist: pyarrow<23.0.0,>=20.0.0; extra == 'incremental'
Requires-Dist: rocksdict>=0.3.0; extra == 'incremental'
Requires-Dist: sqlalchemy[asyncio]<2.1.0,>=2.0.36; extra == 'incremental'
Provides-Extra: mcp
Requires-Dist: fastmcp>=3.2.0; extra == 'mcp'
Provides-Extra: pandas
Requires-Dist: pandas<2.4.0,>=2.2.3; extra == 'pandas'
Requires-Dist: pyarrow<23.0.0,>=20.0.0; extra == 'pandas'
Provides-Extra: scale-data-generator
Requires-Dist: faker<39.1.0,>=37.1.0; extra == 'scale-data-generator'
Requires-Dist: numpy<2.5.0,>=1.23.5; extra == 'scale-data-generator'
Provides-Extra: sql
Requires-Dist: duckdb-engine<0.18.0,>=0.17.0; extra == 'sql'
Requires-Dist: duckdb<1.5.0,>=1.1.3; extra == 'sql'
Requires-Dist: pandas<2.4.0,>=2.2.3; extra == 'sql'
Requires-Dist: pyarrow<23.0.0,>=20.0.0; extra == 'sql'
Requires-Dist: sqlalchemy[asyncio]<2.1.0,>=2.0.36; extra == 'sql'
Provides-Extra: sqlalchemy
Requires-Dist: sqlalchemy[asyncio]<2.1.0,>=2.0.36; extra == 'sqlalchemy'
Provides-Extra: tests
Requires-Dist: httpx<0.29.0,>=0.27.0; extra == 'tests'
Requires-Dist: pandera[io]<0.28.0,>=0.23.1; extra == 'tests'
Requires-Dist: pytest-order<1.4.0,>=1.3.0; extra == 'tests'
Provides-Extra: workflows
Requires-Dist: orjson<3.12.0,>=3.11.6; extra == 'workflows'
Requires-Dist: temporalio<1.24.0,>=1.7.1; extra == 'workflows'
Description-Content-Type: text/markdown

# Atlan Application SDK
[![On-Push Checks](https://github.com/atlanhq/application-sdk/actions/workflows/push.yaml/badge.svg)](https://github.com/atlanhq/application-sdk/actions/workflows/push.yaml) [![CodeQL Advanced](https://github.com/atlanhq/application-sdk/actions/workflows/codeql.yaml/badge.svg)](https://github.com/atlanhq/application-sdk/actions/workflows/codeql.yaml) [![PyPI version](https://img.shields.io/pypi/v/atlan-application-sdk.svg)](https://pypi.org/project/atlan-application-sdk/)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/atlanhq/application-sdk)

The Atlan Application SDK is a Python library designed for building applications on the Atlan platform. It offers a full PaaS (Platform-as-a-Service) toolkit — from local development to deployment and partner collaboration — so you can create integrations and tools that seamlessly extend the Atlan experience for our mutual customers.


## Usage

Install `atlan-application-sdk` as a dependency in your project:

- Using uv (recommended):
```bash
uv add atlan-application-sdk
```

- Using pip:
```bash
pip install atlan-application-sdk
```

> [!TIP]
> **View sample apps built using Application SDK [here](https://github.com/atlanhq/atlan-sample-apps)**

## Getting Started

- Want to develop locally or run examples from this repository? Check out our [Getting Started Guide](docs/guides/getting-started.md) for a step-by-step walkthrough!
- Detailed documentation for the application-sdk is available at [docs](https://github.com/atlanhq/application-sdk/blob/main/docs/) folder.

## 🐳 Docker

### Pre-built Base Image (Harbor)

The `app-runtime-base` image provides the runtime environment (Python, Dapr, OS packages) for Atlan apps. It does **not** include the SDK itself — install `atlan-application-sdk` via pip/uv in your app's Dockerfile.

```bash
# Latest main image
docker pull registry.atlan.com/public/app-runtime-base:main-latest

# Versioned image
docker pull registry.atlan.com/public/app-runtime-base:main-2.3.1

# Commit-specific image
docker pull registry.atlan.com/public/app-runtime-base:sha-49c027f
```

> [!NOTE]
> The old image name `registry.atlan.com/public/application-sdk` is deprecated but still published for backward compatibility. New apps should use `app-runtime-base`.

## Contributing

- We welcome contributions! Please see our [Contributing Guide](https://github.com/atlanhq/application-sdk/blob/main/CONTRIBUTING.md) for guidelines.

## Partner Collaboration

- For information on how to collaborate with Atlan on app development and integrations, please see our [Partner Journey Guide](https://docs.atlan.com/product/capabilities/build-apps/partner-with-us/concepts/partner-journey).

## Need help?
We’re here whenever you need us:

- Issues: [GitHub Issues](https://github.com/atlanhq/application-sdk/issues)


## Security

Have you discovered a vulnerability or have concerns about the SDK? Please read our [SECURITY.md](https://github.com/atlanhq/application-sdk/blob/main/SECURITY.md) document for guidance on responsible disclosure, or please e-mail security@atlan.com and we will respond promptly.

## License and Attribution

- This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/atlanhq/application-sdk/blob/main/LICENSE) file for details.
- This project includes dependencies with various open-source licenses. See the [NOTICE](https://github.com/atlanhq/application-sdk/blob/main/NOTICE) file for third-party attributions.
