소개
crewhaus는 CrewHaus에서 개발한 오픈소스 메타 하네스 컴파일러로, 단일 사양 파일(crewhaus.yaml)을 여러 종류의 에이전트 런타임 형태로 컴파일하는 도구입니다. Apache-2.0 라이선스로 배포되며, CLI 에이전트뿐 아니라 채널 봇, RAG 파이프라인, 다중 에이전트 크루 등 다양한 형태로 같은 사양을 재컴파일할 수 있도록 설계되었습니다.
상세정보
다양한 타깃 형태로 컴파일
crewhaus는 하나의 사양을 다음의 런타임 형태로 컴파일합니다.
- cli: 자체 포함 TypeScript CLI 에이전트
- channel: Slack, Discord, Telegram, WhatsApp, iMessage 채널 봇
- graph: 상태 기반 그래프 런타임
- pipeline: RAG 파이프라인
- crew: 다중 에이전트 크루
- research: 자율 리서치 에이전트
- batch: 배치 워커
- voice: 음성/실시간 에이전트
- browser: 브라우저/컴퓨터 사용 에이전트
- managed: 다중 테넌트 관리형 런타임
- eval: 다른 타깃을 채점하기 위한 평가 번들
- workflow: 워크플로 오케스트레이션 런타임
- onchain: EVM 기반 온체인 에이전트 런타임
- onchain-game: 온체인 게임 런타임
능동적인 평가 최적화
평가는 사양 패치를 생성하며, crewhaus optimize는 규칙 기반 또는 Claude 기반 방식으로 변이 공간을 탐색해 YAML의 주석과 키 순서를 유지하면서 사양을 다시 작성합니다. 이를 통해 동일한 에이전트가 여러 형태로 배포된 경우에도 한 번의 수정으로 모두에 반영할 수 있습니다.
신뢰 기반 보안 패브릭
MCP 응답, 하위 에이전트 반환값, 채널 인바운드 메시지, 페더레이션 페이로드, 스킬 본문, 컴팩션 요약 등 신뢰할 수 없는 콘텐츠는 단일 경계 분류기를 통해 TrustOrigin 태그가 부여된 뒤에만 모델 호출에 도달합니다. 인증이 누가인지 검증한다면, 분류는 무엇인지를 검증합니다.
메모리와 연속성
v0.3.0부터 모든 에이전트 루프 하네스는 연속성, 로컬 위키, 호스티드 메모리(thredz: true), 자기 학습 하네스, 정직한 실패 처리를 기본 제공합니다. continuity: false 한 줄로 0.2.x 바이트 단위 호환 동작으로 되돌릴 수 있습니다.
풍부한 도구 통합
read, write, edit, bash, grep, webFetch, webSearch 같은 내장 도구를 tools 목록에 선언할 수 있고, MCP 서버 도구는 mcp_servers 아래에 서버만 선언하면 자동으로 등록됩니다.
하나의 사양, 여러 형태
같은 agent 블록을 가진 cli.yaml과 browser.yaml은 target 값만 다릅니다. cli.yaml은 터미널에서 동작하는 로컬 에이전트를 만들고, browser.yaml은 Playwright 기반 헤드리스 Chromium을 통해 실제 브라우저를 구동하는 에이전트를 만듭니다. 두 사양 모두 동일한 지시문으로 동작하며, 배포 환경에 맞춰 형태만 선택할 수 있습니다.
MCP 서버를 활용한 도구 확장
GitHub MCP 서버를 mcp_servers에 등록하면, 그 서버가 노출하는 도구를 일일이 나열하지 않고도 사용할 수 있습니다. 같은 agent 블록과 mcp_servers 블록을 유지한 채 target만 channel로 바꾸면 Slack 봇으로, eval로 바꾸면 라벨링된 데이터셋 기반 평가 번들로 동작합니다.
crewhaus는 무료인가요?
crewhaus는 Apache-2.0 라이선스의 오픈소스 프로젝트이므로 코드 자체는 해당 라이선스 조건에 따라 자유롭게 사용할 수 있습니다.
어떤 형태의 에이전트를 만들 수 있나요?
cli, channel(Slack/Discord/Telegram/WhatsApp/iMessage), graph, pipeline, crew, research, batch, voice, browser, managed, eval, workflow, onchain, onchain-game 형태가 지원됩니다.
Windows에서 어떻게 설치하나요?
winget 사용 시 `winget install CrewHaus.CLI`를, Scoop 사용 시 `scoop bucket add crewhaus https://github.com/crewhaus/scoop-bucket` 후 `scoop install crewhaus`를 실행합니다.
프로젝트에 고정된 버전이 필요한 경우 어떻게 하나요?
chvm으로 `chvm use 0.5.4`처럼 버전을 고정하거나, 소스 체크아웃을 대상으로 즉시 실행하려면 `chvm use local [path]`를 사용합니다.
시스템 요구사항
• 기본 모델은 Anthropic이며, OpenAI, Gemini, Bedrock, Vertex, Azure, Groq, Together, OpenRouter, 그리고 local/@ 형태의 로컬 서버 등 공급자 매트릭스를 지원합니다.
• npm 패키지로 설치할 경우 Bun 1.2 이상이 필요합니다.
• 브라우저 타깃은 헤드리스 Chromium을 사용하므로 Playwright 기반 Chromium을 한 번 설치해야 합니다.
• winget 패키지 식별자는 CrewHaus.CLI이며, 설치 명령은 `winget install --id CrewHaus.CLI --exact`입니다.