H Hermes 튜토리얼
Web Dashboard

Hermes 대시보드 사용하기

대시보드는 Hermes를 브라우저에서 확인하고 관리하는 화면입니다. 터미널 명령어를 계속 입력하지 않아도 상태, 채팅, API Key, 세션, 로그, 프로필을 한곳에서 볼 수 있습니다.

초보자라면 처음에는 Status, Chat, API Keys, Sessions, Logs만 보면 충분합니다. Config나 MCP처럼 복잡한 메뉴는 익숙해진 뒤 천천히 보세요.

1. 대시보드 열기

아래 명령어를 터미널에 입력하세요. 공식 문서 기준으로 대시보드는 내 Mac 안에서 로컬 서버를 열고, 브라우저에서 http://127.0.0.1:9119 주소로 접속합니다.

Dashboard
hermes dashboard
1브라우저가 자동으로 열리는지 확인합니다.
2주소창에 http://127.0.0.1:9119가 보이면 정상입니다.
3왼쪽 메뉴와 Status 화면이 보이면 대시보드가 실행된 것입니다.

주소의 127.0.0.1은 “내 컴퓨터 안에서만 열리는 주소”라는 뜻입니다. 다른 사람에게 공개되는 웹사이트가 아니므로 처음 배울 때는 이 기본값을 그대로 쓰는 것이 안전합니다.

안 열릴 때

대시보드용 추가 패키지가 없다는 안내가 나오면 아래 명령어를 입력한 뒤 다시 hermes dashboard를 실행하세요.

Dashboard extras
pip install 'hermes-agent[web,pty]'

이미 다른 프로그램이 9119 포트를 쓰고 있다면 공식 문서의 옵션처럼 포트를 바꿀 수 있습니다.

Custom port
hermes dashboard --port 8080

2. 왼쪽 메뉴 읽는 법

공식 Web Dashboard 문서는 대시보드를 Hermes 설치 상태를 관리하는 브라우저 UI로 설명합니다. 처음에는 모든 메뉴를 외우지 말고, 아래처럼 “무엇을 확인하는 화면인지”만 잡으면 됩니다.

StatusHermes 버전, Gateway 실행 여부, 최근 세션을 봅니다. 문제가 생기면 제일 먼저 여기를 확인하세요.
Chat브라우저 안에서 Hermes와 대화합니다. 터미널 TUI가 낯설다면 여기서 짧은 질문으로 연결을 확인하세요.
API KeysOpenAI, Anthropic, OpenRouter 같은 모델 provider 키가 들어갔는지 봅니다. 키는 비밀번호처럼 다룹니다.
Sessions이전에 나눈 대화와 tool call 기록을 다시 봅니다. “Hermes가 뭘 했지?” 싶을 때 여기를 엽니다.
Logsagent, gateway, error 로그를 봅니다. Telegram, Kanban, worker가 멈춘 것 같을 때 단서가 있습니다.
Profiles역할별 Hermes 프로필을 만들고 관리합니다. Kanban assignee와 연결되는 중요한 메뉴입니다.
SkillsHermes가 사용할 수 있는 스킬과 toolset을 켜고 끕니다. 변경은 다음 세션부터 적용될 수 있습니다.
Kanban작업 카드를 보드 형태로 봅니다. 카드가 어느 상태인지, 담당 프로필이 누구인지 확인합니다.
ConfigHermes 설정을 폼으로 고칩니다. 초보자는 필요한 경우에만 바꾸고, 잘 모르겠으면 기본값을 유지하세요.

3. 처음 켰을 때 확인 순서

잘 모르겠으면 아래 순서대로만 보세요. 대시보드를 “관리자 화면”처럼 한 번에 다 이해하려고 하지 않아도 됩니다.

  1. Status에서 Hermes와 Gateway 상태를 확인합니다.
  2. API Keys에서 내가 쓰려는 모델 provider 키가 설정되어 있는지 봅니다.
  3. Chat에서 “안녕, 짧게 자기소개해줘”처럼 간단한 질문을 해봅니다.
  4. Sessions에서 방금 대화가 기록으로 남았는지 확인합니다.
  5. Telegram이나 Kanban이 안 움직이면 Logs에서 error나 warning을 찾습니다.

초보자 체크

4. 자주 헷갈리는 상황

대시보드를 닫으면 Hermes도 꺼지나요?

브라우저 탭만 닫는 것과 대시보드 서버를 종료하는 것은 다릅니다. 터미널에서 실행 중인 hermes dashboard 프로세스를 종료해야 서버가 멈춥니다.

API Key를 대시보드에 넣어도 안전한가요?

공식 문서 기준 대시보드는 로컬 주소에서 실행됩니다. 그래도 API Key는 결제와 연결될 수 있으니 화면 공유, 스크린샷, 공개 저장소에 노출하지 마세요.

여러 프로필을 만들면 어디서 바꾸나요?

공식 문서는 대시보드 사이드바의 profile switcher가 Config, API Keys, Skills, Models, Chat 같은 관리 화면의 대상을 정한다고 설명합니다. 다른 프로필을 고친다고 생각되면 상단이나 사이드바의 선택 상태를 먼저 확인하세요.