Hermes Agent 빠른 시작
기준일: 2026-07-26
문서 반영 버전: v2026.7.20
난이도: 초급
공식 기준: Hermes Agent Quickstart, Installation
설치가 끝났다면 첫 목표는 “모든 기능 켜기”가 아니라 “기본 대화가 안정적으로 되는지 확인하기”입니다. Hermes 공식 Quickstart도 base chat을 먼저 확인하고, gateway, cron, skills, voice, routing은 그 다음 단계로 나눕니다.
핵심 개념
빠른 시작은 여섯 단계로 나눕니다.
- 설치 확인:
hermes --help또는hermes version - Provider 선택:
hermes model또는hermes setup --portal - 기본 대화:
hermes또는hermes --tui - 세션 재개:
hermes --continue/hermes -c - 읽기 작업: 저장소 구조 요약 후 작은 쓰기 작업은 별도 승인
- 다음 레이어: gateway, skills, voice, MCP는 base chat이 된 뒤에만
처음부터 자동화나 게이트웨이를 켜기보다, 한 프로젝트에서 Hermes가 어떤 정보를 읽고 어떤 명령을 제안하는지 보는 편이 안전합니다.
setup 모드 (공식)
새 설치에서 hermes setup은 세 모드를 제공합니다.
| 모드 | 내용 |
|---|---|
| Quick Setup (Nous Portal) | OAuth 한 번으로 모델 + Tool Gateway(web search, image gen, TTS, browser) |
| Full Setup | provider·도구·옵션을 전부 직접 설정 |
| Blank Slate | provider/model + File Ops + Terminal만 켠 최소 구성. 나머지 toolset·압축·checkpoint·memory 등은 명시적으로 끈 상태 |
Blank Slate는 platform_toolsets.cli와 agent.disabled_toolsets를 명시적으로 쓰므로, 원하지 않은 기능이 hermes update 이후에도 조용히 켜지지 않습니다. 나중에 hermes tools, hermes skills opt-in --sync, hermes setup agent로 다시 켭니다.
최소 컨텍스트: 64K
Hermes Agent는 최소 64,000 tokens 컨텍스트 창을 요구합니다. 더 작은 로컬 모델은 멀티 스텝 도구 루프에 필요한 작업 메모리를 유지하지 못해 시작 시 거부됩니다. llama.cpp는 --ctx-size 65536, Ollama는 -c 65536 등으로 설정합니다.
선택 기준
| 첫 작업 | 추천 여부 | 이유 |
|---|---|---|
| 저장소 구조 요약 | 좋음 | 읽기 중심이고 위험이 낮음 |
| README 초안 작성 | 좋음 | 쓰기 전 결과를 검토 가능 |
| 의존성 업데이트 | 보류 | 네트워크/잠금 파일 변경 가능 |
| 대량 리팩터링 | 보류 | 경계와 테스트 전략이 먼저 필요 |
실습
1. Provider부터 고르기
공식 Quickstart 기준으로 가장 빠른 경로는 Nous Portal입니다.
hermes setup --portal
# 또는 이미 키가 있으면
hermes model
설정 저장 위치:
- 시크릿/토큰 →
~/.hermes/.env - 일반 설정 →
~/.hermes/config.yaml
hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
2. 첫 대화
cd /path/to/project
hermes # classic CLI
hermes --tui # modern TUI (권장)
첫 요청은 읽기 전용으로 둡니다.
이 저장소의 주요 디렉터리, 실행 명령, 테스트 명령을 찾아서 요약해줘.
파일을 수정하지 말고, 근거가 되는 파일 경로를 함께 적어줘.
성공 기준:
- 배너에 선택한 model/provider가 보인다
- 오류 없이 응답한다
- 필요하면 terminal/file 도구를 쓴다
- 한 턴 이상 대화가 이어진다
3. 세션 재개 확인
hermes --continue # 가장 최근 세션
hermes -c # 단축형
hermes sessions list
같은 profile에서 세션이 저장됐는지 확인합니다. 프로필을 바꾸면 이전 세션이 안 보일 수 있습니다.
4. 슬래시 명령 맛보기
| 명령 | 역할 |
|---|---|
/help |
사용 가능 명령 목록 |
/tools |
도구 목록 |
/model |
이미 구성한 모델 전환 |
/personality pirate |
세션 personality 실험 |
/save |
대화 저장 |
멀티라인: Alt+Enter, Ctrl+J, 또는 지원 터미널에서 Shift+Enter.
에이전트가 길면 새 메시지를 입력해 인터럽트하거나 Ctrl+C를 씁니다.
5. 다음 레이어 (base chat 이후)
hermes gateway setup # 메시징 봇
hermes tools # 플랫폼별 도구 범위
hermes skills browse # 스킬 허브
hermes config set terminal.backend docker
Voice extras (설치 경로 기준):
cd ~/.hermes/hermes-agent
uv pip install -e ".[voice]"
# CLI에서 /voice on , Ctrl+B 로 녹음
ACP 에디터 통합:
hermes acp
복구 순서
| 증상 | 원인 후보 | 조치 |
|---|---|---|
| 빈/깨진 응답 | provider auth·model 오류 | hermes model 재실행 |
| custom endpoint 이상 | base URL/model 이름 | 별도 클라이언트로 endpoint 검증 |
| gateway 무응답 | 토큰·allowlist | hermes gateway setup, hermes gateway status |
--continue 실패 |
profile·미저장 세션 | hermes sessions list |
| 설정 경고 | 누락/구식 config | hermes doctor → hermes config migrate |
권장 순서: hermes doctor → hermes model → hermes setup → hermes sessions list → hermes --continue → hermes gateway status.
Hermes에 입력할 프롬프트
지금은 온보딩 세션이야.
1. 저장소 구조를 읽고
2. 실행/검증 명령을 찾아
3. 위험도가 낮은 첫 작업을 하나만 추천해줘.
수정은 내가 명시적으로 요청하기 전까지 하지 마.
체크리스트
- 프로젝트 루트에서 Hermes를 실행했다.
-
hermes model또는hermes setup --portal로 provider를 설정했다. -
hermes또는hermes --tui로 정상 응답을 받았다. -
hermes --continue로 세션 재개를 확인했다. - 파일 수정 없는 저장소 요약을 받았다.
- 첫 쓰기 작업 전에 변경 범위를 분리했다.
- 위험한 명령은 승인 후 실행하도록 지시했다.