Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.

★ 2,045⑂ 323👁 9⑃ 210● 66▤ 13
GoNOASSERTIONCreated 2026-07-28loopforge.cn
下载:LoopForge v0.3.8LoopForge-0.3.8 ↓0.3.82026-11-12
+986
日增长
2,045
stars
323
forks
9
watchers
210
prs
66
issues
13
releases

README

English · 简体中文



  两种工作方式 ·
  快速开始 ·
  SOP ·
  功能 ·
  本地版 ·
  FAQ ·
  文档


https://github.com/user-attachments/assets/10b8ae2e-d7e7-4b78-8876-c45818d4a08f

80 秒产品演示(1080p,有声)。

LoopForge 是一个可自主部署的团队工作台,让你和编程 Agent 一起交付软件。在对话里把需求告诉 Main Bot:它会按需打开 Docker 沙箱、检出项目仓库、把任务分派给项目角色,最后提交 PR。某种做法被验证有效后,把它存成 SOP(由 Agent、脚本和人工关口组成的标准交付流程),下一个需求就按同样的方式交付,评审和验收都在流程里。

干活的是编程 Agent CLI:CodeBuddy、Codex、Claude Code、OpenCode、Cursor CLI、Antigravity、Kimi Code、Pi、DeepSeek Harness 和 ZCode;LoopForge 负责它们外面的角色、沙箱、检查点和留痕,全部运行在你自己的环境里,MIT 开源。

 两种工作方式

| | 与 Main Bot 对话 | 运行 SOP |
| --- | --- | --- |
| 适合 | 探索、快速修复、与 Agent 反复迭代 | 阶段固定、需要签字确认的可重复交付 |
| 如何运行 | Main Bot 按需打开对话工作区(带项目仓库的 Docker 沙箱),并把项目角色作为子 Agent 调用 | 引擎按顺序执行 Agent、脚本、人工关口和子 SOP 节点,每次运行有独立沙箱 |
| 你如何把控 | 回复中途排队或「引导」消息;在对话里暂停、恢复或接管正在运行的 SOP | 在人工关口审批;打回到指定环节返工;从任意节点重试或重跑 |
| 交付物 | PR/MR,或直推合入共享分支(mode=direct) | 文档、代码或 PR,以及每个节点的产物和日志 |

两种方式都挂在同一套需求上:无论改动来自对话还是 SOP,都能追溯到原始需求,并计入交付与成本统计。


  
    
    
  


对话首页:描述需求,用 @ 引用角色、技能、需求、SOP 或仓库;每个会话可单独选择执行器、模型和确认模式。

 为什么需要 LoopForge

让编程 Agent "修一下这个 Bug",结果往往取决于这一次的运行:可能跳过方案,可能忘了跑测试,可能自己评审自己的代码,也可能做到一半停下而没人发现。做演示没问题,但团队交付不能这样。

- 可重复。 同一条 SOP、同样的阶段、同样的检查,每个需求都一样。内置后端、前端、缺陷修复、产品方案四类 SOP 可直接起步。
- 角色分离。 方案、实现、评审、测试各有独立的角色提示词、执行器、模型、规则、Skills 和 MCP 工具;同一个角色既能做 SOP 节点,也能在对话中作为子 Agent 调用。
- 人在回路。 在关键节点设置人工审批:看完报告再放行,或打回到指定环节返工。
- 可观测、可续跑。 节点状态、工具轨迹、日志和产物集中呈现;支持暂停、重试失败步骤、从任意节点重跑。
- 技术栈和服务器都是你的。 执行器支持 10 种编程 Agent CLI,从 CodeBuddy、Codex、Claude Code 到 OpenCode、Cursor CLI 等;工具接入 GitHub、Skills、MCP;运行环境可选 Docker 沙箱或你自己的机器。

 快速开始

先准备 Git 并克隆仓库。安装脚本会检查 Docker、Compose、Python 3 和 curl,并在获得确认后补装缺少的组件:Linux 的 Python/curl 支持 apt、dnf、yum,Compose 插件支持 x86_64/arm64 并校验官方发行文件的 SHA-256;macOS 需要可运行的 Python 3 和 Docker Desktop,可通过 Homebrew 补装缺少的组件。支持普通用户运行,需要时通过 Docker 组或 sudo 操作 Docker。设置 LOOPFORGE_YES=1 可接受安装提示;安装和拉取镜像需要可用的外网连接。

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


./start.sh 直接拉取 compose.yaml 中 pin 的 GHCR 发布镜像,不在本地构建(bash scripts/install.sh 效果相同)。安装流程会创建 MySQL 和平台服务,生成配置与会话密钥,并导入内置沙箱、通用 SOP 和体验项目;无需在宿主机安装 Go 或 Node.js。模型 API Key 和 GitHub 授权在启动后由用户配置。用 ./start.sh logs、stop、restart、pull 管理服务;需要从源码构建时用 ./start.sh dev。

国内拉取 ghcr.io 经常中断。把 MIRROR 设成可以替换 ghcr.io 的镜像站主机名,./start.sh 会用它拉取,再改回 compose.yaml 里的原名。设置 MIRROR 表示信任该主机,因为下载结果会被标成官方镜像名。发布说明里有 digest,可用 docker image inspect --format '{{index .RepoDigests 0}}' ghcr.io/tencent/loopforge: 核对,@ 后面的摘要应一致。不设置时仍直接从 ghcr.io 拉取。compose.yaml 不用改。升级时带上同一个变量执行 ./start.sh pull。南京大学的 GHCR 镜像站是 ghcr.nju.edu.cn。Docker 引擎里的 registry-mirrors(包括 https://docker.nju.edu.cn)只加速 Docker Hub,不能填在这里。

bash
MIRROR=ghcr.nju.edu.cn ./start.sh


打开安装脚本输出的地址创建账号,第一个账号自动成为管理员。服务默认监听 0.0.0.0:8090;在云主机上,安装脚本会从云厂商的元数据服务读取公网 IP 并直接打印出来,放通安全组端口即可访问,或配置 HTTPS 反向代理;管理员账号创建前,建议只允许你的 IP 访问。首页的「快速接入」会带你配置模型凭据、绑定仓库并选好默认 SOP。

GitLab、Gitea、Gogs 等托管可配置 Git SSH,用个人密钥检出和推送分支。Issue 与 PR/MR 自动化需要托管平台的 API Token 或另行配置的 MCP。CNB 官方仅支持 HTTPS + 访问令牌。

 免 API Key 体验

新注册的账号会自动加入 LoopForge 体验项目,其中有一条只包含脚本和人工审批的 SOP:

1. 切换到体验项目,打开 流程模板,进入 平台验收 ·

Top issues

Discussions

Latest release

LoopForge v0.3.8 v0.3.8 2026-11-12
Install

bash
git clone --branch v0.3.8 https://github.com/Tencent/LoopForge.git
cd LoopForge
./start.sh


Platform image: ghcr.io/tencent/loopforge:0.3.8 (pinned in compose.yaml).

Digest: ghcr.io/tencent/loopforge@sha256:481ecb6334a21308acb93f164f5dc74f508109d3e108089981a7ea87de095963.

Where ghcr.io is slow, set MIRROR to a registry host that replaces it (for example MIRROR=ghcr.nju.edu.cn ./start.sh). This trusts that host: the download is tagged as the pinned name. Check it with docker image inspect --format '{{index .RepoDigests 0}}' ghcr.io/tencent/loopforge:0.3.8 and compare the digest

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON