> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the SDK

> Install atlan-ai for Python or @atlanai/sdk for TypeScript from Atlan's internal distribution.

Both SDKs are distributed org-internal. Neither is on PyPI or public npm, so
the install steps differ from a normal public package.

<Note>
  **Internal release.** Confirm with your Atlan contact that you have
  repository or GitHub Packages access before you start. `atlan-ai` has no
  license assigned and must not be redistributed outside Atlan.
</Note>

## Python

`atlan-ai` requires Python 3.10 or later. Each release is a committed,
checksummed artifact in the `atlanai-sdk-python` repository under
`releases/<version>/`.

Install from a checkout or from any copy of the artifact:

```bash theme={null}
pip install path/to/releases/0.2.0/atlan_ai-0.2.0-py3-none-any.whl
```

In a `uv` or `requirements.txt` setup, pin the artifact by path:

```text theme={null}
atlan-ai @ file:///absolute/path/to/releases/0.2.0/atlan_ai-0.2.0-py3-none-any.whl
```

Verify the artifact before installing it:

```bash theme={null}
cd releases/0.2.0 && shasum -a 256 -c SHA256SUMS
```

### LangChain and LangGraph

`atlan_ai.langchain` needs `langchain-core` in your application. It is imported
lazily, so the core SDK has no framework dependency:

```bash theme={null}
pip install langchain-core
```

## TypeScript and JavaScript

`@atlanai/sdk` requires Node 20 or later, and also runs on Cloudflare Workers
with `nodejs_compat`. It publishes to the GitHub Packages npm registry.

Point the `@atlanai` scope at GitHub Packages once per project, in `.npmrc`:

```ini theme={null}
@atlanai:registry=https://npm.pkg.github.com
```

Authenticate with a token that has `read:packages` — a personal access token
locally, or `NODE_AUTH_TOKEN` in CI. Keep the token out of `.npmrc` in version
control; use your environment or your CI secret store.

```bash theme={null}
npm install @atlanai/sdk
```

`pnpm add` and `yarn add` work the same way. The published package is compiled
JavaScript (ESM and CJS) with type declarations, so plain JavaScript projects
need no TypeScript toolchain.

## Verify the install

<CodeGroup>
  ```python Python theme={null}
  import atlan_ai

  print(atlan_ai.__version__)
  ```

  ```typescript TypeScript theme={null}
  import { SDK_VERSION } from "@atlanai/sdk";

  console.log(SDK_VERSION);
  ```
</CodeGroup>

Printing a version confirms the package resolves. It does not confirm that
export works — that needs credentials and a reachable Gateway. Continue to the
[quickstart](/sdk/quickstart), which ends in a verification step against Agent
Registry.

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="play" href="/sdk/quickstart">
    Initialize a client and report your first trace.
  </Card>

  <Card title="Configuration" icon="gear" href="/sdk/configuration">
    Credentials, environment variables, and export modes.
  </Card>
</CardGroup>