가장 쉬운 설치, 시작합니다

Hermes Agent를 사용해 보고 싶었지만 설정이 복잡할까 봐 미뤄두셨다면, 이제 그만 멈추세요. 새 설치 프로그램이 거의 모든 것을 대신 처리해 줍니다. 정말로 모든 것을요. 이 튜토리얼에서는 2분도 채 안 되는 시간에 설치를 끝내고 바로 사용할 수 있게 도와드리겠습니다. 터미널 마법사 수준의 지식은 전혀 필요 없습니다.

가장 빠른 방법: Hermes Desktop

macOS와 Windows 사용자라면 저희 웹사이트에서 Hermes Desktop 설치 프로그램을 받는 것이 가장 쉬운 방법입니다. 다운로드해서 실행하기만 하면 끝입니다. 명령줄 도구와 데스크톱 앱이 함께 설치되므로 두 가지 장점을 모두 누릴 수 있습니다.

명령줄만 사용하고 싶다면? 문제없습니다

터미널을 선호하시나요? 운영체제에 따라 두 가지 옵션이 있습니다:

Linux / macOS / WSL2 / Android (Termux):

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

Windows (네이티브) — PowerShell에서 실행:

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

나중에 마음이 바뀌어 데스크톱 앱을 사용하고 싶다면 hermes desktop 명령어만 실행하면 나머지는 알아서 처리됩니다.

설치 프로그램이 실제로 하는 일 (여러분이 할 필요 없는 일)

여기서 마법이 펼쳐집니다: 설치 프로그램이 모든 것을 자동으로 처리합니다. 더 이상 의존성을 하나하나 찾아다닐 필요가 없습니다. 다음과 같은 항목을 설정합니다:

Python 3.11 (uv를 통해, sudo 불필요)
Node.js v22 (브라우저 자동화 및 WhatsApp 브리지용)
ripgrep (초고속 파일 검색용)
ffmpeg (TTS의 오디오 변환용)
저장소 클론, 가상 환경, 전역 hermes 명령어

직접 설치해야 하는 유일한 것은 Git뿐입니다 (git --version으로 확인). Linux에서는 curl과 xz-utils도 준비되어 있는지 확인하세요. 데스크톱 앱을 사용하려면 Debian/Ubuntu에서 build-essential이 필요합니다.

파일이 설치되는 위치

설치 방식에 따라 파일이 저장되는 위치가 다릅니다:

설치 방식	코드 위치	`hermes` 바이너리	데이터 디렉터리
사용자별 (git 설치 프로그램)	`~/.hermes/hermes-agent/`	`~/.local/bin/hermes`	`~/.hermes/`
루트 모드 (`sudo curl … \| sudo bash`)	`/usr/local/lib/hermes-agent/`	`/usr/local/bin/hermes`	`/root/.hermes/`

루트 모드 방식은 하나의 시스템 설치로 모든 사용자가 사용할 수 있는 공유 머신에 적합합니다. 개인 설정(인증, 스킬, 세션)은 여전히 자신의 ~/.hermes/ 폴더에 안전하게 보관됩니다.

설치 후: 채팅 시작하기!

설치가 완료되면 셸을 새로고침하고 바로 시작하세요:

source ~/.bashrc   # 또는: source ~/.zshrc
hermes             # 채팅 시작!

나중에 설정을 변경하고 싶다면 전용 명령어가 있습니다:

hermes model          # LLM 제공업체와 모델 선택
hermes tools          # 활성화할 도구 구성
hermes gateway setup  # 메시징 플랫폼 설정
hermes config set     # 개별 구성 값 설정
hermes config get     # 개별 구성 값 확인
hermes setup          # 전체 설정 마법사 실행

가장 빠른 경로: Nous Portal

전문가 팁 하나 드리자면, 도구별 API 키를 관리하는 번거로움을 완전히 건너뛰고 싶다면 Nous Portal을 사용하세요. 하나의 구독으로 300개 이상의 모델과 Tool Gateway(웹 검색, 이미지 생성, TTS, 클라우드 브라우저)를 이용할 수 있습니다. 단 하나의 명령어로 모든 것이 설정됩니다:

hermes setup --portal

로그인, Nous를 제공업체로 설정, Tool Gateway 활성화까지 한 번에 처리됩니다.

다른 머신에서 이동하는 경우?

처음부터 다시 구축하지 마세요. hermes import로 전체 백업을 복원하거나, hermes profile import로 단일 에이전트를 가져올 수 있습니다. 참고로 프로필 내보내기에는 보안상 자격 증명이 포함되지 않으므로, 진정한 백업이 필요하다면 hermes backup을 사용하세요.

Nix 사용자를 위한 참고 사항

Nix는 더 이상 공식 지원 설치 경로가 아닙니다(최선의 노력만 제공). 이미 Nix를 사용 중이라면 flake와 NixOS 모듈이 포함된 전용 설정 가이드가 있습니다. Nix & NixOS 설정 문서를 확인하세요.

시스템 서비스로 실행하고 싶나요?

Hermes를 전용 비특권 사용자(예: hermes systemd 계정)로 실행하고 싶으신가요? 완전히 지원됩니다. 루트 권한이 필요한 유일한 단계는 Chromium 라이브러리를 위한 Playwright의 --with-deps뿐입니다. 설치 프로그램은 sudo 사용 가능 여부를 감지하여 적절하게 처리합니다.

이것으로 끝입니다! 이제 Hermes와 첫 대화를 나눌 준비가 되었습니다. 다음 튜토리얼에서는 첫 채팅 세션과 할 수 있는 모든 멋진 기능들을 살펴보겠습니다. 그때 만나요!