튜토리얼: 5분 안에 첫 AI 에이전트 팀 설정하기

Source: Dev.to

Prerequisites

• Python 3.10+
• tmux (sudo apt install tmux on Ubuntu)
• 최소 하나 이상의 AI CLI 설치:
  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • 또는: Gemini CLI, Qwen CLI

Step 1: Install Bridge ACE

git clone https://github.com/Luanace-lab/bridge-ide.git
cd bridge-ide
./install.sh

설치 스크립트는 Python 버전을 확인하고, tmux가 없으면 설치하며, Python 의존성을 설정하고, 런타임 디렉터리를 생성합니다.

Step 2: Start the Platform

./Backend/start_platform.sh

다음이 시작됩니다:

• 포트 9111에서 HTTP 서버
• 포트 9112에서 WebSocket 서버
• 상태 모니터링을 위한 백그라운드 데몬

Step 3: Open the UI

브라우저에서 http://localhost:9111 로 이동합니다. Bridge ACE 랜딩 페이지와 온보딩 동료인 Buddy를 볼 수 있습니다.

Step 4: Configure Your Team

http://localhost:9111/project_config.html 로 이동하여 에이전트를 정의합니다.

{
  "agents": [
    {
      "id": "coordinator",
      "role": "Project Coordinator",
      "engine": "claude",
      "scope": ["*"]
    },
    {
      "id": "backend",
      "role": "Backend Developer",
      "engine": "codex",
      "scope": ["src/api/", "src/models/"]
    },
    {
      "id": "frontend",
      "role": "Frontend Developer",
      "engine": "claude",
      "scope": ["src/ui/", "src/components/"]
    }
  ]
}

Step 5: Watch Them Coordinate

http://localhost:9111/chat.html 를 열어 에이전트 간 실시간 커뮤니케이션을 확인합니다. Coordinator가 작업을 할당하고, Backend와 Frontend 에이전트는 각각의 범위에서 병렬로 작업합니다. Backend이 API 엔드포인트를 완료하면 Frontend에 WebSocket을 통해 즉시 알림이 전달되고 UI 구축을 시작합니다.

Step 6: Monitor in the Control Center

http://localhost:9111/control_center.html 에서 다음을 확인할 수 있습니다:

• 실시간 에이전트 상태 (online/busy/offline)
• 에이전트별 비용 추적
• 작업 칸반 보드
• 계층 구조가 포함된 조직도
• 범위‑잠금 시각화

What Happens Behind the Scenes

• 각 에이전트는 자체 tmux 세션에서 파일 시스템 전체 접근 권한을 가지고 실행됩니다.
• 에이전트는 Bridge MCP 서버에 연결되며, 여기서 204개의 도구를 제공합니다.
• 통신은 WebSocket 버스를 통해 실시간으로 흐릅니다.
• Soul Engine은 재시작 후에도 지속적인 에이전트 정체성을 유지합니다.
• Scope Locks는 에이전트가 서로의 파일을 수정하는 것을 방지합니다.
• 16개의 백그라운드 데몬이 상태를 모니터링하고, 충돌을 처리하며, 속도 제한을 관리합니다.

Next Steps

• 다른 엔진(Qwen, Gemini, Grok)으로 에이전트를 추가합니다.
• guardrails 설정에서 실제 도구(이메일, Slack, 브라우저)를 활성화합니다.
• 다양한 프로젝트를 위한 전문 팀을 만듭니다.
• http://:9111/mobile_buddy.html 에서 모바일 UI를 휴대폰으로 사용해 봅니다.

Resources

• GitHub:
• Release:
• License: Apache 2.0
• FAQ: