fathah/hermes-desktop

Hermes Desktop – Hermes AI 어시스턴트를 위한 GUI

개요 – Hermes Desktop은 Nous Research에서 만든 자기 개선형 도구 사용 LLM 어시스턴트인 Hermes Agent를 래핑하는 네이티브 크로스 플랫폼(Windows, Linux, macOS) Electron 애플리케이션입니다. 데스크톱 클라이언트는 에이전트 설치, LLM 제공업체 구성, 프로필 관리, 풍부한 채팅 UI 제공 등 전체 수명 주기를 처리합니다.

주요 기능

• 가이드 설치 – 첫 실행 마법사가 공식 Hermes 설치 스크립트를 실행하고, 종속성(Git, Python 3.11+, uv)을 해결하며, 에이전트를 ~/.hermes에 저장합니다.
• 로컬 또는 원격 백엔드 – 에이전트를 로컬 127.0.0.1:8642에서 실행하거나 원격 Hermes API 서버(URL + API 키)를 지정합니다.
• 다중 제공업체 LLM 지원 – OpenRouter, Anthropic, OpenAI, Google Gemini, xAI Grok, Nous Portal, Qwen, MiniMax, Hugging Face, Groq 및 모든 OpenAI 호환 엔드포인트(Ollama, LM Studio, vLLM, llama.cpp 등).
• 스트리밍 채팅 UI – 서버 전송 이벤트(SSE)를 통해 실시간 토큰 수, 마크다운, 구문 강조 코드 및 도구 진행률 표시줄을 제공합니다.
• 슬래시 명령어 툴박스 – 22개의 내장 명령어(/new, /clear, /web, /image, /code, /shell, /memory, /persona, /schedule 등)로 세션 제어, 도구 호출 또는 사용량 조회가 가능합니다.
• 세션 및 프로필 관리 – SQLite 기반 기록, 전체 텍스트 검색, 날짜 그룹화 및 여러 "에이전트"를 위한 격리된 구성 폴더.
• 도구 생태계 – 14개의 즉시 사용 가능한 도구 세트(웹 브라우징, 터미널, 파일 작업, 비전, 이미지 생성, TTS, 기술 실행, 메모리 제공업체, 위임, 작업 계획 등).
• 메모리 시스템 – 항목 보기/편집, 용량 추적 및 Honcho, Hindsight, Mem0, RetainDB, Supermemory, ByteRover와 같은 제공업체 플러그인.
• 페르소나 편집기 – UI에서 직접 에이전트의 SOUL.md 성격 설정을 편집합니다.
• 스케줄링 – 15개의 전달 대상(예: 메시징 게이트웨이)을 갖춘 Cron 스타일 작업 빌더.
• 메시징 게이트웨이 – Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost, Email, SMS, iMessage (BlueBubbles), DingTalk, Feishu/Lark, WeCom, WeChat, Webhooks, Home Assistant용 통합 봇.
• Hermes Office (Claw3d) – 어댑터와 개발 서버를 관리하기 위한 3D 시각적 인터페이스.
• 백업 / 가져오기 / 진단 – 원클릭 데이터 내보내기, 복원 및 로그 뷰어.
• 자동 업데이트 – Electron-updater가 GitHub 릴리스를 확인하고 패치를 적용합니다.
• 국제화 – 영어 UI는 커뮤니티 번역을 지원할 준비가 되어 있습니다.
• 테스트 스위트 – SSE 파싱, IPC, 설치 프로그램 유틸리티 등을 위한 Vitest 기반 단위 테스트.

작동 방식

1. 첫 실행 시 "로컬" 또는 "원격" 모드를 선택합니다.
2. 로컬: 앱이 Hermes 설치 스크립트를 실행하고 에이전트를 ~/.hermes에 배치한 후 HTTP 서버를 시작합니다.
3. 원격: 원격 URL과 API 키를 입력하면 설치 과정이 건너뜁니다.
4. LLM 제공업체 또는 로컬 OpenAI 호환 엔드포인트를 선택합니다. 자격 증명은 ~/.hermes/.env에 저장됩니다(또는 구성 가능한 "명령" 비밀 제공업체를 통해).
5. 채팅 요청은 SSE를 사용하여 선택한 백엔드로 전송되며, 클라이언트는 스트림을 파싱하여 실시간으로 UI를 업데이트합니다.

대상 사용자 – CLI 구성을 다루지 않고도 다중 제공업체 유연성, 도구 통합 또는 메시징 게이트웨이 봇이 필요한, 자가 호스팅 LLM 어시스턴트를 위한 데스크톱 친화적인 인터페이스를 원하는 개발자나 파워 유저.

설치 – Windows(서명되지 않음) 및 Fedora RPM용 설치 프로그램이 제공됩니다. README에는 WSL, 서명되지 않은 설치 프로그램 및 sudo 없이 설치하는 팁에 대한 참고 사항이 포함되어 있습니다.

커뮤니티 – 이 프로젝트는 오픈 소스(MIT)이며 기여를 환영하고 Discord 커뮤니티가 있습니다. 후원 옵션과 Ko-fi 링크가 나열되어 있습니다.

---

위의 모든 세부 정보는 저장소의 README에서 직접 가져왔습니다.