项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5795
使用教程
ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。
环境要求
- Python 环境（使用 pip 方式安装时需要）
- uv 工具（README 推荐的 CLI 安装方式）
- 可访问 PyPI 的网络环境
安装与启动步骤
-
1安装 potpie CLI
README 推荐用 uv 安装 CLI，可避免全局修改 Python 包环境
uv tool install potpie -
2pip 方式安装
没有 uv 时可改用 pip，加 --user 安装到用户目录，与上面二选一
python3 -m pip install --user potpie -
3运行配置向导
向导会生成本地配置、存储、守护进程、默认 pot 与 agent 技能，并可选择集成和编码工具
potpie setup
如何确认成功
执行 potpie setup 向导过程中无报错，且向导完成后本地配置、存储与守护进程均已就绪，即表示初始化成功。
常见问题
Q：uv 和 pip 两种安装方式该选哪个？
A：README 推荐 uv tool install potpie，因为不建议全局修改 Python 包；没有 uv 时再用 python3 -m pip install --user potpie。
Q：potpie setup 会做什么？
A：向导会配置本地 config、存储、守护进程、一个默认 pot 和 agent skills，并让你选择需要的集成以及要配置的 coding harness。
Q：安装后还要手动建配置文件吗？
A：不需要。README 说明本地配置由 potpie setup 向导自动生成，直接运行向导即可。
Q：遇到问题去哪里查？
A：README 提供了官方文档 docs.potpie.ai 与 Discord 社区，可查阅文档或在社区提问。
注意事项
- 优先使用 uv tool install potpie，README 明确建议不要全局改动 Python 包。
- 安装与配置均通过命令行完成，向导内的集成与 coding harness 选项按自身开发环境选择。
- 更多安装细节和进阶用法请参考官方文档 https://docs.potpie.ai。
核心亮点
- 自动构建代码知识图谱，替代传统的 RAG 检索，提供更精准的上下文
- 提供 MCP 协议支持，可直接接入 Claude、Cursor 等主流 AI 编程工具
- 支持多语言代码解析，并可视化展示模块依赖关系，便于团队协作
不足之处
- 项目仍处于早期阶段，API 稳定性可能随版本迭代变化
- 文档和社区生态尚待完善，上手学习成本较高
适用场景
- 大型代码库的 AI 辅助开发，让智能体快速理解项目结构
- 代码重构和依赖分析，通过图谱识别模块间耦合关系
- 自动化代码审查和缺陷定位，基于语义上下文精准发现问题
替代项目
Sourcegraph、CodeQL、Aider
下一篇：jido_ai
同类项目推荐
google-analytics-mcp
开源
把 GA4 数据直接喂给 AI 智能体，省去数据清洗，快速做分析。
Google Analytics 4 data to AI agents, agentic workflows, and MCP clients. Give agent···
luvus
开源
一个终端统管多个AI编码智能体，并行干活不打架
Mission control for your AI agents
crucible
开源
让AI多角度辩论，产出严谨研究报告，告别单次提示的片面。
AI-native multi-agent research workflow: parallel evidence gathering, 7-direction de···
OpenRoom
开源
用聊天控制整个桌面，AI 帮你操作所有应用
A browser-based desktop where AI Agent operates every app through natural language.
layrr
开源
在浏览器里点选元素，直接指挥 Claude Code 改代码
A browser coding agent interface for selecting elements and sending instructions dir···
latex-arxiv-SKILL
开源
让 AI 帮你写 arXiv 级论文，引用真实不注水
A highly customizable agentic harness for arXiv-ready ML/AI review papers (and beyon···
VetarAI
开源
本地跑多Agent协作，数据不出门，RAG省缓存
VetarAI 是一款全原生 Swift 的本地桌面应用：多 Agent 协作、可视化工作流、拉模式知识仓···
sub-agents-mcp
开源
用 Markdown 定义子代理，让 AI 在任意 MCP 工具中按需分工。
Define task-specific AI sub-agents in Markdown for any MCP-compatible tool.
MakoCode
开源
像玩 Galgame 一样，零门槛体验 AI Agent 的乐趣
MakoCode — 茉子版 Agent | Galgame 风格桌面 AI Agent，零门槛体验 Agent 的乐趣