HarnessRouter: 30개 에이전트 하네스를 하나로 통합하는 오픈소스 셀프호스팅 인터페이스

이미지 출처: https://github.com/HarnessRouter/harnessrouter

Avi Chawla는 2026년 10월 X 게시물에서 에이전트 하네스를 단일 인터페이스로 연결하는 인프라 레이어 HarnessRouter 커뮤니티 에디션이 오픈소스로 공개됐다고 전했습니다.

이미지 출처: HarnessRouter

기존에는 여러 에이전트 하네스를 프로젝트에 연동할 때마다 각기 다른 세션, 스트리밍, 파일 관리 로직을 개별 구현해야 했습니다. HarnessRouter는 오픈 표준인 **Unified Harness Protocol(UHP)**과 OpenAI Responses 호환 API를 도입하여 이 복잡성을 단일 인터페이스로 표준화합니다.

Unified Harness Protocol(UHP)과 단일 API 통합

HarnessRouter는 Codex, Claude Code, Hermes, Pi, DeepSeek Harness, OpenCode, Kilo Code, Qwen Code, Gemini CLI, Cline, Oh My Pi, goose, Kimi Code CLI, MiniMax Code, Aider, OpenHands, CheetahClaws, Grok Build, Agent Zero, System One, Qoder Cloud Agent, MiMo Code, jcode, OpenSquilla, nanobot, ZeroClaw, Mistral Vibe, Docker Agent, fast-agent, Deep Agents Code 등 30개 에이전트 하네스 베이스를 지원합니다.

• 네이티브 런타임 유지: Avi Chawla의 X 게시물에 따르면 HarnessRouter는 각 하네스의 네이티브 동작을 유지하면서 Grok Bot이 HarnessRouter 서버와 통신하는 방식을 표준화합니다.
• 표준화된 세션 제어: 세션 유지, 스트리밍 진행 상황, 파일 생성 및 아티팩트 관리, 작업 취소, 구조화된 오류 처리(cancellation and failure handling)를 모두 동일한 인터페이스에서 처리합니다.

단일 도커 컨테이너를 통한 로컬 셀프호스팅

HarnessRouter 커뮤니티 에디션은 Apache-2.0 라이선스로 제공되며, 사용자가 직접 제어하는 인프라에서 셀프호스팅할 수 있습니다.

• 시스템 요구사항: Docker 실행 환경, 약 4GB의 디스크 공간, 사용자 소유의 모델 공급자 API 키가 필요합니다.
• 빠른 시작 명령어:

docker run -d --name harnessrouter \
  -p 127.0.0.1:3000:3000 \
  -v harnessrouter:/data \
  harnessrouter/harnessrouter

컨테이너 실행 후 docker logs -f harnessrouter 명령을 통해 로그를 확인하고, 초기 준비가 완료되면 브라우저에서 http://localhost:3000에 접속하여 기본 계정(harnessrouter / harnessrouter)으로 로그인할 수 있습니다. 보안을 위해 최초 로그인 후 프로필 설정에서 비밀번호 변경이 권장됩니다.

• Bring Your Own Key(BYOK): 콘솔 하단 메뉴에서 사용 중인 모델 공급자의 API 키를 직접 등록하여 에이전트의 모델 요청을 승인합니다.

제품 통합 및 인프라 제어

HarnessRouter는 제품 백엔드에서 자체 호스팅 인스턴스의 OpenAI Responses 호환 API를 호출하고 metadata.harness_id를 지정하는 방식으로 원하는 에이전트 하네스를 교체할 수 있게 설계되었습니다. 이를 통해 팀은 하네스 엔지니어링의 부담 없이 다양한 에이전트 백엔드를 전환할 수 있으며, 비용이 가장 낮거나 속도가 가장 빠른 구성은 태스크에 따라 달라질 수 있습니다.

출처

• GitHub Repository: HarnessRouter/harnessrouter
• Avi Chawla의 X 게시물: @_avichawla Status 2113954302901256597