Revka를 실행하세요. 여러분의 하드웨어, 여러분의 키로.
React 대시보드가 임베드된 단일 Rust 바이너리, 오케스트레이션을 위한 Python Operator MCP, 그리고 영속 메모리 백본인 Kumiho. 한 줄로 설치하고, 14+ 프로바이더 중 하나를 BYO로 연결한 뒤, 멀티 에이전트 워크플로를 바로 출시하세요.
한 줄로 설치
GitHub에서 인스톨러를 바로 파이프하세요. 툴체인, 사이드카, onboard, http://127.0.0.1:42617 대시보드까지 모두 처리합니다 — clone 필요 없음.
# One-line install (macOS / Linux / WSL)
curl -fsSL raw.githubusercontent.com/KumihoIO/Revka/main/install.sh | bash
# then
revka gateway # start the HTTP gateway + dashboard
revka agent -m "Hello"
revka status# One-line install (Windows · PowerShell)
curl.exe -sSfL raw.githubusercontent.com/KumihoIO/Revka/main/setup.ps1 -o "$env:TEMP\revka-setup.ps1"; & "$env:TEMP\revka-setup.ps1" -Mode Prebuilt
# then
revka gateway
revka agent -m "Hello"
revka status- rustup으로 Rust 자동 설치(소스 모드, 없는 경우)
- 또는 프리빌드 revka 바이너리 받기 (Windows 기본)
- ~/.revka/ 아래에 Kumiho + Operator Python MCP 사이드카 설치
- 대화형 프로바이더 + API 키 설정을 위한 revka onboard 실행
- http://127.0.0.1:42617 에서 대시보드 열기
첫 실행 — revka onboard
설치 후 onboard 마법사가 워크스페이스를 구성합니다: 기본 프로바이더 선택, API 키 입력(지원되는 곳은 OAuth), Kumiho 엔드포인트 지정, 채널 선택. 프로바이더 추가/회전이 필요할 때 언제든 다시 실행하세요.
- 대화형 선택: 프로바이더, 모델, Kumiho 엔드포인트, 채널
- OAuth 지원: Anthropic, OpenAI, Google, GitHub
- 그 외에는 API 키 붙여넣기 — 키는 호스트를 떠나지 않음
- ~/.revka/config.toml 작성; 다시 실행해도 안전
- --quick 모드는 프롬프트 없이 기본값으로 설정
# Interactive wizard — pick provider, paste keys, set defaults
revka onboard
# Or skip the prompts: minimal config, sensible defaults
revka onboard --quick사전 요구사항
Rust stable (1.87+)
없으면 install.sh / setup.bat이 rustup으로 자동 설치합니다.
Python 3.11+
Kumiho 및 Operator Python MCP 사이드카에 필요합니다.
Kumiho 엔드포인트
기본값은 api.kumiho.cloud (무료 5,000 노드). Enterprise에서 셀프 호스트 가능.
디스크 / RAM
소스 빌드는 ~6 GB 디스크와 ~2 GB RAM 필요. 프리빌드 바이너리는 ~200 MB.
Revka를 Kumiho에 연결
Revka는 [kumiho].api_url을 통해 HTTP로 Kumiho와 통신합니다. 도달 가능한 엔드포인트가 없으면 stateless 단일 에이전트로 동작 — 데모용으로는 유용하지만, 세션 간 메모리와 출처는 그래프에 저장됩니다.
# ~/.revka/config.toml
default_provider = "anthropic"
api_key = "sk-ant-..."
[kumiho]
enabled = true
mcp_path = "~/.revka/kumiho/run_kumiho_mcp.py"
space_prefix = "Revka"
api_url = "https://api.kumiho.cloud" # or your self-hosted URL
[operator]
enabled = true
mcp_path = "~/.revka/operator_mcp/run_operator_mcp.py"워크플로 DSL — 17가지 step 타입
워크플로는 Kumiho 리비전에 첨부된 YAML 아티팩트입니다. 저장할 때마다 새 리비전이 만들어지고 diff 히스토리가 보존되며, 승격은 태그로 처리됩니다. 멀티 에이전트 패턴이 1급으로 지원됩니다.
Kumiho 리비전에 태그를 다는 것이 일치하는 triggers: 블록을 가진 모든 워크플로를 실행시킵니다. 그래프가 이벤트 버스입니다.
# A reactive workflow that fires when any
# qs-arc-plan revision is tagged "ready" in Kumiho
triggers:
- on_kind: "qs-arc-plan"
on_tag: "ready"
input_map:
arc_kref: "${trigger.entity_kref}"
arc_name: "${trigger.metadata.arc_name}"CLI 명령
최상위 revka 서브커맨드.
임베디드 웹 대시보드
React, TypeScript, Tailwind, Vite로 만든 18개의 라우팅 뷰가 rust-embed를 통해 컴파일 시점에 Rust 바이너리에 구워집니다. 하나의 바이너리, 하나의 진입점.
- Dashboard
- Workflows
- Workflow Runs
- Agents
- Canvas
- Teams
- Assets
- Skills
- Tools
- Integrations
- Cron
- Pairing
- Config
- Cost
- Memory
- Logs
- Audit
- Doctor
프로토콜
Revka는 최신 에이전트 프로토콜을 기본 지원합니다.
A2A (Agent-to-Agent)
JSON-RPC 2.0 태스크 라이프사이클, /.well-known/agent-card.json 디스커버리, 백오프 재시도.
MCP (Model Context Protocol)
세션 레지스트리, 진행 래핑, 스킬-투-도구가 포함된 in-process MCP 서버.
ACP (stdio)
IDE / 도구 통합을 위한 stdio 위 JSON-RPC 2.0, revka acp.
보안 & 신뢰
Merkle 해시 체인 감사
/api/audit/verify로 암호학적 검증이 가능한 변조 방지 이벤트 로그.
신뢰 점수
모든 실행이 점수화. Kumiho의 Revka/AgentTrust/ 아래 기록.
휴먼 승인 게이트웨이
대시보드, Slack, Discord를 통한 yes/no 승인.
E-Stop
network-kill, domain-block, tool-freeze 단계의 비상 정지.
관련 자료
오픈 소스. 여러분이 운영합니다.
Revka는 MIT 또는 Apache 2.0으로 듀얼 라이선스됩니다. Kumiho 무료 티어는 5,000 노드 — 데모 한도가 아닌 실제 평가 영역입니다. 30일 Studio 트라이얼은 Revka가 첫 메모리를 저장하는 순간 풀려요.