🚧 积极开发中 — 核心功能已就绪，扩展系统、技能系统等正在建设。
一个受 pi coding agent 启发的 Python 编码智能体框架。
π（Pi）是 TypeScript 世界的编码常数。 μ（Mu / 缪子）是穿透 Python 生态的基本粒子。
最小核心，极度可扩展。
| 模块 | 状态 |
|---|---|
| Agent 循环（流式 + 工具调用） | ✅ 完成 |
| 内置工具（read / bash / write / edit） | ✅ 完成 |
| 事件系统（EventBus + Subscriber） | ✅ 完成 |
| 交互式 CLI（/model / /help / /exit） | ✅ 完成 |
| Provider 抽象（Anthropic / OpenAI / 兼容接口） | ✅ 完成 |
| 会话管理（JsonL 持久化 + 内存） | ✅ 完成 |
| 配置管理（三级合并 + 项目配置） | ✅ 完成 |
| 测试（39 个，覆盖核心链路） | ✅ 完成 |
| 扩展系统（Extension 发现/加载） | ⏳ 计划中 |
| 技能系统（Agent Skills 标准） | ⏳ 计划中 |
| grep / find / ls 工具 | ⏳ 计划中 |
μAgent 继承 pi 的核心设计哲学：
核心只做最基础的事，一切额外功能通过扩展和技能插拔。
- 核心提供：Agent 循环、工具调用、消息管理、会话持久化
- 工具系统：内置
read/write/edit/bash，支持自定义工具注册 - 扩展系统：事件驱动的插件架构（开发中）
- 技能系统：遵循 Agent Skills 标准（开发中）
- Provider 抽象：Anthropic / OpenAI 及任意 OpenAI 兼容服务
想深入了解？阅读 设计哲学。
# 克隆
git clone https://github.com/Aleeyoo/mu-agent.git
cd mu-agent
# 安装（推荐虚拟环境）
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
# 设置 API key（二选一）
export OPENAI_API_KEY="sk-..."
# export ANTHROPIC_API_KEY="sk-..."
# 打印模式
mu -p "1+1等于几"
# 交互模式
mu
# 使用 DeepSeek 等兼容服务
mu -p "你好" --provider openai --model deepseek-chat --api-base https://api.deepseek.com/v1┌──────────────────────────────────────────────────┐
│ μAgent │
├──────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌──────────────────────┐ │
│ │ CLI │ │ Python SDK │ │
│ │ (prompt_ │ │ (create_mu_session())│ │
│ │ toolkit) │ │ │ │
│ └──────┬──────┘ └─────────┬────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌────────────────────────────────────┐ │
│ │ AgentSession │ │
│ │ ┌──────────────────────────────┐ │ │
│ │ │ Agent Loop │ │ │
│ │ │ ┌─────┐ ┌──────┐ ┌────┐ │ │ │
│ │ │ │ LLM │─▶│Tools │─▶│Feed│──┼──┼──▶ Response │
│ │ │ └─────┘ └──────┘ └────┘ │ │ │
│ │ └──────────────────────────────┘ │ │
│ └────────────────────────────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌────────────┐ ┌──────────────┐ │
│ │ Session │ │ Extension │ │ Provider │ │
│ │ Manager │ │ Bus │ │ Abstraction │ │
│ │ (JsonL) │ │ (Events) │ │ (Anthropic/ │ │
│ │ │ │ │ │ OpenAI/ │ │
│ │ │ │ │ │ Compatible) │ │
│ └──────────┘ └────────────┘ └──────────────┘ │
└──────────────────────────────────────────────────────┘
优先级链: CLI 参数 > 项目配置 > 全局配置 > 默认值
~/.mu-agent/config.json ← 全局模型与设置
项目目录/.mu-agent/config.json ← 项目级覆盖（自动发现）
进交互模式后，用 /model 管理模型：
μ ❯ /model add deepseek openai deepseek-chat --api-base https://api.deepseek.com/v1
μ ❯ /model deepseek ← 切换
μ ❯ /model ← 列出所有已配置模型
source .venv/bin/activate
python3 -m pytest tests/ -v39 个测试覆盖：Agent 循环、事件系统、工具执行、会话管理、Provider 适配。
μAgent 的设计深受 pi coding agent 的影响，由 Mario Zechner (@badlogic) 创建。
当前处于忠实复刻阶段，未来将利用 Python / LangChain 生态走出自己的路。
MIT