miu-mono

AI Agent Framework Monorepo - Build and run AI coding agents with multiple LLM providers.

Installation

Quick Install (Recommended)

Unix/macOS:

curl -LsSf https://raw.githubusercontent.com/vanducng/miu-mono/main/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/vanducng/miu-mono/main/scripts/install.ps1 | iex

Using uv

# Install as a tool (recommended)
uv tool install miu-code

# Or run directly without installing
uvx miu-code "read README.md"

Using pip

# CLI agent
pip install miu-code

# Full installation with all extras
pip install "miu-mono[all]"

Quick Start

# One-shot query
miu -q "explain this codebase"

# Interactive REPL mode
miu

# Interactive TUI mode
miu code

# With specific provider
miu --model anthropic:claude-opus-4-20250805 -q "summarize README.md"

Packages

Package	PyPI	Description
miu-core	pip install miu-core	Core framework library
miu-code	pip install miu-code	AI coding agent with CLI/TUI
miu-examples	pip install miu-examples	Example applications
miu-studio	pip install miu-studio	Web server and UI
miu-mono	pip install miu-mono	Meta-package (all-in-one)

Extras

# Provider-specific
pip install "miu-core[anthropic]"
pip install "miu-core[google]"
pip install "miu-core[openai]"
pip install "miu-core[zai]"

# All providers
pip install "miu-core[all]"

# Full bundle with web UI
pip install "miu-mono[all]"

Features

• Multi-Provider Support: Anthropic Claude, Google Gemini, OpenAI GPT, Z.AI
• ReAct Agent: Reasoning and acting loop with tool execution
• Rich Tool System: File operations, code execution, web search
• Multiple Interfaces: CLI, TUI (Textual), Web UI (FastAPI)
• OpenTelemetry Tracing: Built-in observability
• MCP Integration: Model Context Protocol support
• Extensible Hooks: Customize agent behavior

Configuration

Set your API keys:

# Anthropic (default)
export ANTHROPIC_API_KEY="sk-ant-..."

# Google
export GOOGLE_API_KEY="..."

# OpenAI
export OPENAI_API_KEY="sk-..."

# Z.AI
export ZAI_API_KEY="..."

Development

# Clone repository
git clone https://github.com/vanducng/miu-mono.git
cd miu-mono

# Install dependencies
uv sync

# Run tests
uv run pytest

# Lint and type check
uv run ruff check .
uv run mypy packages/

See CONTRIBUTING.md for detailed guidelines.

Documentation

• Getting Started
• API Reference
• Examples

License

MIT