OpenSwarm: 선형 및 GitHub용 다중 에이전트 Claude CLI 오케스트레이터

OpenSwarm의 기능

OpenSwarm은 Claude Code CLI로 구동되는 자율 AI 에이전트 오케스트레이터입니다. 실제 개발 워크플로우, 특히 이슈 추적을 위한 Linear와 코드 관리를 위한 GitHub와 통합되는 다중 에이전트 시스템을 생성합니다. 이 도구는 단순한 예제가 아닌 실제 개발 작업을 처리하도록 설계되었습니다.

핵심 아키텍처 및 기능

시스템은 구조화된 파이프라인 접근 방식을 따릅니다:

• 자율 파이프라인: Cron 기반 하트비트가 Linear 이슈를 가져와 Worker/Reviewer 페어 루프를 실행합니다
• Worker/Reviewer 페어: 자동화된 검토, 테스트, 문서화 단계를 포함한 다중 반복 코드 생성
• 결정 엔진: 범위 검증, 속도 제한, 우선순위 기반 작업 선택, 워크플로우 매핑
• 인지 메모리: 세션 간 장기 기억을 위한 Xenova/multilingual-e5-base 임베딩과 LanceDB 벡터 저장소
• 지식 그래프: 더 스마트한 작업 실행을 위한 정적 코드 분석, 종속성 매핑, 영향 분석
• Discord 제어: 모니터링, 작업 디스패치, 스케줄링, 페어 세션 관리를 위한 완전한 명령 인터페이스
• PR 자동 개선: 열린 PR을 모니터링하고, CI 실패를 자동 수정하며, 병합 충돌을 자동 해결하고, 모든 체크가 통과할 때까지 재시도합니다
• 장기 실행 모니터: 외부 프로세스(훈련 작업, 배치 작업)를 추적하고 완료를 보고합니다
• 웹 대시보드: PR 프로세서 모니터링을 포함한 포트 3847의 실시간 상태 대시보드
• i18n 지원: 영어 및 한국어 로케일 지원

기술 요구사항

• Node.js >= 22
• Claude Code CLI 설치 및 인증 (claude -p)
• 메시지 콘텐츠 인텐트가 있는 Discord 봇 토큰
• Linear API 키 및 팀 ID
• CI 모니터링을 위한 GitHub CLI (gh) (선택사항)

설치 및 구성

기본 설정:

git clone https://github.com/unohee/OpenSwarm.git
cd OpenSwarm
npm install

구성은 예제 설정 파일을 복사하고 .env 파일을 생성하는 작업을 포함합니다:

cp config.example.yaml config.yaml

필요한 .env 변수:

DISCORD_TOKEN=your-discord-bot-token
DISCORD_CHANNEL_ID=your-channel-id
LINEAR_API_KEY=your-linear-api-key
LINEAR_TEAM_ID=your-linear-team-id

config.yaml은 환경 변수 치환(${VAR} 또는 ${VAR:-default})을 지원하며 Zod 스키마로 검증됩니다. 주요 구성 섹션에는 discord, linear, github, agents, autonomous, prProcessor 설정이 포함됩니다.

현재 상태 및 제한사항

제작자는 이 소프트웨어가 아직 초기 단계이며 다듬어야 할 부분이 많다고 언급합니다. 현재 할 일 목록은 안전성, 확장성, 더 나은 작업 분해에 초점을 맞추고 있습니다. 이 시스템은 현재 제작자의 트레이딩 인프라, LLM 도구 및 기타 프로젝트를 위한 단독 개발 워크플로우를 구동하고 있습니다.