빠른 시작
설치 후 몇 분 안에 게이트웨이를 실행하고 첫 번째 에이전트 메시지를 주고받는 방법입니다.
이 페이지에서는 처음 설치한 상태에서 게이트웨이 실행, 웹 대시보드 접속, 그리고 revka CLI를 통한 첫 번째 에이전트 응답까지의 과정을 안내합니다. Revka 설치 직후 가장 빠르게 에이전트를 동작시키고 싶을 때 이 페이지를 참고하세요. 프로바이더, 채널, 메모리, 터널을 단계별로 안내받고 싶다면 온보딩 마법사를 실행하세요.
사전 요건
섹션 제목: “사전 요건”PATH에revka바이너리가 등록되어 있어야 합니다. 아직 설치하지 않았다면 설치를 참고하세요.- LLM 프로바이더의 API 키가 필요합니다 (기본값은 OpenRouter이며, Anthropic, OpenAI, Ollama 등 다양한 프로바이더를 지원합니다).
바이너리가 정상적으로 인식되는지 확인하세요:
revka --version1. 설정 초기화
섹션 제목: “1. 설정 초기화”온보딩 설정을 한 번 실행하여 워크스페이스를 생성하고 ~/.revka/config.toml을 작성합니다. 가장 빠른 방법은 스크립트 방식의 빠른 설정입니다:
revka onboard --api-key "sk-..." --provider openrouter이 명령은 기본 설정(프로바이더 openrouter, 메모리 sqlite, 온도 0.7)과 ~/.revka/workspace/ 하위의 워크스페이스를 생성합니다. 다른 프로바이더, 모델, 또는 메모리 백엔드를 선택하려면:
revka onboard --api-key "sk-..." --provider anthropic --model claude-sonnet-4-20250514 --memory kumiho플래그 없이 터미널에서 revka onboard를 실행하면 대화형 마법사가 시작됩니다. 전체 흐름은 온보딩 마법사를 참고하세요.
2. 첫 번째 에이전트 메시지 전송
섹션 제목: “2. 첫 번째 에이전트 메시지 전송”게이트웨이를 시작하기 전에 단일 에이전트 쿼리로 프로바이더 키가 정상 동작하는지 확인하세요. -m 플래그는 메시지 하나를 처리하고 종료합니다 — 대화형 루프나 게이트웨이가 필요하지 않습니다:
revka agent -m "In one sentence, what is Revka?"revka agent에서 유용한 플래그:
| 플래그 | 설명 |
|---|---|
-m, --message <TEXT> | 단일 메시지 모드 (대화형 루프 없음) |
-p, --provider <ID> | 설정된 기본 프로바이더 덮어쓰기 |
--model <MODEL_ID> | 설정된 기본 모델 덮어쓰기 |
-t, --temperature <0.0-2.0> | 설정된 온도 덮어쓰기 |
--session-state-file <PATH> | 실행 간 세션 상태 유지 및 복원 |
응답이 돌아오면 프로바이더와 키가 정상 동작하는 것입니다. 대화형 세션으로 전환하려면 플래그 없이 revka agent를 실행하세요. 전체 레퍼런스는 revka agent를 참고하세요.
3. 게이트웨이 시작
섹션 제목: “3. 게이트웨이 시작”게이트웨이는 REST API, WebSocket 및 SSE 엔드포인트, 그리고 내장 React 대시보드를 제공합니다. 포그라운드에서 시작하세요:
revka gateway기본적으로 게이트웨이는 127.0.0.1에 바인딩되며 시작 시 URL을 출력합니다. 리슨 포트는 설정([gateway].port)에서 가져오며, 빠른 설정은 8080을, 내장 스키마 기본값은 42617을 사용합니다. 일반적인 변형:
revka gateway start -p 8080 # 명시적 포트 지정revka gateway start -p 0 # 사용 가능한 임의 포트 선택revka gateway restart # 무중단 재시작채널, 하트비트, 크론 스케줄러까지 함께 시작하는 장기 실행 설정이 필요하다면 revka daemon을 사용하거나 revka service install로 OS 서비스로 등록하세요.
4. 대시보드 열기
섹션 제목: “4. 대시보드 열기”게이트웨이가 실행 중인 상태에서 출력된 URL로 브라우저를 열면 대시보드에 접속됩니다 — 루트 경로에서 React 앱이 제공됩니다:
http://127.0.0.1:8080/Revka는 기본적으로 require_pairing = true가 설정되어 있으므로, 첫 번째 연결 시 베어러 토큰을 발급받기 전에 일회성 페어링 코드가 필요합니다. CLI에서 현재 코드를 확인하거나 갱신하세요:
revka gateway get-paircode # 현재 페어링 코드 표시revka gateway get-paircode --new # 새 코드로 갱신대시보드에서 코드를 입력하면 브라우저 범위의 베어러 토큰이 발급됩니다. 브라우저가 아닌 클라이언트(예: 휴대폰이나 스크립트)를 페어링하려면 코드를 토큰으로 직접 교환하세요:
revka pair token --code 123456 --name "My laptop"페어링이 완료되면 대시보드에서 채팅, 워크플로, 메모리 그래프, 승인, 감사 뷰를 이용할 수 있습니다. 자세한 내용은 대시보드 개요와 대시보드 실행을 참고하세요.
5. CLI 채널로 스모크 테스트
섹션 제목: “5. CLI 채널로 스모크 테스트”CLI 채널은 에이전트와 종단 간 대화를 나눌 수 있는 가장 간단한 방법입니다 — 터미널의 stdin/stdout을 통해 동작하며 외부 자격 증명이 전혀 필요하지 않으므로, Telegram, Discord 또는 원격 채널을 연결하기 전 이상적인 스모크 테스트입니다. ~/.revka/config.toml에서 활성화하세요:
[channels_config]cli = true그런 다음 대화형 채팅을 시작하세요:
revka chat메시지를 입력하고 응답을 확인한 후 /quit 또는 /exit로 종료하세요. 여기서 정상적인 응답을 받으면 프로바이더, 메모리 백엔드, 에이전트 루프가 모두 올바르게 연결된 것입니다. 이제 메시징 채널 연결을 통해 실제 메시징 플랫폼을 연결할 수 있습니다.
6. 전체 상태 확인
섹션 제목: “6. 전체 상태 확인”버전, 워크스페이스, 프로바이더/모델, 메모리 백엔드, 보안, 채널 등 전체 시스템 요약을 출력합니다:
revka status머신 판독 가능한 활성 프로브(Docker 헬스체크 용)는 종료 코드를 확인하세요:
revka status --format exit-code # 게이트웨이가 정상이면 0, 그렇지 않으면 1로 종료문제가 있어 보이면 구조화된 진단을 실행하세요:
revka doctor # config, workspace, daemon, environment, sidecars, kumiho, cli-toolsrevka self-test # gateway health + memory round-trip을 포함한 전체 테스트 스위트보고서를 읽는 방법은 진단을 참고하세요.