Skip to main content

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.

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-cliStarts local agent processes, the proxy, and developer tools such as aion serve and aion chat.
aion-cli[langgraph]CLI dependency with LangGraph extras including aion-server-langgraph and aion-langgraph.
aion-cli[adk]CLI dependency with Google ADK extras including aion-server-adk and aion-adk.
aion-serverHosts A2A-compatible HTTP endpoints for configured agents and loads framework server integrations.
aion-server-langgraphLangGraph server integration for execution, checkpointing, request mapping, and streaming translation.
aion-server-adkGoogle ADK server integration for execution, session handling, request mapping, and streaming translation.
aion-api-clientConnects to Aion platform APIs over WebSocket transport.
aion-mcpExposes Aion services and configured agent capabilities through MCP-compatible interfaces.
aion-agent-sdkShared authoring primitives for Aion-aware agents and framework-agnostic models.
aion-adkAuthoring-focused Google ADK helpers built on aion-agent-sdk.
aion-langgraphAuthoring-focused LangGraph helpers built on aion-agent-sdk.

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