설치

anchor alias

설치

한 줄의 설치 프로그램을 사용하여 Hermes Agent를 2분 안에 시작하고 실행할 수 있습니다.

빠른 설치

한 줄 설치 프로그램(Linux/macOS/WSL2)

main을 추적하고 최신 변경 사항을 즉시 제공하는 Git 기반 설치의 경우:

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

Windows(네이티브, PowerShell) - 초기 베타

Early BETA {#windows-native-powershell--early-beta}

기본 Windows 지원은 초기 베타입니다. 일반적인 경로에 대해 설치하고 작동하지만 POSIX 설치 프로그램만큼 광범위하게 테스트되지 않았습니다. 문제가 발생하면 문제를 파일화하세요. 현재 Windows에서 가장 철저한 테스트를 거친 설정을 위해서는 대신 WSL2 내에서 위의 Linux/macOS 한 줄을 사용하세요.

PowerShell을 열고 다음을 실행합니다.

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

설치 프로그램은 모든 것을 처리합니다: uv, Python 3.11, Node.js 22, ripgrep, ffmpeg 및 휴대용 Git Bash(PortableGit — 제공되는 자체 포함 Git-for-Windows 배포판) bash.exe 및 Hermes가 32비트 Windows에서 셸 명령에 사용하는 전체 POSIX 도구 모음은 설치 프로그램이 MinGit으로 대체되어 bash가 부족하고 터미널 도구/에이전트 브라우저 기능을 비활성화합니다. %LOCALAPPDATA%\hermes\hermes-agent 아래의 저장소를 복제하고, virtualenv를 생성하고, 사용자 경로에 hermes을 추가합니다. PATH가 선택되도록 설치 후 터미널을 다시 시작하거나 새 PowerShell 창을 엽니다.

Git 처리 방법:

git이 이미 PATH에 있는 경우 설치 프로그램은 기존 설치를 사용합니다.
그렇지 않으면 휴대용 PortableGit(공식 git-for-windows GitHub 릴리스에서 ~)을 다운로드하여 %LOCALAPPDATA%\hermes\git에 압축을 풉니다. 관리자 권한이 필요하지 않습니다. 완전히 격리되어 있어 시스템 Git 설치, 손상 여부 등을 방해하지 않습니다. (32비트 Windows에서는 PortableGit이 64비트 및 ARM64 자산만 제공하므로 MinGit으로 대체됩니다. bash 종속 Hermes 기능은 32비트 호스트에서 작동하지 않습니다.)

winget을 사용하면 안 되는 이유는 무엇입니까? 이전 설계에서는 winget install Git.Git을 통해 Git을 자동 설치했지만 시스템 Git 설치가 부분적이거나 손상된 상태인 경우(정확히 사용자가 설치 프로그램을 설치해야 하는 경우) Winget이 심하게 실패합니다. 휴대용 Git 접근 방식은 Winget, Windows 설치 프로그램 레지스트리 및 기존 시스템 Git을 완전히 회피합니다. Hermes Git 설치 자체가 중단되는 경우 Remove-Item %LOCALAPPDATA%\hermes\git하고 설치 프로그램을 다시 실행하세요. 시스템에 영향을 주지 않으며 제거 문제도 발생하지 않습니다.

설치 프로그램은 또한 HERMES_GIT_BASH_PATH을 위치한 bash.exe로 설정하므로 Hermes는 새로운 쉘에서 이를 결정적으로 해결합니다.

WSL2를 선호하는 경우 위의 Linux 설치 프로그램이 WSL2 내에서 작동합니다. 기본 설치와 WSL 설치 모두 충돌 없이 공존할 수 있습니다(기본 데이터는 %LOCALAPPDATA%\hermes에 있고 WSL 데이터는 ~/.hermes에 있습니다).

안드로이드/Termux

Hermes는 이제 Termux 인식 설치 프로그램 경로도 제공합니다.

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

설치 프로그램은 Termux를 자동으로 감지하고 테스트된 Android 흐름으로 전환합니다.

시스템 종속성에 대해 Termux pkg 사용(git, python, nodejs, ripgrep, ffmpeg, 빌드 도구)
python -m venv을 사용하여 virtualenv를 생성합니다.
Android 휠 빌드를 위해 ANDROID_API_LEVEL을 자동으로 내보냅니다.
광범위한 .[termux-all] 추가를 선호하고 첫 번째 시도가 컴파일에 실패하면 더 작은 .[termux] 추가로 대체합니다(마지막으로 기본 설치).
기본적으로 테스트되지 않은 브라우저/WhatsApp 부트스트랩을 건너뜁니다.

완전히 명시적인 경로를 원하는 경우 전용 Termux 가이드를 따르세요.

Windows Feature Parity (Early Beta)

기본 Windows는 초기 베타 버전입니다. 브라우저 기반 대시보드 채팅 터미널을 제외한 모든 것은 Windows에서 기본적으로 실행됩니다.

CLI (hermes chat, hermes setup, hermes gateway, …) — 기본, 기본 터미널을 사용합니다.
게이트웨이(Telegram, Discord, Slack, …) — 기본, 백그라운드 PowerShell 프로세스로 실행
크론 스케줄러 — 기본
브라우저 도구 — 기본(Node.js를 통한 Chromium)
MCP 서버 — 기본(stdio 및 HTTP 전송 모두 지원)
대시보드 /chat 터미널 창 — WSL2 전용(POSIX PTY를 사용하며 기본 Windows에는 이에 상응하는 것이 없음). 대시보드의 나머지 부분(세션, 작업, 메트릭)은 기본적으로 작동하며 내장된 PTY 터미널 탭만 게이트됩니다.

인코딩 관련 버그가 발생하여 레거시 cp1252 stdio 경로(이등분에 유용함)로 대체하려는 경우 환경에서 HERMES_DISABLE_WINDOWS_UTF8=1을 설정합니다.

설치 프로그램이 하는 일

설치 프로그램은 모든 종속성(Python, Node.js, ripgrep, ffmpeg), 저장소 복제, 가상 환경, 전역 hermes 명령 설정 및 LLM 공급자 구성 등 모든 것을 자동으로 처리합니다. 이제 채팅할 준비가 되었습니다.

레이아웃 설치

설치 프로그램이 항목을 저장하는 위치는 일반 사용자로 설치하는지 루트로 설치하는지에 따라 다릅니다.

설치자	코드는 다음 위치에 살고 있습니다.	`hermes` 바이너리	데이터 디렉터리
핍 설치	Python 사이트 패키지	`~/.local/bin/hermes` (console_scripts)	`~/.hermes/`
사용자별(git 설치 프로그램)	`~/.hermes/hermes-agent/`	`~/.local/bin/hermes`(심볼릭 링크)	`~/.hermes/`
루트 모드(`sudo 컬 … \| sudo bash`)	`/usr/local/lib/hermes-agent/`	`/usr/local/bin/hermes`	`/root/.hermes/`(또는 `$HERMES_HOME`)

루트 모드 FHS 레이아웃(/usr/local/lib/…, /usr/local/bin/hermes)은 다른 시스템 전체 개발자 도구가 Linux에 있는 위치와 일치합니다. 하나의 시스템 설치가 모든 사용자에게 서비스를 제공해야 하는 공유 시스템 배포에 유용합니다. 사용자별 구성(인증, 기술, 세션)은 여전히 각 사용자의 ~/.hermes/ 또는 명시적인 HERMES_HOME에 있습니다.

설치 후

셸을 다시 로드하고 채팅을 시작하세요.

source ~/.bashrc   # or: source ~/.zshrc
hermes             # Start chatting!

나중에 개별 설정을 재구성하려면 전용 명령을 사용하십시오.

hermes model          # Choose your LLM provider and model
hermes tools          # Configure which tools are enabled
hermes gateway setup  # Set up messaging platforms
hermes config set     # Set individual config values
hermes setup          # Or run the full setup wizard to configure everything at once

전제 조건

pip install: Python 3.11+ 이상에는 전제 조건이 없습니다. 다른 모든 것은 자동으로 처리됩니다.

Git 설치 프로그램: 유일한 전제 조건은 Git입니다. 설치 프로그램은 자동으로 다른 모든 것을 처리합니다.

uv (빠른 Python 패키지 관리자)
Python 3.11(uv를 통해, sudo가 필요하지 않음)
Node.js v22(브라우저 자동화 및 WhatsApp 브리지용)
ripgrep (빠른 파일 검색)
ffmpeg(TTS용 오디오 형식 변환)

정보

Python, Node.js, ripgrep 또는 ffmpeg를 수동으로 설치할 필요는 없습니다. 설치 프로그램이 누락된 항목을 감지하여 설치해 드립니다. git을 사용할 수 있는지 확인하세요(git --version).

Nix users

Nix(NixOS, macOS 또는 Linux)를 사용하는 경우 Nix 플레이크, 선언적 NixOS 모듈 및 선택적 컨테이너 모드가 포함된 전용 설정 경로가 있습니다. Nix 및 NixOS 설정 가이드를 참조하세요.

매뉴얼/개발자 설치

기여, 특정 브랜치에서 실행 또는 가상 환경에 대한 전체 제어를 위해 리포지토리를 복제하고 소스에서 설치하려면 기여 가이드의 개발 설정 섹션을 참조하세요.

비 Sudo/시스템 서비스 사용자 설치

권한이 없는 전용 사용자(예: hermes 시스템 서비스 계정 또는 sudo 액세스 권한이 없는 모든 사용자)로 Hermes를 실행하는 것이 지원됩니다. 설치 경로에서 실제로 루트가 필요한 유일한 것은 Chromium에서 사용하는 공유 라이브러리(libnss3, libxkbcommon 등)를 apt-설치하는 Playwright의 --with-deps 단계입니다. 설치 프로그램은 sudo가 사용 가능한지 여부를 감지하고 그렇지 않은 경우에는 단계적으로 성능을 저하시킵니다. 즉, Chromium 바이너리를 서비스 사용자의 자체 Playwright 캐시에 설치하고 관리자가 별도로 실행해야 하는 정확한 명령을 인쇄합니다.

권장 분할(Debian/Ubuntu):

한 번은 sudo를 사용하는 관리자로 Chromium에 필요한 시스템 라이브러리를 설치합니다.
```
sudo npx playwright install-deps chromium
```

(어디서나 실행할 수 있습니다. npx은 즉시 Playwright를 가져옵니다.)

권한이 없는 서비스 사용자로 일반 설치 프로그램을 실행하세요. 누락된 sudo를 감지하고 --with-deps을 건너뛰고 Chromium을 사용자의 로컬 Playwright 캐시에 설치합니다.
```
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

예를 들어 헤드리스를 실행 중이고 브라우저 자동화가 필요하지 않기 때문에 Playwright 단계를 완전히 건너뛰려면 --skip-browser을 전달하세요.

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

서비스 사용자의 쉘에서 hermes을 사용할 수 있도록 합니다. 설치 프로그램은 ~/.local/bin/hermes에 실행 프로그램을 씁니다. 시스템 서비스 계정에는 ~/.local/bin을 포함하지 않는 최소 PATH가 있는 경우가 많습니다. 사용자 환경에 추가하거나 실행 프로그램을 시스템 위치에 심볼릭 링크합니다.
```
# Option A — add to the service user's profile
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

# Option B — symlink system-wide (run as an admin)
sudo ln -s /home/hermes/.hermes/hermes-agent/venv/bin/hermes /usr/local/bin/hermes
```
확인: 이제 hermes doctor이 정상적으로 실행됩니다. ModuleNotFoundError: No module named 'dotenv'을 받으면 venv 실행기(~/.hermes/hermes-agent/venv/bin/hermes) 대신 시스템 Python을 사용하여 저장소 소스 hermes 파일(~/.hermes/hermes-agent/hermes)을 호출하는 것입니다. — 3단계를 수정하세요.

동일한 패턴이 Arch(설치 프로그램은 동일한 sudo 감지 논리로 pacman을 사용함), Fedora/RHEL 및 openSUSE에서 작동합니다. 이러한 배포판은 --with-deps을 전혀 지원하지 않으므로 관리자는 항상 시스템 라이브러리를 별도로 설치합니다. 관련 dnf/zypper 명령은 설치 프로그램에 의해 인쇄됩니다.

문제 해결

문제	솔루션
`hermes: command not found`	쉘(`source ~/.bashrc`)을 다시 로드하거나 PATH를 확인하세요.
`API key not set`	`hermes model`을 실행하여 공급자를 구성하거나 `hermes config set OPENROUTER_API_KEY your_key`을 실행하세요.
업데이트 후 구성 누락	`hermes config check`을 실행한 다음 `hermes config migrate`을 실행합니다.

더 많은 진단을 원하시면 hermes doctor을 실행하세요. 누락된 부분과 수정 방법을 정확하게 알려줄 것입니다.

anchor alias​

설치

빠른 설치​

한 줄 설치 프로그램(Linux/macOS/WSL2)​

Windows(네이티브, PowerShell) - 초기 베타​

안드로이드/Termux​

설치 프로그램이 하는 일​

레이아웃 설치​

설치 후​

전제 조건​

매뉴얼/개발자 설치​

비 Sudo/시스템 서비스 사용자 설치​

문제 해결​