Skip to content

README.md

Latest commit

 

History

History
151 lines (113 loc) · 5.94 KB

README.md

File metadata and controls

151 lines (113 loc) · 5.94 KB

μAgent — Python 的 π

🚧 积极开发中 — 核心功能已就绪，扩展系统、技能系统等正在建设。

一个受 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/ -v

39 个测试覆盖：Agent 循环、事件系统、工具执行、会话管理、Provider 适配。

受 pi 启发

μAgent 的设计深受 pi coding agent 的影响，由 Mario Zechner (@badlogic) 创建。

当前处于忠实复刻阶段，未来将利用 Python / LangChain 生态走出自己的路。

License

MIT