HKUDS/AutoSwarm

AutoSwarm – AI 에이전트 군집 자동화

소개

• 복잡한 실제 작업을 해결하기 위해 전체 AI 기반 조직 (회사)을 생성, 실행 및 진화시킬 수 있는 오픈 소스 Python 프레임워크입니다.
• CLI와 웹 기반 Office UI (React + Phaser)를 결합하여 터미널이나 각 역할이 애니메이션 아바타로 표시되는 시각적 "오피스"에서 군집과 상호 작용할 수 있습니다.

핵심 아이디어

단계	내용
자체 구축	목표가 주어지면 AutoSwarm은 조직도를 초안으로 작성하고, 각 역할에 맞는 AI "직원"(에이전트)을 선택하거나 고용하며, 향후 재사용을 위해 저장합니다.
자체 실행	팀은 칸반 보드에서 작업합니다. 상태 머신이 각 작업 항목을 계획 → 실행 → 검토 → 통합 → 재작업 단계로 구동하며, 종속성, 차단 요소, 필요 시 인간에게 에스컬레이션을 처리합니다.
자체 성장	실행 후 결과는 담당 역할에 귀속되며, 교훈은 개인 경험 프로파일로 추출되고 다음 프로젝트를 위한 재사용 가능한 플레이북이 생성됩니다.

주요 기능

• 회사 모드 – 명시적인 보고 라인을 갖춘 다중 역할 군집을 실행합니다. 역할마다 다른 LLM 백엔드(Claude, Codex, OpenAI 등)를 사용할 수 있습니다.
• 적응형 팀 생성 – 채용 담당 에이전트가 조직도를 설계하고 인재 풀에서 자동으로 고용할 수 있습니다.
• 칸반 기반 오케스트레이션 – 시각적 보드에서 각 항목의 열, 소유자, 준비 상태를 표시하며 병렬 작업이 자동으로 예약됩니다.
• 플레이북 학습 – 역할별 경험이 지속되고 공유되어 군집이 시간이 지남에 따라 더 똑똑해집니다.
• JiuwenSwarm 통합 – JiuwenSwarm 단일 에이전트 또는 팀을 불투명한 구성 요소로 플러그인합니다.
• 두 가지 인터페이스 – 스크립트/CI용 autoswarm CLI와 대화형 모니터링용 Office UI (http://localhost:8765)를 제공합니다.
• 확장 가능한 플러그인 – 외부 에이전트(예: Codex, Cursor)를 역할별로 교체할 수 있으며, 시스템이 누락된 기능을 명확하게 보고합니다.

일반적인 워크플로우

1. 설정 – uv로 설치하고 autoswarm init을 실행하여 구성, 메모리 및 프로젝트 폴더를 생성합니다.
2. UI 시작 – autoswarm ui (또는 opc ui)로 Office UI를 엽니다.
3. 채팅 생성 – Company 모드를 선택하고 미리 구축된 조직(예: Corporate)을 선택하거나 시스템이 자동으로 팀을 구성하도록 합니다.
4. 목표 정의 – 채용 담당자가 역할을 초안하고 에이전트를 고용하며, 사용자가 계획을 승인합니다.
5. 실행 – 군집이 작업을 실행하고, 사용자는 칸반이나 오피스 뷰에서 진행 상황을 관찰하며 필요 시 차단 요소에 개입합니다.
6. 학습 – 완료 후 AutoSwarm은 역할 경험을 업데이트하고 향후 실행을 위한 플레이북을 생성합니다.

설치 (빠른 시작)

# Install uv (recommended)
brew install uv   # macOS
# or curl https://astral.sh/uv/install.sh | sh  # Linux/Windows

# Clone and set up the repo
git clone https://github.com/HKUDS/AutoSwarm.git
cd AutoSwarm
uv python install 3.12   # any >=3.10 works
uv venv --python 3.12
source .venv/bin/activate   # or .venv\Scripts\activate on Windows
uv pip install -e .
uv run autoswarm init
uv run autoswarm ui   # opens the UI at http://localhost:8765

(헤드리스 사용 시 autoswarm ui를 autoswarm chat 또는 autoswarm exec로 대체하세요.)

사용 대상

• 제품 팀 – 기능 프로토타입 제작, 코드 작성, 콘텐츠 생성을 위한 AI "어시스턴트 크루"를 원하는 팀.
• 연구원 – 다중 에이전트 시뮬레이션을 구축하거나 LLM 기반 워크플로우를 평가하는 연구원.
• 컨설턴트 – 자가 조직화 AI 직원을 사용하여 반복적인 비즈니스 프로세스(시장 조사, 투자 메모 등)를 자동화하려는 컨설턴트.
• 개발자 – 복잡하고 다단계인 AI 작업을 위해 프로그래밍 가능하고 재현 가능한 환경이 필요한 개발자.

로드맵 하이라이트

• 더 탄력적인 회사 세션 (2026년 7월).
• JiuwenSwarm 0.2.4b4 호환성 (2026년 9월).
• UI 성능 개선 및 더 부드러운 실시간 업데이트.
• 지속적인 승인 및 더 스마트한 자동 의사결정 흐름.

라이선스 – MIT (LICENSE 참조).

---

모든 세부 정보는 저장소의 README에서 직접 가져왔으며, 외부 가정은 추가되지 않았습니다.