Tencent/LoopForge

项目介绍

LoopForge 是一个自托管的软件交付工作区，围绕编码智能体组织开发流程。在聊天界面里向 Main Bot 描述需求，它会按需拉起 Docker 沙箱、检出仓库、把工作分派给不同的项目角色，最后提交 PR 或直接合并到共享分支。团队验证过的工作方式可以固化成 SOP：由 Agent、Script、Human gate（人工审批）、Sub-SOP 等节点组成的工作流，让后续需求按同样的阶段、检查和签核推进。

它不替代 CodeBuddy、Codex 或 Claude Code，而是编排它们：每个 Agent 节点实际运行的仍是这些 CLI，LoopForge 提供角色定义（提示词、执行器、模型、规则、Skills 和 MCP 工具）、沙箱、检查点、运行历史以及统一的待审批入口。适合希望让智能体参与交付、又要求流程可重复、可追溯的团队。

快速使用

先准备 Git，克隆仓库后执行安装脚本：

git clone https://github.com/Tencent/LoopForge.git
cd LoopForge
./start.sh

./start.sh 会拉取 compose.yaml 中固定的 GHCR 发布镜像，不本地构建；脚本检查 Docker、Compose、Python 3 和 curl，创建 MySQL 与平台服务，生成配置和会话密钥，并安装内置沙箱、初始 SOP 和欢迎项目。设置 LOOPFORGE_YES=1 可跳过安装确认；macOS 需要可用的 Python 3 和 Docker Desktop。

打开安装器输出的地址并创建账号，第一个账号会成为管理员。服务默认监听 0.0.0.0:8090。没有模型密钥时也能试用：切换到演示项目，打开 Platform check · script & approval，点击 Run SOP，再到 Needs review 审批等待中的关卡。真正开展工作时，在个人设置中填入所选执行器的 API Key；需要修改现有仓库或提交 PR 时再绑定 GitHub。

也可以把内置工作流装进已有的编码助手，例如 Claude Code：

npx -y loopforge-cli@latest install claude

随后在 Claude Code 中执行 /start-devflow "<你的需求>"。

使用约束

• 默认 Compose 安装把宿主机 Docker socket 挂载进沙箱，沙箱容器因此能控制宿主守护进程；该模式面向受信任团队，不适合不可信的多租户隔离，需要隔离时可参考单独 worker 的部署方式。
• 新装实例监听所有网卡并按受信任团队设计：登录用户可读取实例内各项目数据，注册默认开放，需在 .env 中设置 AGENTFLOW_ALLOW_SIGNUP=false 关闭。对团队之外开放前应限制访问并配置 HTTPS。
• 模型调用由使用者自带密钥并在外部计费，平台只按公开列表价统计 token 成本。CodeBuddy 和 Codex 已打包进镜像，Claude Code 首次使用时才从 npm 安装并缓存。
• 平台版需要 Docker 和 Python 3；LoopForge Local 需要 Node.js 20+、Python 3.8+ 及受支持的编码助手。Local 目前只运行内置工作流，把平台 SOP 导出到本地独立执行仍在计划中。
• 管理页面为中英双语，聊天工作台目前仅中文。仓库采用 MIT 许可证，第三方组件保留各自声明。

HotRepo 点评

2026-11-11，LoopForge 出现在 GitHub Go 语言日榜第 5 名，当日新增 76 Star，累计 282 Star。这是一次单日的语言榜记录，尚不足以说明持续的全语言热度。支撑这一排名的是成体系的已交付内容：Go 实现的平台、独立的本地 CLI 包、端到端验收测试，以及记录已知缺口的验证文档。对读者而言，最值得关注的是它把人工审批关卡和 Docker 沙箱直接作为编码智能体交付流程的组成部分；而宿主 Docker 访问权限和开放的注册策略，也因此在采用前需要优先核查。

项目源码与说明