> ## 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.

# Introduction

> Introduction to the Aion Python SDK and its runtime model.

The Aion Python SDK is a server-side toolkit for running agent implementations behind an
A2A-compatible interface. It provides runtime orchestration, framework adapters, and a proxy layer
for multi-agent routing.

GitHub Repository: [Terminal-Research/aion-python-sdk](https://github.com/Terminal-Research/aion-python-sdk)

## Available Packages

| Package                                                         | Purpose                                                                                            |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `aion-sdk`                                                      | Starts local agent processes, the proxy, and developer tools such as `aion serve` and `aion chat`. |
| `aion-server`                                                   | Hosts A2A-compatible HTTP endpoints for configured agents and loads framework server integrations. |
| `aion-server-langgraph`                                         | LangGraph server integration for execution, checkpointing, and request mapping.                    |
| `aion-server-adk`                                               | Google ADK server integration for execution, sessions, and request mapping.                        |
| [`aion-api-client`](/sdk/python/packages/aion-api-client)       | API access and typed control-plane addressing models.                                              |
| [`aion-mcp`](/sdk/python/packages/aion-mcp)                     | Authenticated MCP endpoints for Aion MCP servers.                                                  |
| `aion-agent-sdk`                                                | Shared authoring primitives for Aion-aware agents and framework-agnostic models.                   |
| [`aion-adk`](/sdk/python/packages/aion-adk)                     | Google ADK model helpers for Aion's model service.                                                 |
| [`aion-authoring-adk`](/sdk/python/packages/aion-authoring-adk) | Google ADK MCP authoring helpers.                                                                  |
| `aion-authoring-langgraph`                                      | LangGraph helpers for MCP, streaming, and event routing.                                           |

## Runtime Architecture

* Each configured agent runs in its own server process.
* A proxy server starts automatically and exposes unified routing at
  `/agents/{agent_id}/{path}`.
* Clients can call either direct agent endpoints or proxy endpoints.

## Framework Support

* LangGraph authoring guidance lives in the dedicated `LangGraph` section.
* LangGraph server integration details remain in `Framework Adapters`,
  including checkpointing and message mapping.
* Package-level API reference pages live under `Packages`, including `aion-api-client` and
  `aion-mcp`.
* ADK support focuses on `BaseAgent` execution with pluggable session backends.
* Adapter discovery is plugin-based, allowing additional framework adapters over time.

## Configuration Model

* `aion.yaml` defines agent identities, import paths, framework targets, capabilities, and skills.
* Environment variables provide API credentials, logging settings, and persistence settings.
* Runtime ports are allocated automatically unless explicitly configured via CLI options.