Tencent/LoopForge
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.
LoopForge — 무엇인가
LoopForge는 AI 코딩 에이전트로 소프트웨어를 출시하는 팀을 위한 자체 호스팅 워크스페이스입니다. 채팅 창에서 원하는 것을 설명하면 시스템이 AI 에이전트, 샌드박스, 승인 단계를 조정하여 요청을 실제 코드 변경(일반적으로 풀 리퀘스트)으로 전환합니다.
세 가지 아이디어를 중심으로 구축되었습니다:
- "메인 봇"과 채팅 — 요청을 입력하면 격리된 Docker 워크스페이스를 열고 리포지토리를 체크아웃하고 전문 AI 역할(플래너, 구현자, 리뷰어, 테스터)에 작업을 위임하고 완료되면 PR을 엽니다.
- SOP(표준 운영 절차) — 효과적인 워크플로우를 찾으면 반복 가능한 고정 단계 시퀀스(AI 에이전트, 스크립트, 인간 승인 게이트)로 저장할 수 있습니다. 이후 모든 요청은 동일한 검사로 동일한 단계를 따릅니다.
- 인간 제어 — 승인 게이트는 담당자가 아티팩트를 검토하고 승인하거나, 작업을 이전 단계로 보내거나, 재시도할 때까지 실행을 일시 중지합니다. 원하지 않으면 서명 없이 아무것도 출시되지 않습니다.
실제 코딩 작업은 기존 AI 코딩 도구(CodeBuddy, Codex 또는 Claude Code)에 의해 수행됩니다. LoopForge는 이를 대체하지 않고 오케스트레이션하여 역할, 샌드박스, 체크포인트, 기록을 추가합니다. 자체 인프라에서 실행되며 MIT 라이선스입니다.
두 가지 작업 방식
| 메인 봇과 채팅 | SOP 실행 | |
|---|---|---|
| 최적 용도 | 탐색, 빠른 수정, 에이전트와 반복 | 고정 단계와 서명이 있는 반복 가능한 전달 |
| 실행 방식 | 메인 봇이 온디맨드로 Docker 샌드박스를 열고 프로젝트 역할을 하위 에이전트로 호출 | 엔진이 에이전트, 스크립트, 인간 게이트, 하위 SOP 노드를 순서대로 실행하며 각각 자체 샌드박스에서 실행 |
| 제어 유지 방법 | 응답 중에 메시지를 큐에 넣거나 유도하고, 실행 중인 SOP를 일시 중지, 재개 또는 인계 | 인간 게이트에서 승인하고, 선택한 단계로 작업을 보내고, 모든 노드에서 재시도 또는 재실행 |
| 전달물 | PR/MR 또는 공유 브랜치로 직접 병합 | 문서, 코드 또는 PR, 노드별 아티팩트 및 로그 |
두 경로 모두 동일한 요구사항을 추적하므로 모든 변경 사항은 요청된 내용에 연결되고 전달 및 비용 보고서에 집계됩니다.
왜 존재하는가
코딩 에이전트에게 "이 버그를 고쳐줘"라고 요청하면 결과는 특정 실행에 따라 달라집니다. 계획을 건너뛰거나, 테스트를 잊거나, 자신의 코드를 검토하거나, 중간에 눈치채지 못한 채 멈출 수 있습니다. LoopForge는 다음으로 해결합니다:
- 재현성 — 모든 요구사항에 대해 동일한 SOP, 동일한 단계, 동일한 검사.
- 분리된 역할 — 계획, 구현, 검토, 테스트는 각각 고유한 프롬프트, 실행기, 모델, 규칙, 도구를 가집니다.
- 인간이 루프에 있음 — 중요한 곳에 승인 게이트를 설정합니다. 보고서를 읽고 승인하거나 작업을 되돌릴 수 있습니다.
- 관찰 가능하고 재개 가능 — 노드 상태, 도구 추적, 로그, 아티팩트를 한곳에 모읍니다. 모든 노드에서 일시 중지, 재시도, 재실행할 수 있습니다.
- 당신의 스택, 당신의 서버 — CodeBuddy, Codex 또는 Claude Code를 실행기로 사용하고, GitHub, Skills, MCP를 도구로 사용하고, Docker 샌드박스 또는 자체 머신을 런타임으로 사용합니다.
빠른 시작
git clone https://github.com/Tencent/LoopForge.git
cd LoopForge
./start.sh
설치 프로그램은 Docker, Compose, Python 3, curl을 확인하고(누락된 구성 요소 설치 제안), 사전 빌드된 릴리스 이미지를 가져오고, MySQL 및 플랫폼 서비스를 만들고, 시크릿을 생성하고, 내장 샌드박스, 시작 SOP, 환영 프로젝트를 설치합니다. 호스트에 Go 또는 Node.js를 설치할 필요가 없습니다. 시작 후 모델 API 키와 GitHub 인증을 구성합니다.
서비스는 기본적으로 0.0.0.0:8090에서 수신합니다. 처음 생성된 계정이 관리자가 됩니다. 새 계정은 데모 프로젝트(API 키가 필요 없는 스크립트 전용 SOP)에 참여하여 즉시 시도할 수 있습니다.
SOP 작동 방식
SOP는 전달이 따르는 워크플로우입니다. 다음 노드 유형으로 구성됩니다:
| 노드 | 기능 |
|---|---|
| 에이전트 | 설계, 구현, 검토 또는 테스트를 수행하는 역할(프롬프트, 실행기, 모델, 규칙, Skills, MCP 도구) |
| 스크립트 | 결정적 셸 단계 — 빌드, 테스트, 린트, 보고서 생성. AI가 필요 없는 곳에는 AI를 사용하지 않음 |
| 인간 게이트 | 누군가 승인하거나 작업을 단계로 되돌릴 때까지 실행을 일시 중지 |
| 하위 SOP | 다른 SOP를 하위 워크플로우로 실행 |
| 미리보기 빌드 | 정적 사이트를 빌드하고 검토용으로 보관 |
각 노드는 아티팩트와 종속성을 선언합니다. 엔진은 각 단계의 종속성이 완료되면 시작합니다. 내장 SOP는 백엔드 전달, 프런트엔드 전달, 제품 제안, 버그 수정을 다룹니다. 이는 읽기 전용 청사진으로, 프로젝트에 복사하여 실행하고 편집할 수 있습니다.
주요 기능
- 채팅 워크벤치 — 대화별 실행기, 모델, 권한 모드.
@참조로 역할, 스킬, 요구사항, SOP, 리포지토리를 참조. 메시지 큐잉 및 유도. 생성된 파일은 사이드 패널에서 열림. - 대화 워크스페이스 — 온디맨드 Docker 샌드박스. 리포지토리가 체크아웃되고 프로젝트 역할이 하위 에이전트로 사용됨. 실행 중인 SOP를 일시 중지, 재개 또는 인계.
- SOP 디자이너 — 모든 노드 유형, 실패 시 재작업 엣지, 검증, 버전 기록, 게시를 갖춘 비주얼 캔버스.
- 역할 — SOP 노드와 채팅 하위 에이전트 간에 공유되는 재사용 가능한 정의.
- 요구사항 → 전달 — PR/MR 상태, 병합 감지, 직접 브랜치 병합을 통한 엔드투엔드 추적.
- 실행 및 승인 — 실시간 노드 상태, 도구 추적, 작업자 로그, 아티팩트 스냅샷, 단일 "검토 필요" 받은 편지함.
- AI 예약 작업 — 버전 관리된 템플릿의 공유 마켓을 갖춘 정기 에이전트 작업.
- 인사이트 및 비용 — 엔지니어링 메트릭, 비즈니스 도메인 보고서, 토큰/비용 회계.
- 실행 환경 — 플랫폼 작업자, Docker 샌드박스 또는 연결된 로컬 머신.
- 팀 준비 — 비밀번호 계정, 프로젝트 및 멤버, 라이트/다크 테마, OpenAPI로 설명된 HTTP 및 MCP API.
LoopForge Local
서버를 실행하고 싶지 않으신가요? LoopForge Local은 내장 전달 워크플로우를 이미 사용 중인 코딩 어시스턴트에 제공합니다:
npx -y loopforge-cli@latest install claude
그런 다음 Claude Code에서 /start-devflow "<요청>"을 실행합니다. 지원되는 호스트에는 Claude Code, CodeBuddy, Codex, Cursor, Pi, DeepSeek Harness, Hermes Agent가 포함됩니다. Node.js 20+ 및 Python 3.8+가 필요합니다.
FAQ 하이라이트
- 시도하는 데 API 키 불필요 — 데모 SOP는 스크립트와 인간 게이트만 사용합니다. 채팅 및 에이전트 단계에는 선택한 실행기의 키가 필요합니다.
- GitHub는 선택 사항 — 채팅, 문서, 새 프로젝트는 작업 워크스페이스에서 실행됩니다. 기존 코드를 변경하거나 PR을 열 때 GitHub를 연결하세요.
- Dify/n8n/Flowise와 다름 — 이들은 범용 AI 워크플로우 빌더입니다. LoopForge는 코딩 에이전트를 통한 소프트웨어 전달에 특화되어 구축되었습니다: 구현자/리뷰어 역할, 실제 리포지토리가 있는 Docker 샌드박스, GitHub 전달, 인간 수용 게이트, 실행 증거.
- Claude Code/Codex/CodeBuddy를 직접 사용하는 것과 다름 — LoopForge는 이를 오케스트레이션합니다. 각 에이전트 단계는 해당 CLI 중 하나를 실행하며, LoopForge는 누가 무엇을, 어떤 샌드박스에서, 어떤 순서로, 어떤 검사로, 누가 서명하는지 추가합니다.
라이선스
MIT. 타사 구성 요소는 자체 라이선스를 유지합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트