hermes-desktop

이 프로젝트는 활발히 개발 중입니다. 기능이 변경될 수 있으며 일부가 깨질 수 있습니다. 문제가 발생하거나 아이디어가 있으면 이슈를 열어주세요. 기여를 환영합니다!

Hermes One은 Hermes Agent를 설치, 구성하고 대화할 수 있는 커뮤니티 유지 관리 네이티브 데스크톱 앱입니다. Hermes Agent는 도구 사용, 멀티 플랫폼 메시징, 폐쇄형 학습 루프를 갖춘 자기 개선 AI 어시스턴트입니다.

CLI를 직접 관리하는 대신, 이 앱은 설치, 프로바이더 설정, 일상적 사용을 한 곳에서 안내합니다. 공식 Hermes 설치 스크립트를 사용하고, Hermes를 ~/.hermes에 저장하며, 채팅, 세션, 프로필, 메모리, 스킬, 도구, 스케줄링, 메시징 게이트웨이 등을 위한 GUI를 제공합니다.

스폰서

여기에 표시되고 싶으신가요?

클릭하여 접기

Greptile은 AI 코드 리뷰어입니다. 코드베이스의 전체 컨텍스트를 바탕으로 풀 리퀘스트를 리뷰하고 테스트합니다. 버그를 잡아내고, 회귀를 표시하며, 모든 PR에 자동으로 인라인 리뷰 코멘트를 남깁니다.

설치

hermesone.org 또는 GitHub Releases에서 운영체제에 맞는 데스크톱 앱을 다운로드하세요. npm install hermes-desktop은 지원되는 데스크톱 앱 설치 방법이 아닙니다.

개발 환경에서 앱을 실행하려면 이 저장소를 클론하고 기여 가이드를 따르세요. npm install 단계는 소스 체크아웃 내부에 의존성을 설치합니다.

Windows

Windows 사용자: 설치 프로그램은 코드 서명되지 않았습니다. Windows SmartScreen이 첫 실행 시 경고합니다 — "추가 정보" → "실행"을 클릭하세요.

WSL 사용자: 설치 프로그램이 Switching to root user to install dependencies... 에서 멈춘다면, Playwright가 읽을 TTY가 없는 sudo 비밀번호를 기다리고 있는 것입니다. 설치에 대해 비밀번호 없는 sudo를 허용한 후 완료되면 되돌리세요:

echo " $USER ALL=(ALL) NOPASSWD: ALL " | sudo tee /etc/sudoers.d/hermes-install
# …설치 프로그램을 다시 실행하세요; 완료되면:
sudo rm /etc/sudoers.d/hermes-install
#109에서 추적 중입니다.

Fedora (RPM)

sudo dnf install ./hermes-desktop- < version > .rpm

Fedora 사용자: .rpm은 GPG 서명되지 않았습니다. 시스템이 서명 검사를 강제하는 경우 설치 명령에 --nogpgcheck를 추가하세요. .rpm 빌드에는 자동 업데이트가 지원되지 않습니다(electron-updater의 한계). 업데이트하려면 새 .rpm을 재설치하세요.

미리보기

채팅

프로필

모델

프로바이더

도구

디스커버

스케줄

게이트웨이

페르소나

칸반

오피스

설정

기능

진행 상황 추적 및 의존성 해결을 포함한 Hermes Agent용 안내식 최초 실행 설치
로컬 또는 원격 백엔드 — Hermes를 127.0.0.1:8642에서 로컬로 실행하거나, URL + API 키로 데스크톱 앱을 원격 Hermes API 서버에 연결
멀티 프로바이더 지원 — OpenRouter, Anthropic, OpenAI, Google (Gemini), xAI (Grok), Nous Portal, Qwen, MiniMax, Hugging Face, Groq, 그리고 로컬 OpenAI 호환 엔드포인트(LM Studio, Atomic Chat, Ollama, vLLM, llama.cpp)
SSE 스트리밍, 도구 진행 표시기, 마크다운 렌더링, 구문 강조를 갖춘 스트리밍 채팅 UI
토큰 사용량 추적 — 채팅 푸터에 실시간 프롬프트/완료 토큰 수와 비용 표시, 그리고 /usage 슬래시 명령
22개 슬래시 명령 — /new, /clear, /fast, /web, /image, /browse, /code, /shell, /usage, /help, /tools, /skills, /model, /memory, /persona, /version, /compact, /compress, /undo, /retry, /debug, /status 등
세션 관리 — 전체 텍스트 검색(SQLite FTS5), 날짜별 그룹화된 기록, 대화 재개 및 검색
프로필 전환 — 격리된 구성으로 별도의 Hermes 환경을 생성, 삭제, 전환
14개 도구 세트 — 웹, 브라우저, 터미널, 파일, 코드 실행, 비전, 이미지 생성, TTS, 스킬, 메모리, 세션 검색, 명확화, 위임, MoA, 작업 계획
메모리 시스템 — 메모리 항목 보기/편집, 사용자 프로필 메모리, 용량 추적, 검색 가능한 메모리 프로바이더(Honcho, Hindsight, Mem0, RetainDB, Supermemory, ByteRover)
페르소나 편집기 — 에이전트의 SOUL.md 성격 편집 및 초기화
저장된 모델 — 프로바이더 전반에 걸친 모델 구성의 CRUD 관리
예약 작업 — 15개 전달 대상이 있는 cron 작업 빌더(분, 시간, 일, 주, 사용자 지정 cron)
16개 메시징 게이트웨이 — Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost, Email (IMAP/SMTP), SMS (Twilio/Vonage), iMessage (BlueBubbles), DingTalk, Feishu/Lark, WeCom, WeChat (iLink Bot), Webhooks, Home Assistant
Hermes Office (Claw3d) — 개발 서버 및 어댑터 관리를 갖춘 시각적 3D 인터페이스
백업, 가져오기 및 디버그 덤프 — 설정에서 전체 데이터 백업/복원 및 시스템 진단
로그 뷰어 — 설정 화면에서 직접 게이트웨이 및 에이전트 로그 보기
자동 업데이터 — electron-updater를 통한 업데이트 확인 및 설치
i18n 준비 완료 — 모든 화면을 포함하는 영어 로케일이 있는 국제화 프레임워크, 커뮤니티 번역 준비 완료
테스트 스위트 — Vitest를 통한 SSE 파서, IPC 핸들러, preload API 표면, 설치 프로그램 유틸리티, 상수 검증

작동 방식
최초 실행 시 앱은:

Hermes를 로컬로 실행할지 원격 Hermes API 서버에 연결할지 묻습니다.
로컬 모드: Hermes가 이미 ~/.hermes에 설치되어 있는지 확인하고, 그렇지 않으면 의존성 해결(Git, uv, Python 3.11+)과 함께 공식 Hermes 설치 프로그램을 실행합니다.
원격 모드: 원격 API URL과 API 키를 요청하고, 연결을 검증하며, 로컬 설치를 건너뜁니다.
API 프로바이더 또는 로컬 모델 엔드포인트를 요청합니다.
Hermes 구성 파일을 통해 프로바이더 구성과 API 키를 저장합니다.
설정이 완료되면 메인 워크스페이스를 실행합니다.

로컬 모드에서 채팅 요청은 SSE 스트리밍과 함께 http://127.0.0.1:8642를 통해 이루어집니다. 원격 모드에서는 앱이 동일한 스트리밍 프로토콜로 구성된 원격 URL과 통신합니다. 데스크톱 앱은 스트림을 실시간으로 파싱하여 도구 진행 상황, 마크다운 콘텐츠, 토큰 사용량을 도착하는 대로 렌더링합니다.

화면

화면
설명

채팅
슬래시 명령, 도구 진행 상황, 토큰 추적을 갖춘 스트리밍 대화 UI

세션
과거 대화 탐색, 검색, 재개

에이전트
Hermes 프로필 생성, 삭제, 전환

스킬
번들 및 설치된 스킬 탐색, 설치, 관리

모델
프로바이더별 저장된 모델 구성 관리

메모리
메모리 항목 보기/편집, 사용자 프로필, 메모리 프로바이더 구성

Soul
활성 프로필의 페르소나(SOUL.md) 편집

도구
개별 도구 세트 활성화 또는 비활성화

스케줄
전달 대상이 있는 cron 작업 생성 및 관리

게이트웨이
메시징 플랫폼 통합 구성 및 제어

오피스
Claw3d 시각적 인터페이스 설정 및 관리

설정
프로바이더 구성, 자격 증명 풀, 백업/가져오기, 로그 뷰어, 네트워크 설정, 테마

지원 프로바이더
스폰서

프로바이더
비고

Atlas Cloud
OpenAI 호환 게이트웨이 — DeepSeek, Qwen, GLM, Kimi, MiniMax 등 ( atlascloud.ai )

LLM 프로바이더

프로바이더
비고

OpenRouter
단일 API를 통한 200개 이상의 모델 (권장)

Anthropic
Claude 직접 액세스

OpenAI
GPT 직접 액세스

Google (Gemini)
Google AI Studio

xAI (Grok)
Grok 모델

Nous Portal
무료 티어 제공

Qwen
QwenAI 모델

MiniMax
글로벌 및 중국 엔드포인트

Hugging Face
HF Inference를 통한 20개 이상의 오픈 모델

Groq
빠른 추론 (음성/STT)

로컬/사용자 지정
모든 OpenAI 호환 엔드포인트

LM Studio, Atomic Chat, Ollama, vLLM, llama.cpp용 로컬 프리셋이 포함되어 있습니다.

메시징 플랫폼
Telegram, Discord, Slack, WhatsApp, Signal, Matrix/Element, Mattermost, Email (IMAP/SMTP), SMS (Twilio & Vonage), iMessage (BlueBubbles), DingTalk, Feishu/Lark, WeCom, WeChat (iLink Bot), Webhooks, Home Assistant.

도구 통합
Exa Search, Parallel API, Tavily, Firecrawl, FAL.ai (이미지 생성), Honcho, Browserbase, Weights & Biases, Tinker.

최초 설정
앱을 처음 열면 기존 Hermes 설치를 감지하거나 설치를 제안합니다.

UI에서 지원되는 설정 경로:

OpenRouter
Anthropic
OpenAI
OpenAI 호환 기본 URL을 통한 로컬 LLM

로컬 프리셋 포함:

LM Studio
Atomic Chat
Ollama
vLLM
llama.cpp

Hermes 파일은 다음에서 관리됩니다:

~/.hermes
~/.hermes/.env
~/.hermes/config.yaml
~/.hermes/hermes-agent
~/.hermes/profiles/ — 명명된 프로필 디렉터리
~/.hermes/state.db — 세션 기록 데이터베이스
~/.hermes/cron/jobs.json — 예약 작업

시크릿 프로바이더
기본적으로 API 키는 ~/.hermes/.env(env 프로바이더)에 있습니다. 별도의
구성이 필요하지 않습니다 — 이는 기존 동작과 바이트 단위로 동일하며,
사용자에게 아무것도 바뀌지 않습니다.

키를 평문 .env에 보관하고 싶지 않다면, 선택적 command
프로바이더가 구성한 헬퍼 명령을 실행하여 키를 해석합니다. 모든 곳에서의 해석
순서는: process.env → .env → provider → unset입니다.

키별 헬퍼(요청된 키 이름은 $HERMES_SECRET_KEY로 전달됨):

# ~/.hermes/config.yaml
secrets :
provider : command
command : secret-tool lookup hermes "$HERMES_SECRET_KEY"
또는 dotenv 블롭을 덤프하는 헬퍼(예: tmpfs로 언실되는 볼트):

secrets :
provider : command
command : " cat /run/user/1000/hermes-secrets.env "
헬퍼의 stdout은 단일 순수 값(키별 헬퍼) 또는
KEY=VALUE 줄(dotenv 덤프)일 수 있으며, 두 형태 모두 자동 감지됩니다.

볼트 / 시크릿 매니저 통합 (TPM 불필요)
command 프로바이더는 볼트에 구애받지 않습니다 — 구성한 헬퍼를 실행하고
그 stdout을 읽습니다. 헬퍼만이 시크릿 저장소와 통신하면 됩니다.
TPM으로 봉인된 키파일이 없다면, 다음 중 어느 것이든 Hermes에 대한 코드 변경 없이 작동합니다:

KeePassXC (비밀번호 전용 DB, 키파일 없음): secrets.command를
keepassxc-cli ls ~/secrets/hermes.kdbx <<<"$KPXC_PASSWORD"를 실행하고
관련 그룹을 dotenv로 덤프하는 작은 kpxc-export.sh 스크립트로 지정합니다.
세션당 한 번 마스터 비밀번호를 사용자에게 요청합니다.
패스프레이즈 전용 키가 있는 GnuPG: gpg --batch --passphrase-fd 0 --decrypt ~/.keys/api-keys.gpg가 command 값으로 직접 작동합니다.
패스프레이즈는 파일 디스크립터나 환경 변수로 전달하고, 절대 argv로 전달하지 마세요.
pass (표준 유닉스 비밀번호 관리자):
키별 헬퍼의 경우 command: "pass show hermes/$HERMES_SECRET_KEY",
또는 dotenv 덤프용 작은 래퍼 스크립트.
secret-tool (libsecret/Gnome Keyring):
command: "secret-tool lookup hermes $HERMES_SECRET_KEY" (위에서
키별 표준 예시로 이미 표시됨).
Bitwarden CLI: bw get item "$HERMES_SECRET_KEY" | jq -r .notes
(세션에서 bw unlock 후).
1Password CLI: op read "op://vault/$HERMES_SECRET_KEY/credential".
사용자가 관리하는 권한이 있는 평문 env 파일:
command: "cat ~/.config/hermes/secrets.env"와 chmod 600 및
사용자 소유 파일. 볼트만큼 안전하지는 않지만
전 세계에서 읽을 수 있는 .env보다는 낫습니다.

요점: stdout에 값(키별) 또는 dotenv 블롭(목록 모드)을 출력하는
모든 헬퍼가 작동하며, Hermes는 헬퍼에 3초 타임아웃과
1 MiB 출력 상한을 적용하여 잘못 동작하는 헬퍼가 앱을 막을 수 없도록 합니다. 프로바이더는 TPM, FIDO2, 스마트 카드,
플랫폼 키체인에 대해 어떤 가정도 하지 않습니다.

보안 모델:

명령 문자열은 사용자 자신의 구성입니다 — .env와 동일한 신뢰 수준입니다.
/bin/sh -c를 통해 실행되므로 command 프로바이더는 POSIX 전용입니다
(Linux/macOS); Windows는 env 프로바이더를 유지합니다.
헬퍼는 프로세스 환경과 HERMES_SECRET_KEY를 상속합니다; 키 이름은
데이터로 전달되며 셸 문자열에 절대 보간되지 않습니다.
하드 3초 타임아웃(해석은 메인 프로세스에서 동기적으로 이루어짐 — 헬퍼를
빠르고 비대화식으로 유지하세요), 1 MiB 출력 상한, stderr는 폐기됩니다.
해석된 값은 절대 로깅되거나 디스크에 기록되지 않습니다; 실패는
"키 미설정"으로 저하되며 종료 코드/시그널만 로깅됩니다.
게이트웨이 스폰 브로드캐스트는 단일 list() 호출을 사용하며, 키별
헬퍼 루프를 사용하지 않습니다.

진실의 원천: src/main/secrets/ .

참고

데스크톱 앱은 에이전트 동작과 도구 실행을 위해 업스트림 Hermes Agent 프로젝트에 의존합니다.
내장 설치 프로그램은 --skip-setup으로 공식 Hermes 설치 스크립트를 실행한 후 GUI에서 프로바이더 구성을 완료합니다.
로컬 모델 프로바이더는 API 키가 필요하지 않지만, 호환 서버가 이미 실행 중이어야 합니다.
기여 가이드의 npm 명령은 소스 체크아웃의 의존성과 개발 워크플로에 적용됩니다…