基于 Pi 0.83.0 开源 · MIT

Pi Agent Integrated

Pi 后端与 Pi Web 前端整合成一个可独立克隆、配置和启动的本地 AI 编程 Agent 平台。

# 克隆并启动
git clone https://github.com/luckyyzh/pi-agent-integrated
cd pi-agent-integrated
npm run setup
npm run dev
# → http://127.0.0.1:30141

核心能力

不是桌面安装包,也不是公网多用户服务 —— 一个隔离、可扩展的本地 Web Agent。

🌐

Web UI 浏览器界面

基于 Pi Web 的 Next.js 前端,支持会话管理、Token 统计、缓存命中率可视化、模型/插件/扩展/MCP 面板。

🔌

插件与工具生态

固定版本管理 pi-mcp-adapter、pi-lens、pi-memory、pi-subagents、pi-rewind、pi-retry、Context7 等核心插件。

🔍

代码智能诊断

内置 LSP、AST 搜索、符号检索、项目诊断(pi-lens),支持 Tree-sitter 结构分析、ast-grep 安全规则、复杂度高亮。

🧠

长期记忆

Markdown 持久记忆(MEMORY.md)、每日日志、Scratchpad 临时工作区、恢复记录,支持 qmd 语义搜索(可选)。

👥

多代理协作

pi-subagents 自动判断任务复杂度,支持链式、并行、异步、独立工作树等多种子代理编排模式。

🔄

代码回滚检查点

pi-rewind 每轮自动创建代码检查点,支持 /rewind 恢复代码、会话或两者,孤儿检查点自动清理。

🌍

网络搜索

可选接入自有 SearXNG 实例,Agent 对时效性问题自动调用 web_search;内置 pi-smart-fetch 浏览器级网页抓取。

🖼️

视觉识图

纯文本模型(如 DeepSeek)也可通过 vision 扩展识图。支持 Ollama 本地和 OpenAI 兼容视觉 API,图片上传即用。

📡

浏览器自动化

Playwright MCP 支持真实网页导航、点击、表单填写、快照和截图。Windows 默认使用系统 Edge。

📚

文档查询

Context7 集成,按需查询任意库/框架/SDK 的实时文档和代码示例,保持 API 信息始终最新。

🛡️

隔离安全

所有运行数据(会话/记忆/凭据/缓存)隔离在项目 data/ 目录,不进入 Git,避免与其他 Agent 项目耦合。

💾

多设备同步

独立的 memory 仓库跨机器同步个人配置和记忆,支持新电脑一键 bootstrap 还原完整环境。

与上游项目的差异

Pi Agent Integrated 在保留源码边界的同时,补齐了开箱即用的完整体验。

能力PiPi WebPi Agent Integrated
定位CLI/TUI Agent 运行时浏览器 UI完整本地 Agent 应用
安装安装 CLI 或构建源码单独连接 Pi 包一次 npm run setup
运行数据用户主目录跟随 Pi Profile项目 data/ 目录
扩展生态支持 Skill/扩展/包管理界面固定版本插件闭环
网络搜索SearXNG web_search
浏览器自动化需自行接入Windows Edge / macOS 可选
恢复与记忆会话树会话 UIRewind 检查点 + 项目记忆
多代理可扩展展示工具调用自动复杂度判断策略

内置插件

版本固定的受管插件体系,安装即用,无需手动挑选。

pi-mcp-adapter

紧凑 MCP 代理,统一搜索和调用

@playwright/mcp

真实网页导航、截图、表单操作

pi-lens

LSP、AST、符号检索、项目诊断

pi-memory

Markdown 长期记忆与日志

pi-subagents

多代理链式/并行/异步编排

pi-smart-fetch

浏览器级 URL 内容抓取

pi-rewind

代码回滚检查点管理

context7-pi

实时库文档与代码示例查询

pi-retry

瞬态错误识别与自动重试

vision.ts

视觉识图(本地 Ollama / 云端 API)

searxng-search.ts

用户自有 SearXNG 网络搜索

项目结构

清晰的源码与数据边界,便于维护和 Git 管理。

pi/Pi 后端、Agent、CLI/TUI 源码
pi-web/Next.js Web 前端与 HTTP/SSE 服务
config/可提交的缺省设置、MCP 配置
resources/应用级 Skill、扩展、提示词、主题
scripts/安装、启动、迁移与验证脚本
data/agent/会话、认证、模型、插件、记忆
data/home/Pi 子进程主目录与 Rewind
data/cache/项目内 npm 缓存
data/workspaces/默认工作目录

快速开始

支持 Windows 10/11 与 macOS,只需 Node.js 22+、npm 和 Git。

1️⃣

克隆仓库

git clone https://github.com/luckyyzh/pi-agent-integrated
cd pi-agent-integrated
2️⃣

初始化

npm run setup
3️⃣

启动

npm run dev

打开 http://127.0.0.1:30141