Hermes Agent ☤

Hermes Agent | Hermes Desktop

Nous Research가 만든 자기 개선형 AI 에이전트입니다. 경험에서 스킬을 만들고, 사용 중에 개선하며, 지식을 유지하도록 스스로를 유도하고, 과거 대화를 검색하며, 세션을 넘어 당신에 대한 깊어지는 모델을 구축하는 내장 학습 루프를 가진 유일한 에이전트입니다. 5달러 VPS, GPU 클러스터, 또는 유휴 상태에서 거의 비용이 들지 않는 서버리스 인프라에서 실행하세요. 노트북에 묶여 있지 않습니다 — 클라우드 VM에서 작업하는 동안 Telegram으로 대화할 수 있습니다.

원하는 모델을 사용하세요 — Nous Portal, OpenRouter, OpenAI, 자체 엔드포인트, 그리고 다른 여러 곳. hermes model로 전환하세요 — 코드 변경 없이, 락인 없이.

빠른 설치

Linux, macOS, WSL2, Termux

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (네이티브, PowerShell)

참고: 네이티브 Windows는 WSL 없이 Hermes를 실행합니다 — CLI, 게이트웨이, TUI, 도구 모두 네이티브로 작동합니다. WSL2를 선호한다면 위의 Linux/macOS 원라이너도 거기서 작동합니다. 버그를 발견했나요? 이슈를 등록해 주세요.

PowerShell에서 실행:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

설치 프로그램이 모든 것을 처리합니다: uv, Python 3.11, Node.js, ripgrep, ffmpeg, 그리고 휴대용 Git Bash (MinGit, %LOCALAPPDATA%\hermes\git에 압축 해제 — 관리자 권한 불필요, 시스템 Git 설치와 완전히 격리됨). Hermes는 이 번들된 Git Bash를 사용하여 셸 명령을 실행합니다.

이미 Git이 설치되어 있다면 설치 프로그램이 이를 감지하여 대신 사용합니다. 그렇지 않으면 약 45MB의 MinGit 다운로드만 있으면 됩니다 — 시스템 Git을 건드리거나 방해하지 않습니다.

Android / Termux: 테스트된 수동 경로는 Termux 가이드에 문서화되어 있습니다. Termux에서 Hermes는 전체 .[all] 엑스트라가 현재 Android 호환되지 않는 음성 의존성을 가져오기 때문에 큐레이팅된 .[termux] 엑스트라를 설치합니다.

Windows: 네이티브 Windows는 완전히 지원됩니다 — 위의 PowerShell 원라이너가 모든 것을 설치합니다. WSL2를 선호한다면 Linux 명령도 거기서 작동합니다. 네이티브 Windows 설치는 %LOCALAPPDATA%\hermes 아래에 있으며, WSL2 설치는 Linux와 마찬가지로 ~/.hermes 아래에 있습니다.

설치 후:

source ~/.bashrc    # 셸 다시 로드 (또는: source ~/.zshrc)
hermes              # 채팅 시작!

문제 해결

Windows Defender 또는 바이러스 백신이 uv.exe를 악성코드로 플래그

바이러스 백신(Bitdefender, Windows Defender 등)이 Hermes bin 폴더(%LOCALAPPDATA%\hermes\bin\uv.exe)의 uv.exe를 격리한다면, 이는 오탐(false positive) 입니다. 이 파일은 Hermes가 Python 환경을 관리하기 위해 번들하는 Rust 기반 Python 패키지 관리자인 Astral의 uv입니다. ML 기반 바이러스 백신 엔진은 패키지를 다운로드하고 설치하는 서명되지 않은 Rust 바이너리를 흔히 플래그합니다.

사본이 정품인지 확인하려면:

# 필요 시 GitHub CLI 설치
winget install --id GitHub.cli

# GitHub 로그인
gh auth login

# 검증 실행
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash

증명이 "Verification succeeded"라고 하고 마지막 줄이 True를 출력하면 정상입니다.

Hermes를 허용 목록에 추가하려면:

• Windows Defender: 관리자로 PowerShell 실행 → Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
• Bitdefender: Bitdefender 콘솔에서 예외 추가 (Protection > Antivirus > Settings > Manage Exceptions)
• 파일 해시가 아닌 폴더를 허용 목록에 추가하세요 — Hermes는 uv를 업데이트하며 해시는 버전마다 변경됩니다

자세한 맥락은 업스트림 Astral 보고서를 참조하세요: astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079.

시작하기

hermes              # 대화형 CLI — 대화 시작
hermes model        # LLM 제공자 및 모델 선택
hermes tools        # 활성화할 도구 구성
hermes config set   # 개별 구성 값 설정
hermes config get   # 개별 구성 값 출력
hermes gateway      # 메시징 게이트웨이 시작 (Telegram, Discord 등)
hermes setup        # 전체 설정 마법사 실행 (모든 것을 한 번에 구성)
hermes claw migrate # OpenClaw에서 마이그레이션 (OpenClaw에서 오는 경우)
hermes update       # 최신 버전으로 업데이트
hermes doctor       # 문제 진단

📖 전체 문서 →

API 키 수집 건너뛰기 — Nous Portal

Hermes는 원하는 제공자와 함께 작동합니다 — 그것은 변하지 않습니다. 하지만 모델, 웹 검색, 이미지 생성, TTS, 클라우드 브라우저를 위해 5개의 별도 API 키를 수집하고 싶지 않다면, **Nous Portal**이 하나의 구독으로 모두를 커버합니다:

• 300개 이상의 모델 — /model <name>으로 원하는 모델 선택
• Tool Gateway — 웹 검색(Firecrawl), 이미지 생성(FAL), 텍스트 음성 변환(OpenAI), 클라우드 브라우저(Browser Use), 모두 구독을 통해 라우팅됩니다. 추가 계정 불필요.

새 설치에서 한 명령으로:

hermes setup --portal

이렇게 하면 OAuth로 로그인하고, Nous를 제공자로 설정하며, Tool Gateway를 켭니다. 언제든 hermes portal info로 연결 상태를 확인하세요. 자세한 내용은 Tool Gateway 문서 페이지를 참조하세요.

원할 때마다 도구별로 자체 키를 계속 가져올 수 있습니다 — 게이트웨이는 백엔드별로 작동하며, 전부 아니면 전무가 아닙니다.

CLI vs 메시징 빠른 참조

Hermes에는 두 가지 진입점이 있습니다: hermes로 터미널 UI를 시작하거나, 게이트웨이를 실행하고 Telegram, Discord, Slack, WhatsApp, Signal, 또는 Email에서 대화합니다. 대화에 들어가면 많은 슬래시 명령이 두 인터페이스에서 공유됩니다.

전체 명령 목록은 CLI 가이드와 메시징 게이트웨이 가이드를 참조하세요.

문서

모든 문서는 **hermes-agent.nousresearch.com/docs**에 있습니다:

OpenClaw에서 마이그레이션

OpenClaw에서 오는 경우, Hermes가 설정, 메모리, 스킬, API 키를 자동으로 가져올 수 있습니다.

첫 설정 중: 설정 마법사(hermes setup)가 ~/.openclaw를 자동으로 감지하고 구성 시작 전에 마이그레이션을 제안합니다.

설치 후 언제든지:

hermes claw migrate              # 대화형 마이그레이션 (전체 프리셋)
hermes claw migrate --dry-run    # 마이그레이션될 내용 미리 보기
hermes claw migrate --preset user-data   # 비밀 없이 마이그레이션
hermes claw migrate --overwrite  # 기존 충돌 덮어쓰기

가져오는 항목:

• SOUL.md — 페르소나 파일
• 메모리 — MEMORY.md 및 USER.md 항목
• 스킬 — 사용자 생성 스킬 → ~/.hermes/skills/openclaw-imports/
• 명령 허용 목록 — 승인 패턴
• 메시징 설정 — 플랫폼 구성, 허용 사용자, 작업 디렉터리
• API 키 — 허용 목록된 비밀 (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
• TTS 자산 — 작업 공간 오디오 파일
• 작업 공간 지침 — AGENTS.md (--workspace-target 포함)

모든 옵션은 hermes claw migrate --help를 참조하거나, dry-run 미리 보기가 있는 대화형 에이전트 안내 마이그레이션을 위해 openclaw-migration 스킬을 사용하세요.

기여

기여를 환영합니다! 개발 설정, 코드 스타일, PR 프로세스는 기여 가이드를 참조하세요.

기여자를 위한 빠른 시작 — 표준 설치 프로그램을 사용한 후, 설치 프로그램이 생성하는 전체 git 체크아웃 $HERMES_HOME/hermes-agent(보통 ~/.hermes/hermes-agent)에서 작업하세요. 이는 hermes update, 관리형 venv, 지연 의존성, 게이트웨이, 문서 도구에서 사용하는 레이아웃과 일치합니다.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent"
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

수동 클론 대체 방법 (관리형 설치 레이아웃을 의도적으로 원하지 않는 임시 클론/CI용):

venv를 클론된 소스 트리 외부에 만드세요 — 에이전트가 작동하는 디렉터리 내부의 venv는 에이전트가 자체 체크아웃에 대해 실행하는 상대 경로 명령에 의해 지워져 실행 중인 런타임이 세션 중간에 파괴될 수 있습니다.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv ~/.hermes/venvs/hermes-dev --python 3.11
source ~/.hermes/venvs/hermes-dev/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

커뮤니티

• 💬 Discord
• 📚 Skills Hub
• 🐛 이슈
• 🔌 computer-use-linux — AT-SPI 접근성 트리, Wayland/X11 입력, 스크린샷, 컴포지터 창 타겟팅을 갖춘 Hermes 및 기타 MCP 호스트용 Linux 데스크톱 제어 MCP 서버.
• 🔌 HermesClaw — 커뮤니티 WeChat 브리지: 동일한 WeChat 계정에서 Hermes Agent와 OpenClaw를 실행.

라이선스

MIT — LICENSE 참조.

Nous Research 제작.