desplega-ai/agent-swarm

agent‑swarm – AI 네이티브 작업을 위한 오픈소스 운영체제

무엇인가요 – agent-swarm는 일상적인 채널(Slack, 이메일, GitHub, API 등)에서 작업을 수신하는 "리드" AI 에이전트가, 격리된 Docker 컨테이너 내에서 실행되는 전문 워커 에이전트에게 작업을 위임할 수 있는 프레임워크입니다. 워커 에이전트는 지속 가능한 "뇌"(벡터 검색 메모리 및 아이덴티티 저장소)를 공유하여 세션 간에 컨텍스트를 유지할 수 있으며, 시스템은 자동으로 풀 리퀘스트, Slack 응답, 이메일 응답을 생성할 수 있습니다.

주요 구성 요소

• 리드 에이전트 – 작업을 계획하고 우선순위를 정하며 라우팅합니다.
• 워커 에이전트 – Docker로 격리된 런타임으로, 지원되는 모델(Claude Code, Codex, Pi, Open‑Code, Devin, ACP 등)을 어디서든 실행할 수 있습니다.
• 지속 가능한 뇌 – 재시작 후에도 유지되는 벡터 검색 메모리 + 아이덴티티(SOUL, CLAUDE.md).
• 통합 기능 – Slack, GitHub/GitLab, Linear, Jira, WhatsApp, Sentry 등 사전 구축된 커넥터 제공.
• 실시간 룸 – 협업 디버깅 또는 실시간 모니터링을 위한 공유 상태 및 존재 감지 채널.
• 확장 가능한 하네스 – 기반 LLM 제공업체를 자유롭게 선택 가능. 플랫폼은 모델에 독립적입니다.

일반적인 사용 사례

• Slack이나 이슈 트래커에서 직접 코드 리뷰 및 PR 생성을 자동화.
• 완전한 컨텍스트를 유지한 채로 주기적인 유지보수 스크립트(예: 매일 밤 의존성 업데이트) 실행.
• 티켓을 읽고 코드를 작성하며 고객에게 응답하는 등 인간의 개입 없이 작동하는 내부 "AI 어시스턴트" 구축.
• 데이터를 온프레미스에 보관하고 싶은 제품 팀을 위한 자체 호스팅된 AI 네이티브 백엔드 제공.

빠른 시작

# 기존 운영자에 기술 추가 (Desplega 기술 시스템 사용 시)
npx skills add desplega-ai/agent-swarm

# 또는 리포지토리 직접 실행
git clone https://github.com/desplega-ai/agent-swarm.git && cd agent-swarm
cp .env.docker.example .env   # API_KEY, 하네스 자격 증명, 8개의 에이전트 UUID 입력
openssl rand -base64 32 > encryption_key && chmod 600 encryption_key
docker compose -f docker-compose.example.yml --env-file .env up -d

API는 http://localhost:3013 에서 사용 가능하며, Swagger 문서는 /docs 에 있습니다. 또한 시각적 모니터링을 위한 웹 대시보드는 https://app.agent-swarm.dev 에 제공됩니다.

문서 및 커뮤니티

• 전체 문서: https://docs.agent-swarm.dev
• 라이브 데모 사이트: https://agent-swarm.dev
• 지원 및 기능 논의를 위한 Discord 커뮤니티.
• 기여 가이드 및 오픈 PR 정책(CONTRIBUTING.md 참조).

라이선스 – MIT (2025–2026, Desplega Labs). 프로젝트는 적극적으로 유지보수되며 커뮤니티 기여를 환영합니다.