Open source · C++23 · Alpha

One agent runtime.
Every interface.

Ava is a headless coding-agent runtime with a streaming TUI, one-shot CLI, and Web UI. Model context, replay, resume, compaction, and recovery all come from the same append-only event stream.

View on GitHub Developer docs

git clone https://github.com/SmartAI/ava.git

ava · verified fix real TUI

3TUI · CLI · Web

4Linkable components

1Session event stream

∞Hosted or local models

Runtime map

The session log is not an afterthought.

It is the source for the next model request, UI replay, resume, compaction, and crash recovery.

Ava architecture: terminal, CLI, and Web interfaces over a headless agent runtime, model and tool layers, and a compressed session stream

01 / SESSION

Compressed frames with a repair boundary

Events are stored in bounded Zstandard frames with decoded-size limits and checksums. A torn final frame is repaired at the last valid boundary.

02 / LIFECYCLE

Cancellation from socket to subprocess

Boost.Asio coroutines connect HTTP/SSE streams, provider adapters, durable writes, timers, and owned child processes.

03 / MODELS

One path for hosted and local models

Anthropic, OpenAI-compatible endpoints, Codex, DeepSeek, and local llama-server runs feed the same normalized agent loop.

CMake components

Link the layer you need.

Ava installs four components. Native tools can consume transport, model streaming, tools, or the full agent without adopting the CLI or frontends.

Ava::transport

Bounded HTTP, TLS, cancellation, and incremental SSE.

ava.transport

Ava::llm

Provider-neutral model streaming and normalized events.

ava.llm

Ava::tool

Checked schemas and bounded coding-tool execution.

ava.tool

Ava::agent

Drive, turn, step, steering, compaction, and recovery.

ava.agent

Same run, different views

Terminal or browser.

Ava terminal user interface showing a runtime architecture response — **Terminal UI**Streaming output, steering, pause, and resume.

Ava Web UI showing the same runtime architecture response — **Web UI**The same session events projected in a local browser.

Build from source

Run Ava where the code lives.

Ava is an alpha release for developers comfortable with CMake, Ninja, Clang, and vcpkg.

Read the getting-started guide

# configure and verify
export VCPKG_ROOT=/path/to/vcpkg
cmake --preset dev
cmake --build --preset dev
ctest --preset dev

# choose an interface
ava
ava -p "explain this repo"
ava --serve

Inspect the runtime.
Then make it yours.

Star Ava on GitHub

One agent runtime.Every interface.