<div align="center">
<img src="https://raw.githubusercontent.com/TokenDanceLab/AgentHub/HEAD/app/desktop/src/assets/agenthub-product-icon-rounded.svg" width="96" alt="AgentHub" />
AgentHub
AI Agent를 팀원처럼 그룹 채팅에 초대하세요. 실제 친구, AI Builder, AI Reviewer와 같은 IM(Instant Messaging) 환경에서 함께 대화하고 협업할 수 있습니다. 메시지는 곧 작업 흐름(task flow)이고, 채팅은 작업대(workbench)입니다.
English · 공식 웹사이트 · 문서 · API
CI
release
go
react
tauri
license
</div>
제품 포지셔닝 (产品定位)
AgentHub를 사용하면 마치 IM 그룹 채팅에서 협업하는 것처럼, 실제 친구(真人好友), Builder, Reviewer, Researcher, Deployer 등 다양한 AI Agent들을 하나의 프로젝트 세션에 배치하고, 코드, 문서, Diff, Preview, 승인(Approval) 및 결과물(产物)을 중심으로 함께 작업할 수 있습니다.
핵심 기능 (核心特性)
- IM 형태 협업 — 1:1 채팅, 그룹 채팅, @Agent 기능을 통해 동일한 작업 흐름 내에서 완료
- 다중 Runtime 스케줄링 — Claude Code, Codex, OpenCode를 통합 Adapter를 통해 연결
- Diff / Preview / Approval — 코드 변경 사항을 인라인으로 표시하고, 승인(Approval) 흐름을 제어 가능
- 3가지 클라이언트 — Tauri Desktop + Web + Expo React Native Mobile (Desktop/Web이 메인 라인이며, Mobile은 조립 중의 fixture/경계 검증 레인입니다. 이는 릴리스 후보가 아니며, 배포 링크는
RELEASE_MOBILE_ENABLED에 의해 게이트(gate)되며 기본적으로 비활성화됩니다.)
- Hub-Edge 분산 구조 — 로컬 실행은 Hub에 의존하지 않으며, Hub는 다중 단말기 동기화, 원격 조회 및 감사 기능을 제공합니다.
기술 스택 (技术栈)
| 계층 | 기술 |
|---|
| Desktop | Tauri 2 · React 19 · TypeScript · Vite |
| ... | |
저장소 구조 (仓库结构)
빠른 시작 (快速开始)
최소 로컬 실행 경로(5단계). OpenSSL, Docker, Go 1.26+, Node 24+/corepack, pnpm 10+가 필요합니다.
터미널 A (인프라 및 Hub):
cp .env.example .env
secret="$(openssl rand -hex 32)"
sed -i.bak "s/^AGENTHUB_JWT_SECRET=.*/AGENTHUB_JWT_SECRET=$secret/" .env && rm -f .env.bak
...
터미널 B (프론트엔드):
cd app && corepack pnpm install
corepack pnpm dev
[IMG:N] 형식의 토큰은 이미지 placeholder입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
.env.example에는 재사용 가능한 JWT secret이 제공되지 않습니다. Windows PowerShell 명령어, 전체 시작 경로, OIDC 연결 및 Edge Server 디버깅은 docs/developer-quickstart.md를 참조하십시오. 프로덕션 배포와 필수 변수는 docs/architecture/05-deployment.md를 참조하십시오.
개발 (Development)
기여 (Contribution)
Issue와 Pull Request를 제출해 주십시오. 자세한 내용은 CONTRIBUTING.md를 참조하십시오.
라이선스 (License)
Apache-2.0. LICENSE를 참조하십시오.