给 AI 装上代码地图，让智能体秒懂整个项目
potpie 是一个面向 AI 原生软件开发生命周期的上下文图谱平台。它通过构建代码库的语义图谱，为 AI 智能体提供精准的代码上下文，解决大模型在理解大型代码库时上下文不足、检索不准的问题。核心能力包括：自动解析代码依赖关系、生成模块级知识图谱、提供图谱查询 API 和 MCP 服务，让 AI 编程助手能基于全局视角进行代码生成、重构和问题定位。项目采用 Python 实现，支持主流代码托管平台，可无缝集成到现有开发工作流中，显著提升 AI 辅助开发的准确性和效率。
1安装 potpie CLI
README 推荐用 uv 安装 CLI，可避免全局修改 Python 包环境
uv tool install potpie2pip 方式安装
没有 uv 时可改用 pip，加 --user 安装到用户目录，与上面二选一
python3 -m pip install --user potpie3运行配置向导
向导会生成本地配置、存储、守护进程、默认 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 社区，可查阅文档或在社区提问。
Sourcegraph、CodeQL、Aider
potpie 是智能体领域的开源项目，由 potpie-ai 开发，2024 年首次发布。
在全站 13,109 个收录项目中，它的 GitHub 星标数（5,733）位列前 8%，在智能体分类的 2,520 个项目里位列前 9%。
近 41 天，它的 GitHub 星标从 5,571 增加到 5,733，净增 162。
项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。
它主要面向的使用场景是：大型代码库的AI辅助开发，让智能体快速理解项目结构。同类可对比的替代方案包括 Sourcegraph、CodeQL、Aider。
下一篇：jido_ai
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望，让交互更真实
独立、可自托管的 AI 动态心智状态引擎：驱动力、念头池、疲惫、睡眠与意图。
deepseek-harness
开源
把 AI 能力拆成乐高积木，拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
AutoGPT
开源
开箱即用的 AI 员工，交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
EvoAgentX
开源
让 AI 智能体自己迭代变强，越用越聪明
EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents