Packages

Overview of MIU packages and their purposes

Packages

MIU is organized as a monorepo with five independently versioned packages.

Package Structure

miu-mono (Monorepo)
├── packages/miu_core/       → miu-core (core framework)
├── packages/miu_code/       → miu-code (CLI agent)
├── packages/miu_examples/   → miu-examples (examples)
├── packages/miu_studio/     → miu-studio (web UI)
└── packages/miu_mono/       → miu-mono (meta-package)

Core Packages

miu-core

Core Framework Library

The foundation providing agent abstractions, tool registry, LLM provider interfaces, and data models.

pip install miu-core

miu-code

AI Coding Agent

CLI/TUI interface with coding-specific tools (read, write, edit, bash, glob, grep).

pip install miu-code

miu-studio

Web Server & UI

FastAPI-based web server with REST API and browser interface.

pip install miu-studio

miu-examples

Example Applications

Usage patterns and example implementations.

pip install miu-examples

Meta Package

miu-mono is a convenience package that installs everything:

pip install "miu-mono[all]"

Provider Extras

Install only the LLM providers you need:

Anthropic

pip install "miu-core[anthropic]"

Includes the Anthropic SDK for Claude models.

Google

pip install "miu-core[google]"

Includes the Google Generative AI SDK for Gemini models.

OpenAI

pip install "miu-core[openai]"

Includes the OpenAI SDK for GPT models.

All Providers

pip install "miu-core[all]"

Includes all provider SDKs.

Dependencies

miu-core Dependencies

Package	Purpose
pydantic	Data validation and settings
httpx	Async HTTP client
aiofiles	Async file operations
packaging	Version parsing

miu-code Dependencies

Package	Purpose
miu-core	Core framework
textual	TUI framework
rich	Terminal formatting

miu-studio Dependencies

Package	Purpose
miu-core	Core framework
fastapi	Web framework
uvicorn	ASGI server

Version Management

Each package is independently versioned using Release-Please with Conventional Commits.

# Feature - MINOR bump (0.1.0 → 0.2.0)
git commit -m "feat(agent): add streaming support"

# Bug fix - PATCH bump (0.1.0 → 0.1.1)
git commit -m "fix(tools): resolve validation bug"