Installation - Aion Docs

Prerequisites

Python 3.12
pip or poetry

Install CLI

pip install aion-sdk

Poetry projects can add the package directly:

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	✅	✅

pip install "aion-sdk[langgraph-server]"
pip install "aion-sdk[adk-server]"
pip install "aion-sdk[all]"

Poetry equivalent:

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:

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 for full settings.

Minimal `aion.yaml`

aion:
  agents:
    support:
      path: "./agent.py:build_graph"
      framework: "langgraph"

Verify CLI

aion --help
aion serve --help
aion chat --help