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

# Installation

> Install the Python SDK and optional framework adapters.

## Prerequisites

* Python `3.12`
* `pip` or `poetry`

## Install CLI

```bash theme={null}
pip install aion-sdk
```

Poetry projects can add the package directly:

```bash theme={null}
poetry add aion-sdk
```

## Install Framework Extras

Install extras when you want framework adapters bundled with SDK installation.

| Extra                           | Framework | Authoring | Server |
| ------------------------------- | --------- | :-------: | :----: |
| `aion-sdk[langgraph-authoring]` | LangGraph |     ✅     |        |
| `aion-sdk[langgraph-server]`    | LangGraph |     ✅     |    ✅   |
| `aion-sdk[adk-authoring]`       | ADK       |     ✅     |        |
| `aion-sdk[adk-server]`          | ADK       |     ✅     |    ✅   |
| `aion-sdk[all]`                 | All       |     ✅     |    ✅   |

```bash theme={null}
pip install "aion-sdk[langgraph-server]"
pip install "aion-sdk[adk-server]"
pip install "aion-sdk[all]"
```

Poetry equivalent:

```bash theme={null}
poetry add "aion-sdk[langgraph-server]"
poetry add "aion-sdk[adk-server]"
```

## Optional Control Plane Credentials

For deployments hosted by Aion, these values are supplied by the control plane.
Set them yourself only when running outside Aion-hosted deployments or when
testing a server locally against the Aion control plane.

Create `.env` in your project root when you need to provide them manually:

```bash theme={null}
AION_CLIENT_ID=your_client_id
AION_CLIENT_SECRET=your_client_secret
```

Without these variables, you can still run `aion serve` locally and invoke
agents through the local A2A and proxy endpoints, but the SDK will not connect
to the Aion control plane or register agent manifests automatically.

See [Environment Variables](/sdk/python/configuration/environment-variables) for full settings.

## Minimal `aion.yaml`

```yaml theme={null}
aion:
  agents:
    support:
      path: "./agent.py:build_graph"
      framework: "langgraph"
```

## Verify CLI

```bash theme={null}
aion --help
aion serve --help
aion chat --help
```