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 个基础工具。干净的工作台。没有包袱。传统 AI 工具Huiyu Pi系统提示开销15K–28K tokens~80 tokens首字响应时间2–10 秒~0.3 秒每次请求成本$0.02–$0.10降低 90%工具定义数量10–244 个基础工具客户端类型重型桌面 / Electron纯 Web UI数据隐私云端或混合100% 本地为什么选择 Huiyu Pi基于 pi 和 pi-forge 打造弥补它们缺少前台 WebUI 和交互细节体验不足的问题。Huiyu Pi 是 Pi 编码代理的浏览器端 WebUI 前端 — 用起来快得飞起非常顺手所以分享给大家。核心优势详情⚡性能更快默认上下文及 Prompt 从 ~20K 压缩到接近于 0仅保留最基础的几个命令。AI 响应时长大幅缩短。Token 消耗更少去除了绝大多数不常用的上下文使得每次的 Token 消耗都大幅度降低。上下文越少AI 越专注极少上下文让 AI 聚焦核心指令执行更精准。本地部署安全纯粹本地部署API Key 和数据永不离机零泄露风险。️从 0 搭建你的 AI 帝国从 0 搭建自己的 Harness 和 Agent完全自定义完全掌控。️弥补原版不足体验更丝滑弥补 pi 缺少前台 WebUI 以及 pi-forge 交互细节体验不方便等问题。快速开始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 ToolsWindows、xcode-select --installmacOS或build-essentialLinux。聊天和文件浏览无需构建工具也可正常使用。一键启动无需安装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.batWindows或bash start.shmacOS/Linux。局域网访问start-lan.bat # Windows bash start-lan.sh # macOS / Linux或通过环境变量 / CLI 参数HOST0.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 请求。通过设置界面推荐打开http://localhost:9144进入设置 → 提供商选择你的提供商Anthropic、OpenAI、DeepSeek 等粘贴 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 参数适用于脚本 / CIhuiyu-pi --api-key /path/to/api-key.txt前缀表示从文件读取密钥。适用于 CI 流水线和 Docker secrets。配置所有设置可通过 CLI 参数、环境变量或配置文件控制。优先级CLI 参数 环境变量 配置文件。CLI 参数参数说明默认值--port服务器端口9144--host绑定地址127.0.0.1--workspace-path项目根目录~/huiyu-pi-workspace--api-key静态 API 密钥支持file语法—--ui-password浏览器登录密码—--jwt-secretJWT 签名密钥未设置时自动生成—--log-level日志级别fatalerrorwarninfodebugtraceinfo--no-expose-docs隐藏浏览器中的 Swagger UI文档默认暴露--help显示所有参数—环境变量变量说明PORT服务器端口HOST绑定地址0.0.0.0用于局域网WORKSPACE_PATH项目根目录API_KEY静态 API 密钥UI_PASSWORD浏览器登录密码JWT_SECRETJWT 签名密钥LOG_LEVEL日志级别EXPOSE_DOCS设为false隐藏 Swagger UIFORGE_DATA_DIR覆盖状态目录默认~/.huiyu-pi/配置文件文件用途~/.pi/agent/auth.json提供商 API 密钥通过设置界面管理~/.pi/agent/settings.jsonAgent 设置模型、思考级别等~/.pi/agent/models.json自定义 OpenAI 兼容提供商~/.huiyu-pi/mcp.json全局 MCP 服务器配置自定义主题主题通过packages/client/src/index.css中的 CSS 自定义属性控制:root { --bg-primary: #0a0a0a; --accent: #60A5FA; } html[data-themelight] { --bg-primary: #ffffff; --accent: #2563EB; }技术栈层级技术前端React 19, TypeScript 6, Vite 8, Tailwind CSS v4, Zustand, CodeMirror 6后端Fastify 5, WebSocket, SSE, JWT终端xterm.js node-pty基础设施GitHub Actions CI/CD社区 加入 Discord⭐ 在 GitHub 上 Star 访问官网贡献欢迎参与贡献请查看 CONTRIBUTING.md 了解指南。致谢本项目基于两个开源项目构建pi-forge 由 Devin Marks 和贡献者们开发pi 由 earendil-works 和贡献者们开发作者关注作者的 X (Twitter)huiyu91444许可证MIT — 上游项目的许可证pi-forgepi
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 个基础工具。干净的工作台。没有包袱。传统 AI 工具Huiyu Pi系统提示开销15K–28K tokens~80 tokens首字响应时间2–10 秒~0.3 秒每次请求成本$0.02–$0.10降低 90%工具定义数量10–244 个基础工具客户端类型重型桌面 / Electron纯 Web UI数据隐私云端或混合100% 本地为什么选择 Huiyu Pi基于 pi 和 pi-forge 打造弥补它们缺少前台 WebUI 和交互细节体验不足的问题。Huiyu Pi 是 Pi 编码代理的浏览器端 WebUI 前端 — 用起来快得飞起非常顺手所以分享给大家。核心优势详情⚡性能更快默认上下文及 Prompt 从 ~20K 压缩到接近于 0仅保留最基础的几个命令。AI 响应时长大幅缩短。Token 消耗更少去除了绝大多数不常用的上下文使得每次的 Token 消耗都大幅度降低。上下文越少AI 越专注极少上下文让 AI 聚焦核心指令执行更精准。本地部署安全纯粹本地部署API Key 和数据永不离机零泄露风险。️从 0 搭建你的 AI 帝国从 0 搭建自己的 Harness 和 Agent完全自定义完全掌控。️弥补原版不足体验更丝滑弥补 pi 缺少前台 WebUI 以及 pi-forge 交互细节体验不方便等问题。快速开始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 ToolsWindows、xcode-select --installmacOS或build-essentialLinux。聊天和文件浏览无需构建工具也可正常使用。一键启动无需安装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.batWindows或bash start.shmacOS/Linux。局域网访问start-lan.bat # Windows bash start-lan.sh # macOS / Linux或通过环境变量 / CLI 参数HOST0.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 请求。通过设置界面推荐打开http://localhost:9144进入设置 → 提供商选择你的提供商Anthropic、OpenAI、DeepSeek 等粘贴 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 参数适用于脚本 / CIhuiyu-pi --api-key /path/to/api-key.txt前缀表示从文件读取密钥。适用于 CI 流水线和 Docker secrets。配置所有设置可通过 CLI 参数、环境变量或配置文件控制。优先级CLI 参数 环境变量 配置文件。CLI 参数参数说明默认值--port服务器端口9144--host绑定地址127.0.0.1--workspace-path项目根目录~/huiyu-pi-workspace--api-key静态 API 密钥支持file语法—--ui-password浏览器登录密码—--jwt-secretJWT 签名密钥未设置时自动生成—--log-level日志级别fatalerrorwarninfodebugtraceinfo--no-expose-docs隐藏浏览器中的 Swagger UI文档默认暴露--help显示所有参数—环境变量变量说明PORT服务器端口HOST绑定地址0.0.0.0用于局域网WORKSPACE_PATH项目根目录API_KEY静态 API 密钥UI_PASSWORD浏览器登录密码JWT_SECRETJWT 签名密钥LOG_LEVEL日志级别EXPOSE_DOCS设为false隐藏 Swagger UIFORGE_DATA_DIR覆盖状态目录默认~/.huiyu-pi/配置文件文件用途~/.pi/agent/auth.json提供商 API 密钥通过设置界面管理~/.pi/agent/settings.jsonAgent 设置模型、思考级别等~/.pi/agent/models.json自定义 OpenAI 兼容提供商~/.huiyu-pi/mcp.json全局 MCP 服务器配置自定义主题主题通过packages/client/src/index.css中的 CSS 自定义属性控制:root { --bg-primary: #0a0a0a; --accent: #60A5FA; } html[data-themelight] { --bg-primary: #ffffff; --accent: #2563EB; }技术栈层级技术前端React 19, TypeScript 6, Vite 8, Tailwind CSS v4, Zustand, CodeMirror 6后端Fastify 5, WebSocket, SSE, JWT终端xterm.js node-pty基础设施GitHub Actions CI/CD社区 加入 Discord⭐ 在 GitHub 上 Star 访问官网贡献欢迎参与贡献请查看 CONTRIBUTING.md 了解指南。致谢本项目基于两个开源项目构建pi-forge 由 Devin Marks 和贡献者们开发pi 由 earendil-works 和贡献者们开发作者关注作者的 X (Twitter)huiyu91444许可证MIT — 上游项目的许可证pi-forgepi
