Huiyu Pi 一个本地开源的 Agent 工具,上下文减少到接近于 0，速度大幅提升

AI 编程助手，极简到极致。
~80 tokens 系统提示 · ~0.3s 首字响应 · 4 个基础工具 · 100% 本地部署

Huiyu Pi webUI，一个本地开源的 Agent 工具，让你从零搭建自己的 Harness 系统。 基于 Pi 和 pi-forge 构建，相比传统 IDE 工具，上下文减少到接近于 0，速度大幅提升。 不受平台限制，从零搭建更干净。

AI 编程助手，极简到极致。
~80 tokens 系统提示 · ~0.3s 首字响应 · 4 个基础工具 · 100% 本地部署

Huiyu Pi webUI，一个本地开源的 Agent 工具，让你从零搭建自己的 Harness 系统。 基于 Pi 和 pi-forge 构建，相比传统 IDE 工具，上下文减少到接近于 0，速度大幅提升。 不受平台限制，从零搭建更干净。

为什么是 ~80 tokens？

传统 AI 编程工具每次请求携带 15,000–28,000 tokens 的系统提示 — 规则、工具定义、角色提示、输出格式……AI 大部分注意力花在阅读说明书上，而不是解决你的问题。

Huiyu Pi 走相反的路线：去掉一切非必要的东西。4 个基础工具。干净的工作台。没有包袱。

为什么选择 Huiyu Pi？

基于 pi 和 pi-forge 打造，弥补它们缺少前台 WebUI 和交互细节体验不足的问题。Huiyu Pi 是 Pi 编码代理的浏览器端 WebUI 前端 — 用起来快得飞起，非常顺手，所以分享给大家。

快速开始

npx huiyu-pi

在浏览器中打开http://localhost:9144，进入设置 → 提供商配置 API 密钥即可使用。

也支持全局 npm 安装、手动克隆、一键脚本 — 详见下方的 安装方式。

功能特性

🔐 自托管 & 隐私安全

你的代码、API 密钥和对话历史都保存在本地机器上。无需云端，无第三方，无数据泄露。

🧠 多 LLM 支持

支持 Anthropic Claude、OpenAI GPT/o1/o3、DeepSeek、Google Gemini、Mistral、Groq、xAI、OpenRouter 等 30+ 提供商，包括本地模型。

📁 完整文件管理

内置文件浏览器和 CodeMirror 编辑器，支持 10+ 种编程语言。直接在浏览器中创建、编辑、搜索文件。

🖥️ 集成终端

通过 xterm.js + WebSocket 实现完整终端模拟器。多标签页、断线重连、可调整布局。

🔀 Git 集成

查看差异、按 hunk 级别暂存更改、通过 git-graph 浏览提交历史 — 全部在浏览器中完成。

🔌 MCP 协议支持

连接外部 MCP 服务器并将其工具暴露给你的编程 Agent。支持全局和项目级别配置。

📱 移动端友好 + PWA

响应式设计，支持 iOS/Android。可安装为 PWA，获得原生应用体验。

🎨 完全可定制主题

通过 CSS 变量控制深色和浅色主题。无需重新构建即可创建自己的皮肤。

安装方式

前置要求：Node.js ≥ 20（下载）。如需终端功能需安装构建工具：Visual Studio Build Tools（Windows）、xcode-select --install（macOS）或build-essential（Linux）。聊天和文件浏览无需构建工具也可正常使用。

一键启动（无需安装）

npx huiyu-pi

全局安装（后续启动更快）

npm install -g huiyu-pi huiyu-pi # 通过参数覆盖默认配置： huiyu-pi --port 4000 --workspace-path ~/Code huiyu-pi --api-key @/run/secrets/api-key --no-expose-docs huiyu-pi --help # 查看全部参数

默认监听http://localhost:9144，从~/.pi/agent/读取提供商配置（如果安装了 pi CLI 则共享配置），状态数据存储在~/.huiyu-pi/。

手动启动（开发模式）

git clone https://github.com/huiyu9144/Huiyu-Pi.git cd Huiyu-Pi npm install npm run dev

平台一键脚本

克隆仓库，运行start.bat（Windows）或bash start.sh（macOS/Linux）。

局域网访问

start-lan.bat # Windows bash start-lan.sh # macOS / Linux

或通过环境变量 / CLI 参数：

HOST=0.0.0.0 huiyu-pi # npm 全局安装 huiyu-pi --host 0.0.0.0 # CLI 参数

安全提醒：绑定0.0.0.0会将 Agent 的终端和文件系统暴露给网络上的所有人，请仅在可信的私有网络中启用。

Docker 部署（推荐生产环境使用）

从镜像仓库拉取（无需克隆）：

docker run -d \ --name huiyu-pi \ -p 9144:9144 \ -v ~/.pi/agent:/home/pi/.pi/agent \ -v ~/.huiyu-pi:/home/pi/.huiyu-pi \ -v $(pwd)/workspace:/workspace \ ghcr.io/huiyu9144/huiyu-pi:latest

或本地构建（适合自定义）：

git clone https://github.com/huiyu9144/Huiyu-Pi.git cd Huiyu-Pi/docker cp .env.example .env docker compose up -d --build

打开http://localhost:9144即可使用。

自定义 UID/GID（解决挂载目录权限问题）：

docker compose build --build-arg PUID=$(id -u) --build-arg PGID=$(id -g) docker compose up -d

详细配置请查看 docker/README.md。

API 密钥配置

Huiyu Pi 通过设置界面管理提供商 API 密钥，存储在~/.pi/agent/auth.json（如果安装了 pi CLI 则共享配置）。密钥不会暴露给浏览器 — 服务器在内存中持有并通过代理转发所有 LLM 请求。

通过设置界面（推荐）

1. 打开http://localhost:9144
2. 进入设置 → 提供商
3. 选择你的提供商（Anthropic、OpenAI、DeepSeek 等）
4. 粘贴 API 密钥并保存

支持的提供商

Anthropic Claude、OpenAI GPT/o1/o3、DeepSeek、Google Gemini、Mistral、Groq、xAI、OpenRouter，以及任何 OpenAI 兼容端点（vLLM、LiteLLM、Ollama 等）。

自定义 OpenAI 兼容提供商

对于自托管或第三方端点，在~/.pi/agent/models.json中创建配置：

{ "custom-gateway": { "protocol": "openai", "url": "http://localhost:11434/v1", "models": ["qwen2.5-coder-32b"] } }

然后在设置 → 提供商 → custom-gateway中添加 API 密钥。

CLI 参数（适用于脚本 / CI）

huiyu-pi --api-key @/path/to/api-key.txt

@前缀表示从文件读取密钥。适用于 CI 流水线和 Docker secrets。

配置

所有设置可通过 CLI 参数、环境变量或配置文件控制。优先级：CLI 参数 > 环境变量 > 配置文件。

CLI 参数

环境变量

配置文件

自定义主题

主题通过packages/client/src/index.css中的 CSS 自定义属性控制：

:root { --bg-primary: #0a0a0a; --accent: #60A5FA; } html[data-theme="light"] { --bg-primary: #ffffff; --accent: #2563EB; }

技术栈

社区

• 💬 加入 Discord
• ⭐ 在 GitHub 上 Star
• 🌐 访问官网

贡献

欢迎参与贡献！请查看 CONTRIBUTING.md 了解指南。

致谢

本项目基于两个开源项目构建：

• pi-forge 由 Devin Marks 和贡献者们开发
• pi 由 earendil-works 和贡献者们开发

作者

关注作者的 X (Twitter)：@huiyu91444

许可证

MIT — 上游项目的许可证：

• pi-forge
• pi