pi2py

pi2py 是一个参考 pi-agent TypeScript 源码实现的 Python 终端 Coding Agent 骨架。

• agent core：负责消息状态、工具调用循环和会话保存
• LiteLLM：统一接入 OpenAI、Anthropic、Gemini、OpenRouter 等模型
• Typer：提供命令行入口和参数解析
• prompt-toolkit：提供交互式终端输入体验
• uv：管理依赖、虚拟环境和项目脚本
• 内置工具：read、write、edit、bash、grep、find、ls

快速开始

uv sync
uv run pi2py -h
uv run pi2py -p "你好"
uv run pi2py

根据 LiteLLM 所选模型配置对应的 API Key，例如：

export OPENAI_API_KEY=...
uv run pi2py --model gpt-4o-mini -p "List files in this project"

使用示例

交互模式：

uv run pi2py --model gpt-4o-mini

单次文本输出：

uv run pi2py -p "Summarize README.md"

查看内置工具：

uv run pi2py tools

架构说明

项目采用轻量分层结构：

• src/pi2py/cli.py：Typer CLI 入口，负责 print/json/interactive 三种运行方式
• src/pi2py/core/agent.py：Agent 主循环，负责向模型发送消息、执行工具调用、继续下一轮
• src/pi2py/core/litellm_client.py：LiteLLM 适配层，隔离具体模型供应商
• src/pi2py/core/tools.py：内置文件、搜索和命令执行工具
• src/pi2py/core/session.py：会话序列化与保存
• tests/：使用 Fake LLM 验证工具调用循环，不依赖真实网络