Skip to main content
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

​
Available Packages

PackagePurpose
aion-sdkStarts local agent processes, the proxy, and developer tools such as aion serve and aion chat.
aion-serverHosts A2A-compatible HTTP endpoints for configured agents and loads framework server integrations.
aion-server-langgraphLangGraph server integration for execution, checkpointing, and request mapping.
aion-server-adkGoogle ADK server integration for execution, sessions, and request mapping.
aion-api-clientAPI access and typed control-plane addressing models.
aion-mcpAuthenticated MCP endpoints for Aion MCP servers.
aion-agent-sdkShared authoring primitives for Aion-aware agents and framework-agnostic models.
aion-adkGoogle ADK model helpers for Aion’s model service.
aion-authoring-adkGoogle ADK MCP authoring helpers.
aion-authoring-langgraphLangGraph 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.