EN

Recipes

Hermes One 데스크톱 GUI: 자기 개선형 Hermes Agent를 설치하고 대화할 수 있는 GUI

README 링크에서 발견 · 2 days ago

Research & KnowledgeSoftware & DevOps

Hermes Agent를 설치하고 구성하며 채팅할 수 있는 네이티브 데스크톱 앱입니다.

What they did

그들은 CLI를 직접 관리하는 대신 셀프 호스팅 Hermes Agent의 프런트 엔드로 Hermes One(hermes-desktop)을 사용했습니다. 이 앱은 공식 Hermes 설치 스크립트를 실행하고, Hermes를 ~/.hermes 아래에 배치했으며, 에이전트가 모델 백엔드를 갖출 수 있도록 프로바이더 설정 과정을 안내했습니다. GUI에서 채팅 세션을 열고, 프로필을 생성하고, 메모리를 검사 및 편집하고, 스킬과 도구를 탐색하고 활성화했으며, 예약 작업을 설정했습니다. 또한 에이전트를 다른 플랫폼에서 접근할 수 있도록 메시징 게이트웨이를 구성했고, 데스크톱 셸을 통해 구성 파일을 직접 건드리지 않고도 세션 기록을 검토하고 구성을 조정했습니다. Windows에서는 서명되지 않은 설치 프로그램에 대한 SmartScreen 경고를 클릭하여 넘어갔고, WSL에서는 Playwright의 의존성 설치가 완료될 수 있도록 일시적으로 비밀번호 없는 sudo를 부여한 뒤 sudoers drop-in을 제거했습니다.

How it went

채팅 UI, 영구 메모리, 스킬, 도구, 스케줄을 흩어진 CLI 명령어 대신 하나의 창에서 관리하는 작동하는 로컬 에이전트입니다. 설정은 대부분 안내 방식으로 진행되지만, 프로젝트가 활발히 개발 중이므로 거친 부분과 간헐적인 오류가 있을 수 있습니다.

Worth knowing

Windows 설치 프로그램은 코드 서명이 되어 있지 않아 첫 실행 시 SmartScreen 경고가 표시됩니다. WSL 설치의 경우 TTY가 없는 상태에서 sudo 비밀번호 프롬프트가 뜨면 멈출 수 있습니다. npm install hermes-desktop은 지원되는 설치 경로가 아니며, releases 또는 hermesone.org를 사용하세요. 활발한 개발 중에는 기능이 변경되거나 작동하지 않을 수 있습니다.

Wiring

데스크톱 앱은 hermesone.org 또는 GitHub Releases에서 다운로드하세요 (npm 아님). 앱은 공식 Hermes 설치 스크립트를 실행하고 Hermes를 ~/.hermes에 저장합니다. 설정 마법사에서 모델 제공자를 구성한 다음, GUI 패널을 사용하여 채팅, 세션, 프로필, 메모리, 스킬, 도구, 스케줄링, 메시징 게이트웨이를 이용하세요. WSL에서는 Playwright 의존성 단계를 위해 임시 NOPASSWD sudoers 항목을 추가하고, 완료 후 제거하세요.

Try it yourself

# Hermes One 설치 및 설정 가이드

## 1. 설치

**hermesone.org에서 설치:**
- 사이트의 다운로드 페이지에서 사용 중인 OS용 설치 파일을 받습니다.
- macOS: `.dmg` 파일을 열고 Applications 폴더로 드래그
- Windows: `.exe` 설치 프로그램 실행
- Linux: `.AppImage` 또는 배포판 패키지 설치

**GitHub Releases에서 설치:**
- GitHub 저장소의 Releases 탭에서 최신 버전 확인
- OS에 맞는 바이너리/패키지 다운로드 후 위와 동일하게 설치

설치 후 터미널에서 `hermes --version`으로 정상 설치를 확인합니다.

## 2. Provider 설정

1. `hermes init` 또는 첫 실행 시 표시되는 설정 마법사 실행
2. 사용할 provider 선택 (예: Anthropic, OpenAI 등)
3. API 키 입력 — 환경 변수(`ANTHROPIC_API_KEY` 등)로 설정하거나 마법사에서 직접 입력
4. 기본 모델 지정
5. `hermes config show`로 설정 확인

## 3. 프로필 생성

```
hermes profile create myprofile
hermes profile use myprofile
```

프로필은 모델, 스킬, 도구, 메모리 설정을 묶어 관리하는 단위입니다.

## 4. 스킬 및 도구 활성화

```
hermes skills list
hermes skills enable <skill-name>
hermes tools list
hermes tools enable <tool-name>
```

예를 들어 파일 시스템 도구와 웹 검색 스킬을 활성화하려면:

```
hermes tools enable filesystem
hermes skills enable web-search
```

## 5. 반복 작업 스케줄링

```
hermes schedule create \
  --name "daily-summary" \
  --cron "0 9 * * *" \
  --prompt "매일 아침 요약 보고서 생성"
```

`hermes schedule list`로 등록된 작업을 확인하고, `hermes schedule run <name>`으로 수동 테스트할 수 있습니다.

## 6. 메모리와 세션 위치 (`~/.hermes`)

- `~/.hermes/memory/` — 장기 메모리 저장소 (프로필별 하위 디렉터리)
- `~/.hermes/sessions/` — 대화 세션 로그 및 상태
- `~/.hermes/config/` — 프로필 및 provider 설정
- `~/.hermes/schedules/` — 스케줄 정의

## 7. 백업

전체 백업:

```
tar -czf hermes-backup-$(date +%Y%m%d).tar.gz ~/.hermes
```

메모리와 세션만 백업:

```
tar -czf hermes-data-$(date +%Y%m%d).tar.gz \
  ~/.hermes/memory ~/.hermes/sessions
```

복원 시에는 압축을 풀어 동일 경로에 배치하면 됩니다. API 키가 포함된 설정 파일이 백업에 들어가므로 암호화(`gpg` 등)하거나 별도 보관을 권장합니다.

Source

English

Tools in this stack