Revka 문서

Revka는 Rust 우선, 감사 우선 AI 에이전트 워크플로우 플랫폼입니다. 단일 revka 바이너리에 웹 대시보드, REST + WebSocket 게이트웨이, 크론 스케줄러, 채널 수퍼바이저, 완전한 CLI가 내장되어 있으며, Kumiho 그래프 메모리를 기반으로 동작합니다. 프로세스 하나를 실행하고 모델 프로바이더를 지정하면, 채팅 채널에서 대화하거나, 커맨드라인에서 제어하거나, 선언적 워크플로우로 오케스트레이션할 수 있는 거버넌스가 적용된 에이전트가 바로 준비됩니다.

이 문서는 Revka가 제공하는 모든 기능을 다룹니다: 설치 및 온보딩, 핵심 개념, 대시보드, 게이트웨이 API, 채널, 프로바이더, 도구, 메모리, 워크플로우, 크론, 보안, 배포, 하드웨어, MCP/확장성, 그리고 설정 레퍼런스. 처음 시작하는 분이라면 설치와 빠른 시작부터, 통합을 원하신다면 게이트웨이 API로, 운영 환경을 담당하신다면 배포로 바로 이동하세요.

Revka 설치 macOS, Linux, Windows 또는 컨테이너 환경에서 revka 바이너리를 실행하세요.

빠른 시작 프로바이더를 온보딩하고, 게이트웨이를 시작한 뒤, 첫 번째 에이전트와 대화해보세요.

Revka란 무엇인가

Revka는 언어 모델을 장시간 실행되는 거버넌스가 적용된 에이전트로 변환합니다. 단일 호스트 프로세스가 에이전트 루프를 실행하고, 대시보드와 API를 제공하며, 채팅 채널을 감독하고, 예약 작업을 실행하며, 메모리를 영구 저장합니다. 덕분에 동일한 에이전트를 Telegram, 브라우저, CLI, IDE, 또는 A2A 프로토콜을 통한 다른 에이전트에서 모두 접근할 수 있습니다.

Rust 우선 런타임

런타임은 100% Rust로 작성되어 Raspberry Pi부터 프로덕션 클라우드 클러스터까지 어디서나 배포할 수 있습니다. 동일한 바이너리가 포그라운드 세션, 게이트웨이 전용 서버, 자율 데몬, OS 서비스, 또는 컨테이너로 실행됩니다.

메모리 네이티브

Kumiho 버전 관리 그래프 메모리 위에 구축되었습니다. 에이전트는 응답 전에 관련 컨텍스트를 상기하고, 응답 후에는 구조화된 캡처(결정, 사실, 선호도, 스킬, 성찰)를 프로버넌스 엣지로 연결해 저장합니다. 지식, 결정, 스킬이 세션을 넘어 이어집니다.

게이트웨이 + 대시보드

REST + SSE + WebSocket 게이트웨이와 내장 React 대시보드가 워크플로우, 에이전트, 메모리, 크론, 비용, 감사, 설정을 하나의 URL에서 제공합니다.

감사 우선 설계

승인, 긴급 정지, OTP 게이팅, 커맨드 정책, 런타임 트레이싱이 핵심 기능으로 내장되어 있습니다. 나중에 추가된 기능이 아닙니다.

단일 바이너리 아키텍처

revka 바이너리에는 모든 런타임 컴포넌트가 내장되어 있어, 설치부터 에이전트 실행까지 단일 프로세스만으로 충분합니다. 포함된 컴포넌트는 다음과 같습니다:

• 에이전트 루프 — 모델 기반 추론, 도구 호출, 응답 사이클.
• 게이트웨이 — REST API, Server-Sent Events 스트림, WebSocket 엔드포인트, 내장 React/TypeScript 대시보드.
• 채널 수퍼바이저 — Telegram, Discord, Slack, Matrix 등 채팅 채널을 지수 백오프 방식으로 연결하고 재시작합니다.
• 크론 스케줄러 — 에이전트 작업을 위한 영구 예약 작업.
• 하트비트 — 선택적으로 LLM 기반 체크인 작업을 일정 간격으로 실행합니다.
• Kumiho 메모리 — Python MCP 사이드카를 통한 그래프 기반 상기 및 캡처.

revka gateway는 대시보드와 API만 시작합니다. revka daemon은 게이트웨이, 설정된 모든 채널, 하트비트, 크론 스케줄러를 하나의 감독 프로세스로 실행합니다.

revka gateway        # dashboard + REST/SSE/WebSocket API only
revka daemon         # full runtime: gateway + channels + heartbeat + cron

기본적으로 게이트웨이는 http://127.0.0.1:42617(로컬호스트 전용)에 바인딩됩니다. 루프백이 아닌 주소에 바인딩하려면 gateway.allow_public_bind = true가 필요합니다.

[gateway]
host = "127.0.0.1"   # 0.0.0.0 / [::] for LAN — needs allow_public_bind
port = 42617
allow_public_bind = false

첫 실행부터 유용한 엔드포인트가 몇 가지 있습니다:

curl http://127.0.0.1:42617/health      # liveness probe
revka status                            # daemon/component status
revka status --format=exit-code         # 0 = healthy (used by Docker HEALTHCHECK)

팁

런타임은 에이전트 또는 데몬을 처음 시작할 때 Python MCP 사이드카(Kumiho 및 Operator)를 사이드카별 격리 가상 환경에 자동으로 프로비저닝합니다. Python MCP 사이드카 설치를 참고하세요.

대시보드

게이트웨이에는 동일한 주소에서 제공되는 18개 라우트의 React 대시보드가 내장되어 있습니다. 게이트웨이가 실행 중이면 브라우저에서 열 수 있습니다:

http://127.0.0.1:42617

페이지는 오케스트레이션, 운영, 검사 영역으로 구분됩니다:

• 오케스트레이션 — Dashboard, Workflows, Runs, Teams, Canvas, Agents.
• 운영 — Cron, Cost, Config, Skills, Tools, Integrations, Skins.
• 검사 — Memory, Assets, Logs, Audit, Doctor, Pairing.

게이트웨이에 페어링이 필요한 경우 대시보드가 페어 코드를 요청합니다. CLI에서 생성할 수 있습니다:

revka gateway get-paircode          # show the current pair code
revka gateway get-paircode --new    # rotate it

각 페이지에 대한 투어는 대시보드 개요를, 로컬에서 실행하는 방법은 대시보드 실행을 참고하세요.

메모리 네이티브 런타임

Revka에는 두 가지 메모리 레이어가 있습니다. 로컬 메모리는 CLI에서 조회하고 관리할 수 있는 에이전트 항목을 저장합니다:

revka memory stats
revka memory list [--category NAME] [--session ID]
revka memory get KEY
revka memory clear [--key KEY] [--category CATEGORY] [--yes]

Kumiho 그래프 메모리는 에이전트에게 연속성을 제공하는 영구 버전 관리 그래프입니다. 두 단계 반사 패턴을 사용합니다: 에이전트가 응답 전에 관련 메모리를 engage(상기)하고, 응답 후에는 DERIVED_FROM, DEPENDS_ON 같은 프로버넌스 엣지로 연결된 구조화된 캡처(결정, 사실, 선호도, 스킬, 성찰)를 reflect(저장)합니다. [kumiho] 설정 섹션에서 연결할 수 있습니다:

[kumiho]
api_url = "https://api.kumiho.cloud"
auth_token = "..."        # or KUMIHO_AUTH_TOKEN env
space_prefix = "Revka"
mcp_path = "~/.revka/kumiho/run_kumiho_mcp.py"

패턴은 Kumiho 그래프 메모리, 메모리 개요, 그래프 모델 레퍼런스에서 확인하세요.

세 단계로 시작하기

1. 설치. Homebrew, 원클릭 부트스트랩 스크립트, 사전 빌드된 바이너리, 또는 Docker를 사용하세요 — 설치를 참고하세요.

   brew install revka
   # or
   curl -fsSL https://raw.githubusercontent.com/KumihoIO/Revka/main/install.sh | bash

2. 프로바이더 온보딩. revka onboard는 프로바이더, 모델, API 키를 포함한 ~/.revka/config.toml을 대화형 또는 비대화형으로 작성합니다.

   revka onboard --api-key sk-... --provider openrouter

3. 실행 및 연결. 게이트웨이(또는 전체 데몬)를 시작하고 대시보드를 열거나 에이전트와 채팅하세요.

   revka gateway

엔드투엔드 안내는 빠른 시작을, 모든 revka onboard 옵션은 온보딩 마법사를 참고하세요.

문서 둘러보기

시작하기 설치, 온보딩, 사이드카 설정, macOS 라이프사이클.

개념 에이전트 루프, 자율성 및 승인, 세션, 보안 모델.

가이드 대시보드 실행, 채팅, 채널 연결, 브라우저 자동화, 메모리.

CLI agent, gateway, cron, channel, models, memory 등 모든 revka 명령어.

게이트웨이 API 페어링 및 인증, 상태, 세션, 에이전트, 메모리, 웹훅, 실시간.

대시보드 내장 18개 라우트 웹 UI의 페이지별 투어.

채널 Telegram, Discord, Slack, Matrix, WhatsApp, 이메일 등 연결.

프로바이더 클라우드, 로컬, OAuth/구독, 커스텀 엔드포인트 모델 프로바이더.

도구 파일시스템, 브라우저, 미디어, 스케줄링, 위임, 통합 도구.

메모리 Kumiho 설정, 메모리 도구, 그래프 모델, 캐시, 격리.

워크플로우 및 SOP 단계, 트리거, 실행, 승인을 포함한 YAML 워크플로우 및 SOP 작성.

크론 크론 표현식, 인터벌, 원샷으로 에이전트 작업 예약.

보안 정책 및 샌드박싱, OTP 게이팅, 긴급 정지, 감사 로그, IAM.

배포 런타임 모드, 백그라운드 서비스, Docker/PaaS, 터널, 관찰 가능성.

하드웨어 보드, 펌웨어, GPIO, Raspberry Pi, Aardvark, Robot Kit.

MCP 및 확장성 MCP 서버/클라이언트로서의 Revka, 스킬 시스템, WASM 플러그인.

에코시스템 데스크톱 앱, Operator MCP, 에이전트 오케스트레이션, A2A, 클라우드 에이전트.

레퍼런스 전체 설정 레퍼런스, 기능 플래그, ADR.