# Aither ADK (Agent Development Kit)

> Build AI agent fleets with any LLM backend. Local-first with vLLM/llama.cpp, cloud via Elysium. One `pip install`, one line to connect.

## Install

Windows with nothing installed (no Python, no admin, no account), in PowerShell --
it gets Python (via uv), installs awdk and runs `adk` once:

```powershell
$env:AITHER_INSTALL='toolkit'; irm https://aitherium.com/install.ps1 | iex
```

Any OS with Python 3.10+:


```
pip install awdk
```

## Quick Start — Local Agent

```python
import asyncio
from adk import AitherAgent

async def main():
    agent = AitherAgent("my-agent")  # Auto-detects vLLM/llama.cpp
    response = await agent.chat("Hello!")
    print(response.content)

asyncio.run(main())
```

## Quick Start — Cloud Inference via Elysium

```python
import asyncio
from adk import AitherAgent
from adk.elysium import Elysium

async def main():
    ely = await Elysium.connect(api_key="aither_sk_live_...")
    agent = AitherAgent("my-agent", llm=ely.router)
    response = await agent.chat("Hello from cloud!")
    print(response.content)

asyncio.run(main())
```

## Serve as API

```bash
aither-serve --identity aither --port 8080
```

Exposes OpenAI-compatible endpoints:
- `POST /v1/chat/completions`
- `GET /v1/models`
- `GET /health`

## Features

- **Multi-backend LLM**: vLLM (GPU), llama.cpp (CPU/Mac), OpenAI, Anthropic, Elysium cloud
- **@tool decorator**: Register Python functions as agent tools
- **16 agent identities**: aither, lyra, demiurge, hydra, athena, apollo, etc.
- **Fleet mode**: Multi-agent orchestration with inter-agent delegation
- **Graph memory**: SQLite-backed persistent memory with semantic search
- **MCP bridge**: Connect to mcp.aitherium.com for 200+ tools
- **OpenAI-compatible API**: Drop-in replacement for any OpenAI client

## Elysium Cloud Inference

Register at https://demo.aitherium.com or via API:

```python
ely = Elysium()
await ely.register(email="you@example.com", password="...")
await ely.login(email="you@example.com", password="...")
```

Models available by tier:
- **Free**: aither-small (llama3.2:3b)
- **Pro** ($9/mo): + aither-orchestrator (nemotron-8b)
- **Enterprise**: + aither-reasoning, aither-vision, aither-coding

## Agent Registration

Register your custom agent with the Aitherium network:

```python
ely = await Elysium.connect(api_key="aither_sk_live_...")
await ely.register_agent("my-agent", capabilities=["code", "search"])
agents = await ely.discover_agents(capability="code")
```

## Part of the harness

<!-- aither-harness:start GENERATED from ecosystem.yaml `harness:` by gen_brick_map.py. Edits between these markers are overwritten; change the registry. -->
> **`awdk` is part of `awharness` — the super agent harness.** One name for the kit, the shell and the bricks an agent works with, taken together. It is a harness that sits above other harnesses: the shell drives Claude Code, Codex and the rest as real products, and the bricks give every one of them the same memory, jobs, leases, permits and tools.
>
> **Today:** There is no single install. `pip install awdk` and `npm i -g @aitherium/awsh` are two commands, and each other brick installs on its own line. `adk harness parts` reads this list and reports which parts this machine has, at what version, and the install line for each one it lacks.
>
> **Planned, not built:** One install command that brings the composed bricks up together, and one process that starts them. Neither exists; nothing by this name is published.
>
> The other 10 composed bricks: `awsh` `awskills` `awm` `awgraph` `awrun` `awrise` `awgit` `awpermit` `awrelay` `awnode`. All 93 bricks, in layers: https://aitherium.github.io/#map
<!-- aither-harness:end -->

What the harness adds to a bare agent loop, with the command that shows it:

- Drives other agent products (Claude Code, Codex, Gemini CLI, aider, a real terminal) through one session API: `adk harness harnesses`
- Sessions owned by a daemon, so they outlive the terminal: `adk harness serve`, `adk harness list`, `adk harness attach <id>`
- A session can start, message, wait on and end other sessions: MCP tools `awsh_spawn`, `awsh_send`, `awsh_wait`, `awsh_end` (`python -m adk.harnesses.mcp_stdio`)
- Scoped memory recalled at session start: `awm recall --claude-hook`
- A queue and a clock: `awrun submit`, `awrise add`
- File leases between agents: `awgit lease acquire <path>`
- Scoped, signed permits: `awpermit mint`, `awpermit verify`
- The platform MCP gateway after one sign-in: `adk login`, `adk connect`
- Which composed bricks this machine has, and what is missing: `adk harness parts` (installs nothing)

## CLI

`adk` has 95 top-level commands. The full reference is generated from the
parser itself, so it never describes a command that does not exist:
docs/CLI-REFERENCE.md in the repo.

A few worth knowing:

```
adk quickstart                 # inference + auth + shell, one command
adk gobbonet                   # serve the GobboNet chat UI locally (any OS)
adk gobbonet --setup-model     # ...and fetch llama.cpp + a model that fits
adk run                        # start the agent server
adk chat                       # talk to your agent
adk packs                      # list installed agent packs
adk doctor                     # diagnose a broken install
```

## Links

- PyPI: https://pypi.org/project/awdk/
- GitHub: https://github.com/Aitherium/aither
- Full docs: https://demo.aitherium.com/llms-full.txt
- MCP tools: https://demo.aitherium.com/llms.txt
