주요 콘텐츠로 건너뛰기
AI 튜토리얼

Hermes Agent에서 공식 플러그인 설치 및 사용

Hermes Agent를 설치하고 검토된 플러그인 카탈로그를 살펴보며 공식 플러그인을 추가하고 업데이트하는 방법을 알아보세요. 또한 기존 설치를 마이그레이션하고 플러그인을 로컬에서 테스트하는 방법, 사용 가능한 퍼스트파티 통합 기능과 카탈로그 핀이 제어된 릴리스를 제공하는 방식도 설명합니다.

약 14분 소요
Hermes Agent 공식 플러그인 설치 및 사용
Hermes 공식 플러그인

Hermes 공식 플러그인이 제공하는 기능

Hermes 공식 플러그인은 Nous Research가 관리하는 Hermes Agent용 공식 플러그인 모음입니다. 저장소의 각 디렉터리에는 Hermes 플러그인 카탈로그를 통해 설치할 수 있는 독립형 통합 기능이 포함되어 있습니다.

Hermes Agent는 세션 간에 유용한 정보를 유지하고, 경험을 통해 기술을 개발하며, 터미널, Hermes Desktop, Telegram, Discord, Slack, WhatsApp, Signal 등의 인터페이스에서 실행할 수 있는 자기 개선형 AI 에이전트입니다. Nous Portal, OpenRouter, Anthropic, OpenAI 및 사용자 지정 엔드포인트를 비롯한 여러 모델 소스를 지원합니다.

이 프로젝트는 에이전트 루프, 메모리, 기술, 게이트웨이, 모델 라우팅, 도구 런타임 등 Hermes의 범용 기능을 코어에 유지합니다. 제품별 및 공급업체별 기능은 별도의 플러그인으로 분리되어 있습니다.

Hermes가 플러그인을 사용하는 이유

  • 더 작은 설치: 필요한 통합 기능만 설치할 수 있습니다.
  • 독립적인 수정: 새 Hermes 코어 릴리스를 기다리지 않고도 플러그인에 검토된 업데이트를 적용할 수 있습니다.
  • 명확한 관리 주체: 공식 플러그인은 Nous가 관리하고, 커뮤니티 플러그인은 공급업체와 독립 개발자가 관리합니다.
  • 검토된 버전: 카탈로그 항목은 검토된 커밋에 고정되므로, 설치와 업데이트에 알려진 리비전이 사용됩니다.
  • 효율적인 다운로드: Hermes는 블롭리스 희소 클론을 통해 선택한 플러그인 디렉터리만 가져옵니다.

사전 요구 사항 및 Hermes 설치

이 플러그인들을 추가하려면 먼저 Hermes Agent가 정상적으로 설치되어 있어야 합니다. 지원되는 시스템에서 Hermes README에 안내된 설치 스크립트를 실행하세요.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

설치 후 명령줄 인터페이스를 사용할 수 있는지 확인하세요.

hermes --help

개별 플러그인에는 추가 요구 사항이 있을 수 있습니다. 예를 들어 Spotify에는 로그인을 위한 자체 Spotify 개발자 애플리케이션이 필요하고, Blender에는 Blender 5.1 이상과 MCP 애드온이 필요하며, Snyk에는 Node.js, npm 및 Snyk 계정이 필요합니다. 설치하기 전에 플러그인의 카탈로그 정보를 확인하세요.

플러그인 카탈로그 탐색

Hermes 플러그인 카탈로그에는 검토된 공식 및 커뮤니티 통합 기능이 포함되어 있습니다. 검색 명령으로 사용 가능한 항목을 살펴보세요.

hermes plugins search

설치하기 전에 특정 플러그인의 정보를 확인하세요.

hermes plugins info spotify

정보 항목에는 플러그인의 기능, 요구 사항 및 고정된 검토 커밋이 설명되어 있습니다. Hermes Desktop 사용자는 기능 → 플러그인에서 동일한 카탈로그에 액세스할 수 있습니다.

플러그인 설치 및 업데이트

  1. 원하는 통합 기능을 검색합니다.

    hermes plugins search

  2. 요구 사항과 메타데이터를 확인합니다.

    hermes plugins info spotify

  3. 검토된 버전을 설치합니다.

    hermes plugins install spotify

  4. 새로운 검토 고정 버전을 사용할 수 있게 되면 플러그인을 업데이트합니다.

    hermes plugins update spotify

업데이트하면 카탈로그에 지정된 다음 검토 커밋이 적용됩니다. 임의의 저장소 리비전이 자동으로 설치되지는 않습니다.

공식 플러그인 선택

Home Assistant

Home Assistant 플러그인은 엔터티 목록 조회, 상태 읽기, 서비스 목록 조회 및 서비스 호출을 위한 게이트웨이 플랫폼과 네 가지 도구를 추가합니다. Hermes는 이벤트 버스를 모니터링하고, 선택한 상태 변경에 반응하며, REST API를 통해 장치를 제어하고, Home Assistant 알림으로 응답할 수 있습니다.

hermes plugins install homeassistant

도구는 ha_list_entities, ha_get_state, ha_list_services, ha_call_service입니다. Cron 작업은 deliver=homeassistant를 사용해 Home Assistant를 대상으로 지정할 수 있습니다.

Spotify

Spotify 플러그인은 재생, Spotify Connect 장치, 대기열, 검색, 플레이리스트, 앨범 및 사용자 라이브러리를 위한 도구를 제공합니다.

hermes plugins install spotify
hermes spotify login

로그인 명령은 사용자의 Spotify 개발자 애플리케이션을 사용해 루프백 PKCE 로그인을 수행합니다. 재생을 제어하려면 Spotify Premium이 필요합니다.

Claude Subscription DirectSDK

이 실험적인 모델 제공자는 Claude Pro 또는 Max 구독을 사용해 공식 Claude Code CLI를 통해 Hermes의 작업을 실행합니다. Hermes는 자체 에이전트 루프, 도구, 승인 처리 및 압축을 유지하며, 플러그인은 인증된 claude 바이너리를 요청 범위 모델 클라이언트로 사용합니다.

hermes plugins install claude-subscription-directsdk

설치 후 hermes model을 열고 Claude Subscription DirectSDK (Experimental)를 선택하세요. Claude Code를 사용할 수 없으면 플러그인이 실행을 거부하고 설치 안내를 제공합니다.

Telegram Business 모드

Telegram Business 모드는 Hermes를 Telegram Business 계정을 위한 승인 후 관찰형 어시스턴트로 전환합니다. 고객 답변 초안을 작성할 수 있지만, 모든 답변은 전송 전에 소유자의 승인이 필요합니다.

hermes plugins install hermes-telegram-business

Memory Wiki

Memory Wiki는 로컬 세션 기록을 주제별 페이지와 일일 로그로 구성하는 대시보드와 Hermes Desktop 탭을 추가합니다. 또한 MEMORY.md와 USER.md를 위한 읽기 전용 감사 패널도 제공합니다. 이 플러그인은 로컬 기록을 읽기만 하며 기록에 쓰지 않습니다.

hermes plugins install hermes-memory-wiki

Blender

Blender 플러그인은 공식 Blender Lab MCP 서버와 Blender 워크플로 스킬을 결합합니다. MCP 애드온이 설치된 Blender 5.1 이상과 Git 및 uv가 필요합니다. Windows, macOS, Linux를 지원합니다.

hermes plugins install blender

Blender 도구는 Blender 내부에서 Python을 실행합니다. 신뢰할 수 있는 워크플로만 사용하고 장면을 수정할 수 있는 작업은 검토하세요.

Snyk

Snyk 플러그인은 Snyk의 퍼스트파티 MCP 서버를 사용하며 snyk-security-scan 워크플로 스킬을 포함합니다. 소스 코드, 종속성, 컨테이너 이미지, 인프라 코드 구성, 소프트웨어 자재 명세서를 검사할 수 있습니다.

hermes plugins install snyk

Node.js, npm 및 Snyk 계정이 필요합니다. 인증은 snyk_auth를 사용해 브라우저에서 수행합니다.

TouchDesigner

TouchDesigner 플러그인은 TouchDesigner 내부에서 실행되는 404.zero의 무료 twozero MCP 서버를 통해 실행 중인 TouchDesigner 세션에 연결합니다. 워크플로 스킬과 오퍼레이터, GLSL, 오디오 반응형 프로젝트, 인스턴싱 등의 주제를 다루는 20개 이상의 참고 파일이 포함되어 있습니다.

hermes plugins install touchdesigner

TouchDesigner는 macOS와 Windows에서 지원됩니다.

Accent Picker

Accent Picker는 상태 표시줄에 OKLCH 색상 휠을 추가하는 Hermes Desktop 플러그인입니다. 피커를 드래그하면 테마 색조가 실시간으로 변경되어 테마 작성자가 현재 화면에서 강조 색상을 테스트할 수 있습니다. 선택한 색상은 임시 스크래치 상태이며 저장되지 않습니다.

hermes plugins install accent-picker

이전 설치 마이그레이션

일부 공식 플러그인은 이전에 Hermes 코어 또는 별도의 저장소에 포함되어 있었습니다. 필요한 마이그레이션 방법은 원래 설치한 방식에 따라 다릅니다.

  • 내장 Home Assistant 또는 Spotify: hermes update를 실행하세요. 업데이트 후 처음 시작할 때 기존 구성, 환경 변수 및 로그인을 유지하면서 카탈로그 플러그인을 설치할 수 있습니다.
  • 카탈로그 설치: hermes plugins update <name>을 실행하세요. 이제 카탈로그는 공식 플러그인 저장소를 가리키며 이동 중에도 파일을 유지합니다.
  • URL 기반 설치: hermes plugins install <name> --force를 사용해 카탈로그에서 한 번 다시 설치하세요. 이전 독립 저장소는 보관 처리되어 더 이상 수정 사항을 받지 않으므로 이 과정이 필요합니다.

저장소 구조 이해

최상위 플러그인 디렉터리는 각각 완전한 패키지입니다. Python 플러그인에는 일반적으로 매니페스트, 등록 코드, 종속성 및 테스트가 포함됩니다. 이식 가능한 MCP 기반 플러그인은 plugin.json, mcp.json 및 skills 디렉터리를 사용할 수 있으며, Desktop 플러그인은 desktop 디렉터리 아래에 JavaScript를 포함할 수 있습니다.

hermes-official-plugins/
├── assets/
├── homeassistant/
│   ├── plugin.yaml
│   ├── __init__.py
│   ├── pyproject.toml
│   └── tests/
├── blender/
├── accent-picker/
└── ...

카탈로그는 저장소, 하위 디렉터리 및 고정된 커밋으로 플러그인을 식별합니다. 따라서 Spotify를 설치해도 Home Assistant 플러그인은 다운로드되지 않습니다.

플러그인 로컬 테스트

개발 시 Hermes Agent와 공식 플러그인 저장소를 나란히 복제하세요.

git clone https://github.com/NousResearch/hermes-agent
git clone https://github.com/NousResearch/hermes-official-plugins
cd hermes-official-plugins/spotify
HERMES_AGENT_REPO=../../hermes-agent PYTHONPATH=../../hermes-agent python -m pytest -q

공식 플러그인은 모든 푸시와 풀 리퀘스트마다 Linux, macOS 및 Windows에서 현재 Hermes 코어를 대상으로 테스트됩니다. 코어 변경으로 인해 플러그인이 손상되는지 확인하기 위해 야간 테스트도 사용합니다.

로컬 체크아웃을 실행 중인 Hermes 환경에 설치하려면 디렉터리 경로를 전달하고 강제 교체를 지정하세요.

hermes plugins install ./spotify --force

고급 팁

  • 설치 전에 확인하세요: hermes plugins info <name>을 사용해 종속 항목과 검토된 커밋을 확인하세요.
  • 카탈로그 이름을 우선 사용하세요: 카탈로그 설치는 직접 URL로 설치하는 것보다 향후 검토된 고정 버전을 더 원활하게 따릅니다.
  • 강제 옵션은 신중하게 사용하세요: --force 옵션은 마이그레이션과 로컬 테스트에 유용하지만, 의도한 설치 항목을 교체하는지 확인하세요.
  • 승인 경계를 준수하세요: Telegram Business Mode와 같은 플러그인은 답변을 보내기 전에 의도적으로 승인을 요구합니다.
  • 강력한 통합 기능을 검토하세요: Blender와 같이 애플리케이션에서 코드를 실행하는 도구는 신뢰할 수 있는 워크플로에서만 사용해야 합니다.
  • 문제를 올바른 저장소에 보고하세요: 플러그인별 문제는 공식 플러그인 저장소에 등록하고 제목에 플러그인 이름을 포함하세요(예: [spotify] ...). 핵심 기능 문제는 Hermes Agent 이슈 트래커에 보고하세요.

플러그인 릴리스 및 빌드

유지 관리자의 경우 저장소의 main 브랜치에 플러그인 변경 사항을 병합하는 것만으로는 카탈로그 사용자에게 업데이트가 제공되지 않습니다. Hermes Agent를 대상으로 풀 리퀘스트를 열고 plugin-catalog/<name>.yaml의 플러그인 sha: 값을 변경해야 릴리스가 완료됩니다. 카탈로그의 고정 버전이 릴리스 버전 역할을 합니다.

직접 통합 기능을 만들려면 Hermes 플러그인 가이드와 예제 플러그인부터 확인하세요. 표준 플러그인은 plugin.yaml 매니페스트를 포함한 일반 Python 패키지입니다. 완성된 플러그인은 검토를 위해 Hermes 카탈로그에 제출할 수 있습니다.

결론

Hermes 공식 플러그인은 모든 통합 기능을 코어에 포함하지 않고도 Hermes Agent를 확장할 수 있는 관리된 방법을 제공합니다. 카탈로그를 검색하고, 플러그인의 요구 사항을 확인하고, 검토된 고정 버전을 설치한 다음, 업데이트 명령을 사용해 이후에 검토된 버전으로 이동하세요. 개발자는 저장소를 복제하고 플러그인별 테스트를 실행하며 실제 환경에서 테스트하기 위해 로컬 디렉터리를 설치할 수도 있습니다.