Skip to main content

Prerequisites

  • Python 3.12
  • pip or poetry

Install CLI

pip install aion-cli
Poetry projects can add the package directly:
poetry add aion-cli

Install Framework Extras

Install extras when you want framework adapters bundled with CLI installation.
pip install "aion-cli[langgraph]"
pip install "aion-cli[adk]"
pip install "aion-cli[all]"
Poetry equivalent:
poetry add "aion-cli[langgraph]"
poetry add "aion-cli[adk]"

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