Hermes Agent가 뭔가요?
쉽게 말해, 터미널(검은 화면)에서 대화하면서 코드를 짜주는 AI 비서예요. ChatGPT처럼 대화하면 되는데, 여러분의 컴퓨터에서 직접 파일을 만들고, 코드를 실행하고, 웹을 검색하고, 이미지도 만들어줍니다. 게다가 무료이고 오픈소스예요!
🧠
18개 LLM 지원
OpenAI, Claude, Gemini, DeepSeek, Ollama 등 원하는 AI 모델을 골라 쓸 수 있어요
🔧
코드 자동 실행
파일 생성, 편집, 삭제, 터미널 명령까지 AI가 직접 실행해요
🌐
웹 검색 & 브라우저
인터넷 검색, 웹페이지 읽기, 브라우저 자동화까지 가능해요
🎨
이미지 생성
FLUX 기반 이미지 생성을 터미널에서 바로 할 수 있어요
💬
8개 메시징 연동
Telegram, Discord, Slack, WhatsApp 등에서 AI와 채팅할 수 있어요
🎤
음성 모드
마이크로 말하면 AI가 듣고 대답해요. 음성 응답도 가능!
시작하기 전에 준비할 것
딱 하나만 있으면 돼요: 컴퓨터에
git이 설치되어 있으면 됩니다. 나머지는 설치 스크립트가 알아서 해줘요! 터미널에서 git --version을 입력해서 확인해보세요. 숫자가 나오면 준비 완료!CHAPTER 01
🟢 쉬움⏱ 약 2분빠른 시작 (2분 완성)
설치부터 첫 대화까지 단 2분! 복잡한 건 나중에 — 일단 돌려보는 게 최고예요.
1
2
3
4
CHAPTER 02
🟢 쉬움⏱ 약 3분LLM 프로바이더 설정
Hermes는 무려 18개의 AI 서비스를 지원해요. 내 상황에 맞는 걸 골라보세요!
프로바이더가 뭐예요?
AI 모델을 제공하는 서비스 업체를 말해요. 예를 들어 ChatGPT를 만든 OpenAI, Claude를 만든 Anthropic 같은 회사들이에요. 각 프로바이더마다 다른 AI 모델을 제공하고, 가격도 달라요.
$hermes model
아래 표에서 지원하는 모든 프로바이더를 확인할 수 있어요.
환경변수가 뭐예요?
컴퓨터에 저장하는 비밀 메모 같은 거예요.
hermes model 명령어를 쓰면 자동으로 설정해주니까, 아래 표는 참고만 하세요!| 프로바이더 | 환경변수 | 특징 |
|---|---|---|
| OpenRouter | OPENROUTER_API_KEY | 다양한 모델을 하나의 키로 (추천!) |
| OpenAI | OPENAI_API_KEY | GPT-4o, o1, o3 시리즈 |
| Anthropic | ANTHROPIC_API_KEY | Claude 3.5/4 시리즈 |
| Google AI Studio | GOOGLE_AI_STUDIO_API_KEY | Gemini 시리즈 (v0.8.0 신규!) |
| DeepSeek | DEEPSEEK_API_KEY | 가성비 좋은 중국 AI 모델 |
| Ollama | (로컬 실행) | 무료! 내 컴퓨터에서 직접 실행 |
| LM Studio | (로컬 실행) | GUI로 로컬 모델 관리 |
| Groq | GROQ_API_KEY | 초고속 추론 (무료 티어 있음) |
| Mistral | MISTRAL_API_KEY | 유럽 오픈소스 AI |
| xAI (Grok) | XAI_API_KEY | 일론 머스크의 AI |
| Codex (OpenAI) | OPENAI_API_KEY | 코드 특화 모델 |
| Z.AI | ZAI_API_KEY | 중국 AI 서비스 |
| Kimi (Moonshot) | KIMI_API_KEY | 긴 컨텍스트 특화 |
| MiniMax | MINIMAX_API_KEY | 멀티모달 AI |
| Alibaba Cloud | ALIBABA_API_KEY | Qwen 시리즈 |
| Together AI | TOGETHER_API_KEY | 오픈소스 모델 호스팅 |
| OpenAI 호환 | (커스텀 URL) | vLLM, llama.cpp 등 호환 서버 |
| Vertex AI | GOOGLE_APPLICATION_CREDENTIALS | Google Cloud 엔터프라이즈 |
최소 요구사항
어떤 모델을 쓰든 최소 64,000 토큰 컨텍스트가 필요해요. 대부분의 클라우드 모델(Claude, GPT, Gemini 등)은 이미 충족하지만, 로컬 모델(Ollama 등)을 쓸 때는 컨텍스트 크기를 64K 이상으로 설정해주세요.
토큰이 뭐예요?
토큰은 AI가 한 번에 읽고 기억할 수 있는 텍스트의 양을 세는 단위예요. 64K 토큰은 책 약 50페이지 분량이에요. 클라우드 모델(OpenRouter, OpenAI 등)을 쓴다면 이미 충족하니 신경 쓸 필요 없어요!
터미널 백엔드 (코드 실행 환경)
Hermes가 코드를 실행하는 환경을 선택할 수 있어요. 기본값은 로컬(내 컴퓨터)이고, 보안이 걱정되면 Docker나 클라우드 샌드박스를 쓸 수 있어요.
| 백엔드 | 설명 |
|---|---|
| Local (기본) | 내 컴퓨터에서 직접 실행. 가장 빠르고 간단! |
| Docker | 격리된 컨테이너에서 실행. 보안 걱정 없음 |
| E2B | 클라우드 샌드박스. 내 컴퓨터 자원 안 씀 |
| Modal | 서버리스 클라우드 실행 |
| Daytona | 클라우드 개발 환경 (v0.8.0 신규) |
| Singularity | HPC/연구용 컨테이너 (v0.8.0 신규) |
CHAPTER 03
🟢 쉬움⏱ 읽기 약 7분주요 단축명령어 (CLI + 슬래시 명령)
CLI와 대화 내 슬래시 명령을 한데 정리한 빠른 참조(cheat sheet)입니다. v0.9.0 기준.
프로필 관리
FAQ 다매질문❗업무용/개인용/테스트용 등 여러 프로필을 만들어 상황별로 전환할 수 있어요. 세팅이나 메모리를 완전히 분리할 수 있어서 매우 유용해요!
프로필 생성이 제일 많이 묻는 질문이에요! 🙋
hermes profile create <이름> --clone 으로 현재 프로필을 복사해서 새 프로필을 만들어요!스크래치에서 만들면 모델과 API 키를 다시 설정해야 하니까
--clone 옵션을 적극 활용하세요!👉새 프로필 만들기 (자주 묻는 질문!)
# 현재 프로필 설정만 복사해서 새 프로필 생성 (추천!)
$hermes profile create work --clone
# 완전 빈 슬레이트로 새 프로필 생성
$hermes profile create personal
# 설정+메모리+스킬+세션 모두 복사
$hermes profile create backup --clone-all
# 특정 프로필에서 클론
$hermes profile create new-profile --clone-from work
프로필 명령어 전체 목록
| 명령어 | 설명 |
|---|---|
hermes profile list | 모든 프로필 목록 보기 |
hermes profile create <이름> | 빈 새 프로필 생성 |
hermes profile create <이름> --clone | 현재 프로필 설정 복사해서 생성 (추천) |
hermes profile create <이름> --clone-all | 설정+메모리+스킬+세션 모두 복사 |
hermes profile create <이름> --clone-from <원본> | 특정 프로필에서 클론 |
hermes profile use <이름> | 해당 프로필로 전환 (기본 활성화) |
hermes profile show <이름> | 프로필 상세 정보 보기 |
hermes profile rename <구> <신> | 프로필 이름 변경 |
hermes profile export <이름> | 프로필을 tar.gz로 내보내기 (백업) |
hermes profile import <파일.tar.gz> | 아카이브에서 프로필 가져오기 |
hermes profile delete <이름> | 프로필 삭제 |
hermes profile alias | 프로필 전환용 shell alias 재생성 |
프로필이 왜 필요한가요?
하나의 Hermes로 업무용 AI와 개인용 AI를 완전히 분리할 수 있어요. 예를 들어 업무 프로필에는 회사 정보를, 개인 프로필에는 개인 정보를 넣어두면 서로 섯지 않아요!
핵심 10개만 기억하면 끝!
실무에서는 이 정도만 잘 써도 대부분 커버됩니다:
hermes— 대화 시작hermes setup— 한 번에 설정 끝내기hermes model— 모델 / 프로바이더 변경/help— 명령어 전체 보기/new또는/reset— 새 세션/tools— 도구 켜기/끄기/skills— 스킬 검색·설치/compress— 컨텍스트 압축 (토큰 절약)/fast— Fast Mode로 저지연 대화hermes dashboard— 웹 대시보드 시작
1. 기본 CLI 명령어 (터미널 레벨)
터미널에서 hermes 뒤에 이런 명령어들을 붙여 쓸 수 있어요.
| 명령어 | 의미 / 사용처 |
|---|---|
hermes | 대화 시작 (인터랙티브 CLI/TUI) |
hermes setup | 전체 설정 마법사 (모델·도구·게이트웨이 한 번에) |
hermes model | LLM 프로바이더 & 모델 선택/변경 |
hermes tools | 플랫폼별 사용 도구 켜기/끄기 설정 |
hermes doctor | 환경/설치 문제 진단 |
hermes update | 최신 버전으로 업데이트 |
hermes gateway | 메시징 게이트웨이 (Telegram, Discord 등) 시작 |
hermes --continue / hermes -c | 마지막 세션 이어하기 |
hermes dashboard | 로컬 웹 대시보드 시작 |
hermes skills search <keyword> | 스킬 검색 (예: hermes skills search kubernetes) |
hermes skills install <skill-name> | 스킬 설치 |
hermes chat /fast | Fast Mode에서 대화 시작 (OpenAI·Anthropic 저지연) |
2. 슬래시 명령어 (대화 내부)
Hermes와 대화하는 중에 /로 시작하는 특수 명령어를 쓸 수 있어요. 전체 목록은 /help로 확인할 수 있습니다.
2.1 세션 관리
| 명령어 | 별칭 | 설명 |
|---|---|---|
/new | /reset | 새 세션 시작 (새 session ID + 히스토리) |
/clear | — | 화면 지우고 새 세션 시작 |
/retry | — | 마지막 사용자 메시지 다시 보내기 |
/undo | — | 마지막 user/assistant 교환 제거 |
/title [name] | — | 현재 세션에 제목 주기 |
/compress | — | 대화 컨텍스트 수동 압축 (토큰 절약) |
/rollback [number] | — | 파일시스템 체크포인트 목록/복원 |
/stop | — | 실행 중인 모든 백그라운드 프로세스 종료 |
/background <prompt> | /bg | 프롬프트 백그라운드 실행 (대화 중단 안 함) |
/resume [name] | — | 이전 세션 이름으로 이어하기 |
/history | — | 대화 히스토리 표시 |
/save | — | 현재 대화 저장 |
2.2 모델·플랫폼·설정
| 명령어 | 설명 |
|---|---|
/model [provider:model] | 현재 모델 표시 / 대화 중 모델 전환 |
/provider | 사용 가능한 프로바이더 및 현재 프로바이더 표시 |
/personality [name] | 사전 정의된 페르소나 적용 (예: /personality pirate) |
/skin [name] | 디스플레이 스킨/테마 변경 (예: /skin ares, /skin mono) |
/voice [on|off|tts|status] | 보이스 모드 켜기/끄기, TTS 소스 설정 |
/reasoning [level|show|hide] | Reasoning 노력/표시 관리 |
/prompt [text] | 커스텀 시스템 프롬프트 보기/설정 |
/verbose | 도구 진행 메시지 수준 사이클 (off → new → all → verbose) |
/statusbar (/sb) | 컨텍스트/모델 상태표시줄 켜기/끄기 |
/config | 현재 설정 요약 표시 |
2.3 도구·스킬·크론 등 에이전트 기능
| 명령어 | 설명 |
|---|---|
/tools [list|disable|enable] [name...] | 도구 목록 / 켜기 / 끄기 관리 |
/toolsets | 사용 가능한 툴세트 목록 |
/skills [search|browse|inspect|install] | 스킬 검색·탐색·점검·설치 등 |
/cron [subcommand] | 예정 작업 (크론) 관리 |
/browser [connect|disconnect|status] | 브라우저 도구 (CDP) 연결/해제/상태 확인 |
/reload-mcp | 설정에서 MCP 서버 다시 로드 |
/plugins | 설치된 플러그인 목록 및 상태 표시 |
/fast | Fast Mode 활성화 (OpenAI·Anthropic 우선순위 큐·저지연 처리) |
2.4 정보·확인 & 종료
| 명령어 | 설명 |
|---|---|
/help | 사용 가능한 명령어 전체 표시 |
/usage | 현재 세션의 토큰 사용량 표시 |
/insights [days] | 사용 인사이트 & 분석 표시 (최근 N일) |
/platforms (/gateway) | 게이트웨이 / 메시징 플랫폼 상태 표시 |
/paste | 클립보드 이미지 체크 및 첨부 |
/quit (/exit, /q) | CLI 종료 |
3. 자주 쓰는 키보드 단축키 (TUI)
Hermes는 prompt_toolkit 기반 TUI를 사용합니다.
| 키 | 동작 |
|---|---|
Enter | 메시지 보내기 |
Meta+Enter (또는 Esc → Enter) | 새 줄 추가 (멀티라인 입력) |
Ctrl+C | 실행 중인 에이전트 턴 중단 |
Tab | 슬래시 명령·서브 명령어 자동 완성 |
↑ / ↓ | 입력 히스토리 위/아래로 이동 |
Ctrl+L | 화면 지우기 |
스킬 시스템
Hermes는 경험에서 스킬을 자동으로 배우고, 커뮤니티가 만든 스킬도 설치할 수 있어요. 마치 앱스토어처럼요!
# 스킬 검색하기
$hermes skills search kubernetes
# 스킬 설치하기
$hermes skills install openai/skills/k8s
# 대화 중 스킬 관리
$/skills
🎤 음성 모드
키보드 대신 말로 AI와 대화할 수 있어요! Ctrl+B로 녹음하고, AI가 음성으로 대답하게 할 수도 있습니다.
# 음성 기능 설치
$pip install "hermes-agent[voice]"
# 선택: 무료 로컬 음성인식
$pip install faster-whisper
# 대화 중 음성 켜기
$/voice on
# Ctrl+B로 녹음, /voice tts로 음성 응답
ACP 에디터 통합
VS Code, Zed, JetBrains 같은 코드 에디터에서 Hermes를 바로 사용할 수 있어요.
$pip install -e '.[acp]'
$hermes acp
MCP 통합 (외부 도구 연결)
Model Context Protocol로 GitHub, Slack, 데이터베이스 등 외부 도구를 연결할 수 있어요. v0.8.0에서 OAuth 2.1 PKCE 인증과 보안 스캐닝이 추가됐어요!
# ~/.hermes/config.yaml에 추가
mcp_servers:
github:
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: ghp_xxx
세션 이어하기
대화를 중간에 끊었다가 나중에 이어서 할 수 있어요. 마치 게임 세이브처럼!
# 가장 최근 세션 이어하기
$hermes --continue
# 단축형
$hermes -c
CHAPTER 🌐
⏱ 읽기 약 3분Web UI 가이드
터미널이 어렵다면? 브라우저에서 바로 쓰는 Hermes Agent Web UI를 소개해요!
초보자라면 Web UI 강추! 🎉
CLI(터미널)가 낯설다면 Web UI부터 시작하세요! 브라우저에서 채팅하듯 Hermes Agent를 사용할 수 있어요. 영끌맨도 처음엔 Web UI로 시작했답니다 ㅎㅎ
1. Hermes WebUI
추천가장 활발하게 업데이트되는 경량 웹 인터페이스예요. CLI와 완전히 동일한 기능을 브라우저에서 사용할 수 있고, 모바일에서도 잘 돼요!
✅CLI와 100% 기능 동등
📱모바일 완전 지원
🌙다크 테마 기본 제공
⚡경량 & 빠른 로딩
최신 버전: v0.50.45 (2026.04.14) · ⭐ 1,953 · 포크 203개
2. Hermes Workspace
고급채팅 + 터미널 + 메모리 + 스킬 마켓을 하나로 통합한 올인원 워크스페이스예요. 더 많은 기능이 필요한 분들께 추천해요!
💻풀 PTY 터미널 내장
🧠메모리 브라우저/편집
🛒2,000+ 스킬 마켓
🎙️음성 입력 지원
🌈8가지 테마 지원
📡실시간 SSE 스트리밍
최신 버전: v1.0.0 (2026.04.10) · ⭐ 1,367 · 포크 157개
어떤 걸 선택할까요?
| 구분 | Hermes WebUI ⭐추천 | Hermes Workspace |
|---|---|---|
| 대상 | 처음 시작하는 분 | 고급 사용자 |
| 난이도 | ⭐ 쉬움 | ⭐⭐⭐ 보통 |
| 터미널 내장 | ❌ | ✅ |
| 스킬 마켓 | ❌ | ✅ 2,000+ |
| 모바일 | ✅ | ✅ (PWA) |
| 테마 | 다크 기본 | 8가지 |
| 업데이트 | 매우 활발 | 활발 |
CHAPTER 04
🟡 보통⏱ 약 5분메시징 플랫폼 연결
스마트폰에서도 AI와 채팅하고 싶다면? Telegram, Discord 등 다양한 앱에서 Hermes를 사용할 수 있어요!
초보자에게는 Telegram을 추천해요!
8개 플랫폼 중 텔레그램(Telegram)이 가장 쉽습니다. BotFather에게 메시지 몇 개만 보내면 봇이 만들어지고, 토큰 복사 → 설정 끝! 별도 서버나 개발자 계정 없이 5분이면 완료돼요.
이건 꼭 해야 하나요?
아니요! 터미널에서만 쓸 거라면 이 단계는 건너뛰어도 돼요. 하지만 스마트폰에서 AI와 채팅하고 싶다면 꼭 설정해보세요. 서버에서 Hermes를 실행해두면 어디서든 접속할 수 있어요!
1
2
3
CHAPTER 05
🟢 쉬움⏱ 약 2분OpenClaw 마이그레이션
기존에 OpenClaw를 쓰고 계셨나요? 설정, 메모리, 스킬을 자동으로 가져올 수 있어요!
OpenClaw를 안 써봤다면?
이 챕터는 건너뛰세요! OpenClaw는 Hermes Agent의 이전 버전이에요. 처음 사용하시는 분은 마이그레이션할 게 없으니 다음 챕터로 넘어가세요.
자동 감지
처음 설치할 때
hermes setup이 ~/.openclaw 폴더를 자동으로 찾아서 마이그레이션을 제안해줘요.1
2
CHAPTER 06
🟢 쉬움⏱ 필요할 때 참고트러블슈팅
뭔가 안 될 때 당황하지 마세요! 자주 나오는 문제와 해결법을 모아뒀어요.
일단 이것부터 해보세요!
대부분의 문제는
hermes doctor 명령어로 진단할 수 있어요. 뭐가 문제인지, 어떻게 고쳐야 하는지 친절하게 알려줍니다!더 도움이 필요하다면?
CHAPTER 07
🟡 보통⏱ 약 10분Windows 사용자 WSL 설치 가이드
윈도우에서 Hermes Agent를 쓰고 싶다면? WSL2만 설치하면 리눅스와 똑같이 동작해요. 스크린샷과 함께 따라하면 10분 안에 완료!
WSL2가 뛰예요?
Windows Subsystem for Linux 2의 줄임말이에요. 윈도우 안에 리눅스를 실행할 수 있는 마이크로소프트 공식 기능이에요. 마치 윈도우 안에 작은 리눅스 컴퓨터를 다는 것처럼 생각하면 돼요! 따로 리눅스 컴퓨터가 없어도 되고, 윈도우 앱들도 계속 쓸 수 있어요.
사전 준비사항
Windows 10 버전 2004 이상 또는 Windows 11이 필요해요. Windows 업데이트를 먼저 실행해서 최신 버전으로 유지하는 것을 추천해요. 시작 전 PowerShell을 새로 열어두세요 (시작 메뉴에서 “PowerShell” 검색 후 오른쪽 클릭 → 관리자로 실행).
1
2
3
4
5
Windows 사용자 추가 팁
- Windows Terminal 앱 설치 추천 — 탭으로 Ubuntu와 PowerShell을 동시에 열 수 있어요.
- VS Code + WSL 확장 설치하면 Windows에서 WSL 파일을 직접 편집할 수 있어요.
- WSL 터미널에서
explorer.exe .를 입력하면 Windows 파일 탐색기로 현재 폴더를 열 수 있어요. - 윈도우 파일은 WSL에서
/mnt/c/경로로 접근할 수 있어요 (C: 드라이브).
CHAPTER 08
업데이트
Hermes Agent의 최신 변경사항을 확인하세요.
전체 릴리스 노트
자세한 변경사항은 GitHub Releases ↗에서 확인할 수 있어요.