Quick Start¶
Get a working TUI agent running in your terminal in under a minute.
Install¶
Install the TUI as an isolated tool with uv:
uv tool install "axio-tui[all]"
Or pick only the extras you need:
# OpenAI transport + local filesystem tools
uv tool install "axio-tui[openai,local]"
# Nebius transport + guards
uv tool install "axio-tui[nebius,guards]"
Available extras: openai, nebius, codex, local, mcp, rag,
guards, all.
Alternative: pip install
pip install "axio-tui[all]"
From source (development)¶
git clone https://github.com/axio-agent/axio.git
cd axio
uv sync
Set your API key¶
Export the API key for your chosen transport:
# OpenAI
export OPENAI_API_KEY="sk-..."
# Nebius AI Studio
export NEBIUS_API_KEY="..."
Launch the TUI¶
axio
The TUI automatically discovers all installed transports, tools, and guards via the plugin system. Select a model, start a conversation, and watch the agent call tools in real time.
Key features¶
Model selection — switch between any discovered transport and model
Session persistence — conversations are stored in SQLite and survive restarts
Tool visibility — every tool call is shown with its input and output
Permission guards — guards prompt for approval before executing sensitive operations
Sub-agents — spawn child agents for parallel tasks
Web mode¶
Serve the TUI over HTTP for remote access:
axio --serve
Opens on localhost:8086 by default. Access it from any browser.
What’s next?¶
Write a minimal agent from scratch with the core library.
Understand protocols, tools, events, and the plugin system.