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

# Quickstart (ADK)

> Run a Google ADK agent behind the Aion A2A server.

## ADK Object Requirements

The ADK adapter expects your configured path to resolve to one of these:

* A `BaseAgent` instance
* A factory function that returns a `BaseAgent` instance

## 1. Define an ADK Agent Module

Create `agent_adk.py`:

```python theme={null}
from google.adk.agents import BaseAgent
from your_project.agents import support_agent


def create_agent() -> BaseAgent:
    return support_agent
```

## 2. Configure `aion.yaml`

```yaml theme={null}
aion:
  agents:
    support_adk:
      path: "./agent_adk.py:create_agent"
      framework: "adk"
      name: "Support ADK Agent"
```

## 3. Optional: Add Control Plane Credentials to `.env`

```bash theme={null}
# .env
AION_CLIENT_ID=your_client_id
AION_CLIENT_SECRET=your_client_secret
```

For Aion-hosted deployments, these are provided by the control plane. Add them
to `.env` only when running outside Aion-hosted deployments or when testing
local control plane connectivity. For more information, see
[Environment Variables](/sdk/python/configuration/environment-variables).

## 4. Start and Test

```bash theme={null}
aion serve
aion chat --host http://localhost:10000 --agent-id support_adk
```

## Next Steps

* [Session Storage](/sdk/python/frameworks/adk/session-storage) — database-backed or in-memory sessions
* [Artifact Storage](/sdk/python/frameworks/adk/artifact-storage) — file artifact backends
* [Message Mapping](/sdk/python/frameworks/adk/message-mapping) — how A2A maps to ADK and back
* [Streaming API](/sdk/python/frameworks/adk/streaming-api) — real-time text streaming and file artifacts
* [Events Reference](/sdk/python/frameworks/adk/events-reference) — A2A events emitted during execution