agent-tui

Terminal user interface for AI agents built on agent-core.

A Textual-based terminal interface for interacting with AI agents. Built on agent-core and InteropRouter for unified model provider support.

Note

This library is in early development and subject to change.

Usage

Ensure OPENAI_API_KEY is set in your environment.

Run directly from PyPI:

uvx agent-tui

Or if installed locally:

uv run agent-tui

Or run directly with Textual:

uv run textual run src.agent_tui.app:AgentApp

Development

Prerequisites

• uv
• prek

Setup

Create uv virtual environment and install dependencies:

uv sync --frozen --all-groups

Set up git hooks:

prek install

To update dependencies (updates the lock file):

uv sync --all-groups

Run formatting, linting, and type checking:

uv run ruff format && uv run ruff check --fix && uv run ty check