2. 설치 전 준비와 실행 환경 고르기

Hermes Agent 설치는 생각보다 어렵지 않습니다. 진짜 어려운 건 설치 명령어가 아니라, 어디에서 돌릴지를 먼저 제대로 고르는 일입니다. 이 선택이 맞으면 뒤의 설치는 술술 풀리고, 선택이 어긋나면 설치는 되더라도 곧바로 이런 일이 벌어집니다. 노트북을 덮는 순간 봇이 잠들고, Windows에서 바로 돌리려다 길을 잃고, Docker를 썼는데 메모리가 안 남고, VPS를 샀는데 사실 로컬이면 충분했던 상황 말입니다.

Hermes는 "한 번 실행해 보고 끝"인 도구보다, 계속 살아 있으면서 일하는 에이전트에 더 가깝습니다. 그래서 설치 전 환경 선택이 곧 사용 경험을 결정합니다. 이 장에서는 지원 운영체제와 기본 요구 사항을 먼저 정리하고, 로컬·WSL2·VPS·Docker 중 어떤 환경이 자신에게 맞는지 현실적으로 고르는 기준을 잡아보겠습니다.

왜 설치 전에 환경을 먼저 골라야 할까

Hermes는 단순한 채팅 앱이 아닙니다. 모델 API와 연결되고, 파일을 읽고, 터미널을 쓰고, 때로는 메신저 게이트웨이와 자동화 작업까지 맡습니다. 그러니 실행 환경은 단순한 "설치 장소"가 아니라, Hermes가 살아갈 작업실입니다.

작업실을 잘못 고르면 바로 불편이 생깁니다. 로컬 노트북에 설치해 놓고 24시간 돌아가길 기대하면 잠자기 모드가 문제를 일으키고, Windows 네이티브에서 바로 돌리려 하면 공식 지원 범위 밖에서 시간을 쓰게 됩니다. 반대로 처음부터 목적에 맞는 환경을 고르면 설치 오류, 운영 비용, 보안 리스크를 함께 줄일 수 있습니다.

특히 Hermes는 설치 스크립트가 많은 것을 자동으로 처리해 주기 때문에, 초보자일수록 "설치 자체"보다 "환경 선택"에 더 신경 쓰는 편이 좋습니다. 설치는 도구가 도와주지만, 내 용도에 맞는 선택은 결국 내가 해야 하니까요.¹

공식 지원 환경과 기본 조건

먼저 공식 기준부터 간단히 잡아보겠습니다. Hermes Agent의 주된 지원 운영체제는 Linux, macOS, WSL2입니다. Windows는 네이티브 환경보다 WSL2 안에서 실행하는 방식이 권장됩니다.¹³

쉽게 말해 이렇게 이해하면 됩니다.

설치 전에 알아둘 기본 조건도 있습니다. 공식 설치 문서 기준으로 필수 사전 조건은 Git이며, Python 3.11, Node.js, ripgrep, ffmpeg, uv 같은 구성 요소는 설치기가 자동으로 처리할 수 있습니다.¹ 그래서 "파이썬부터 직접 맞춰야 하나?" 하고 겁먹을 필요는 없습니다. 다만 Git이 없으면 출발선 자체에 못 서니, git --version 정도는 먼저 확인하는 편이 좋습니다.

네트워크도 중요합니다. GitHub에 접근할 수 있어야 하고, 나중에 연결할 모델 프로바이더 API에도 닿아야 합니다. 회사망이나 학교망처럼 제한이 있는 환경에서는 설치보다 접속 경로가 먼저 문제를 만들 수 있습니다.³

그리고 한 가지를 더 기억해야 합니다. Hermes는 어떤 모델이든 다 잘 쓰는 것이 아니라, 적어도 64K 이상의 컨텍스트 창을 가진 모델을 전제로 설계되어 있습니다. 너무 작은 컨텍스트 모델은 다단계 도구 호출과 긴 작업 흐름을 안정적으로 유지하기 어렵기 때문입니다.² 이 부분은 다음 장에서 자세히 다루겠지만, 실행 환경을 고를 때도 "나는 클라우드 모델을 쓸지, 로컬 모델을 붙일지"를 미리 생각해 두는 것이 좋습니다.

네 가지 실행 환경, 어떻게 다를까

이제 대부분의 사용자가 실제로 고민하는 네 가지 선택지를 보겠습니다. 로컬, WSL2, VPS, Docker입니다. 각각의 성격이 꽤 다릅니다.

로컬 환경: 가장 빠르게 시작하는 길

로컬 설치는 자신의 Mac이나 Linux PC에 Hermes를 직접 설치해 쓰는 방식입니다. 가장 큰 장점은 단순함입니다. 따로 서버를 준비할 필요도 없고, 비용도 거의 들지 않습니다. Hermes를 배우고, CLI에 익숙해지고, 메모리와 도구 사용을 가볍게 시험해 보기에는 가장 좋은 출발점입니다.⁴

특히 이런 사람에게 잘 맞습니다.

• 일단 오늘 안에 Hermes를 써 보고 싶은 사람

• 주 용도가 개발, 실험, 개인 워크플로우인 사람

• 서버 운영보다 로컬 터미널 사용이 더 익숙한 사람

하지만 단점도 분명합니다. 로컬 환경의 Hermes는 보통 내 컴퓨터가 켜져 있을 때만 살아 있습니다. 노트북을 덮으면 게이트웨이나 예약 작업도 같이 멈추기 쉽습니다. 즉, "내가 쓸 때는 좋지만, 내가 자는 동안 일하게 하긴 불편한 환경"이라고 보면 됩니다.

그래서 로컬 환경은 학습과 검증의 최적 해답이고, 상시 운영의 최종 해답은 아닌 경우가 많습니다. 처음엔 로컬로 시작하고, 나중에 VPS나 Docker로 옮기는 흐름이 꽤 자연스럽습니다.

WSL2: Windows 사용자의 가장 현실적인 정답

Windows 사용자는 여기서 시간을 아껴야 합니다. 결론부터 말하면, Windows를 쓴다면 WSL2가 기본 선택지입니다. 공식 문서도 네이티브 Windows 대신 WSL2 안에서 Hermes를 실행하는 경로를 안내하고 있습니다.¹³

WSL2는 Windows 안에 리눅스 작업실을 하나 따로 만드는 느낌입니다. Hermes는 유닉스 계열 환경에서 더 자연스럽게 동작하므로, WSL2는 Windows 사용자가 억지로 우회하지 않고 공식 흐름을 따라갈 수 있게 해 줍니다.

다만 WSL2라고 해서 아무 설정이나 다 되는 것은 아닙니다. 배포판은 Ubuntu 22.04 이상이 무난하고, WSL 자체도 최신 상태가 좋습니다. 설치 전에 WSL 업데이트와 기본 패키지 설치를 먼저 해 두면 시행착오를 줄일 수 있습니다.³

WSL2를 고르면 좋은 경우는 명확합니다. Windows를 메인 PC로 쓰지만, Hermes는 제대로 지원되는 환경에서 돌리고 싶은 경우입니다. 반대로 "나는 Windows GUI 안에서만 모든 걸 처리하고 싶다"는 기대가 크다면 처음엔 약간 낯설 수 있습니다. 그래도 장기적으로는 이쪽이 덜 고생합니다. Hermes 앞에서 억지를 부리면 보통 내가 집니다.

VPS: 24시간 살아 있는 Hermes가 필요할 때

VPS는 Hermes를 원격 서버에 올려 두고 상시 실행하는 방식입니다. 메신저 게이트웨이, 자동화 작업, 원격 접속, 장시간 실행이 중요하다면 가장 실용적인 선택입니다. 공식·커뮤니티 가이드들도 가벼운 VPS를 Hermes의 대표적인 운영 환경으로 자주 추천합니다.⁴

클라우드 모델을 사용하는 일반적인 개인 용도라면, 아주 비싼 서버가 꼭 필요한 것은 아닙니다. 자료에 따르면 가벼운 사용은 월 5달러 안팎의 VPS로도 충분하며, 운영체제는 Ubuntu 22.04 LTS나 Debian 12가 자주 추천됩니다.⁴ 다른 자료에서는 최소 2GB RAM, 10GB 디스크 정도로 시작할 수 있고, 여유 있게는 4GB RAM 이상이 더 낫다고 안내합니다.⁵

VPS의 장점은 분명합니다.

• 내 노트북 전원을 끄더라도 Hermes는 계속 살아 있다

• Telegram, Discord 같은 게이트웨이와 자동화 작업에 잘 맞는다

• 개인 PC보다 작업 환경이 깔끔하고 분리된다

대신 초보자에게는 로컬보다 조금 더 운영 감각이 필요합니다. SSH 접속, 기본 보안, 파일 백업, 서비스 재시작 같은 개념을 조금씩 배우게 됩니다. 하지만 "언제든 폰으로 Hermes를 부르고 싶다"거나 "매일 아침 자동 보고서를 돌리고 싶다"면, 결국 VPS가 가장 자연스럽습니다.

한편 로컬 LLM까지 서버에서 직접 돌리려면 얘기가 달라집니다. 예를 들어 큰 모델을 Ollama나 vLLM 같은 로컬 엔드포인트로 붙이려면 CPU, RAM, GPU 요구 사항이 급격히 올라갑니다. 이런 경우는 단순한 저가 VPS가 아니라 더 큰 인스턴스나 GPU 서버를 봐야 합니다.⁴ 즉, 클라우드 모델용 VPS와 로컬 모델용 VPS는 전혀 다른 난이도라고 이해하면 됩니다.

Docker: 격리와 재현성이 필요한 사람의 선택

Docker는 Hermes를 컨테이너 안에 넣어 돌리는 방식입니다. 가장 큰 장점은 격리입니다. 실행 환경을 일정하게 유지하기 좋고, 테스트 환경을 다시 만들기도 쉽습니다. 로컬 PC에서도, VPS에서도 Docker를 얹을 수 있습니다.⁴

Hermes처럼 터미널과 파일, 자동화를 다루는 도구는 편리한 만큼 신중함도 필요합니다. 그런 점에서 Docker는 "실수해도 작업 범위를 조금 더 좁힐 수 있는 보호막" 역할을 합니다. 특히 팀 환경이나 재현 가능한 배포가 중요한 사람에게 매력적입니다.

하지만 초보자에게는 함정도 있습니다. Docker는 설치만 하면 끝나는 마법 상자가 아닙니다. 볼륨 마운트, 권한, 네트워크, 컨테이너 재시작 같은 개념을 모르면 오히려 더 복잡하게 느껴질 수 있습니다. 예를 들어 ~/.hermes 같은 상태 디렉터리를 제대로 보존하지 않으면, 메모리와 설정이 날아간 것처럼 보일 수 있습니다. 컨테이너는 잘 떴는데 "왜 기억을 못 하지?" 하고 놀라는 장면이 여기서 자주 나옵니다.

그래서 Docker는 이런 경우에 잘 맞습니다. 보안을 조금 더 신경 쓰고 싶을 때, 로컬이나 VPS 환경을 깨끗하게 분리하고 싶을 때, 배포를 반복해서 재현해야 할 때입니다. 반대로 "나는 Docker를 아직 잘 모르고, 일단 Hermes부터 익히고 싶다"면 처음에는 로컬이나 VPS가 더 편할 수 있습니다.

그럼 나는 무엇을 고르면 될까

환경 선택은 성향보다 목적으로 고르면 쉽습니다. 아래 기준으로 생각해 보세요.

한 줄 추천도 가능합니다.

처음 배우는 사람은 로컬 또는 WSL2로 시작하세요. 계속 켜 두고 싶은 사람은 VPS로 가세요. 보안과 격리를 더 챙기고 싶다면 그 위에 Docker를 얹으세요.

즉, Docker는 로컬·VPS와 경쟁하는 완전히 별개의 세계라기보다, 그 위에 추가하는 운영 방식으로 생각하면 이해가 쉽습니다.

설치 전에 꼭 점검할 것들

환경을 골랐다면 설치 전에 아래 항목을 확인해 두는 것이 좋습니다.

• Git이 설치되어 있는가: Hermes 설치기의 사실상 유일한 필수 사전 조건입니다.¹

• 네트워크가 GitHub와 모델 API에 닿는가: 회사망, 학교망, 프록시 환경에서는 이 부분이 먼저 막힐 수 있습니다.³

• 셸 환경을 이해하고 있는가: 설치 후 source ~/.bashrc 또는 source ~/.zshrc처럼 셸 재로딩이 필요할 수 있습니다.¹

• 항상 켜 둘 필요가 있는가: 필요하다면 로컬보다 VPS가 맞습니다.

• Windows 사용자인가: 그렇다면 WSL2를 먼저 준비하는 편이 훨씬 빠릅니다.³

• 어떤 모델을 붙일 것인가: 클라우드 모델인지, 로컬 모델인지에 따라 요구 자원이 크게 달라집니다.²⁴

여기서 중요한 건 "설치가 되느냐"보다 "설치 뒤의 운영이 편하냐"입니다. 오늘 10분 아끼려다가 매일 30분씩 고생하는 선택은 좋은 선택이 아닙니다.

많이 하는 실수들

처음 설치할 때 자주 나오는 실수도 미리 알고 가면 좋습니다.

첫째, Windows 네이티브에서 바로 해결해 보려는 시도입니다. 가능성보다 시행착오가 앞서기 쉽습니다. Windows 사용자라면 WSL2를 기본 경로로 잡는 편이 낫습니다.³

둘째, 노트북 로컬 설치를 해 놓고 24시간 자동화를 기대하는 것입니다. Hermes는 상주형 에이전트에 가깝기 때문에, 운영 환경이 잠들면 Hermes도 같이 조용해집니다.

셋째, Docker를 쓰면서 상태 저장을 가볍게 보는 것입니다. 컨테이너는 잘 지워지고 잘 다시 만들어지는 대신, 그 안의 데이터는 신경 써서 보존해야 합니다. Hermes의 메모리와 설정은 대충 굴려도 저절로 살아남는 종류가 아닙니다.

넷째, 로컬 LLM을 쉽게 보는 것입니다. 모델을 직접 돌리는 순간 이야기가 달라집니다. 컨텍스트 크기, RAM, VRAM, 추론 속도까지 모두 현실적인 제약으로 돌아옵니다. 특히 Hermes는 최소 64K 컨텍스트를 요구하므로, 작은 모델을 억지로 붙이면 설치보다 사용 단계에서 더 빨리 벽을 만납니다.²

추천 시작 시나리오

아예 선택이 안 된다면, 아래 세 가지 출발점 중 하나를 고르면 됩니다.

가장 무난한 시작

Mac이나 Linux를 쓰는 개인 사용자라면 로컬 설치가 가장 무난합니다. Hermes CLI를 배우고, 모델 연결을 해 보고, 도구와 세션 관리에 익숙해지기 좋습니다.

Windows 사용자의 정석

Windows 메인 사용자라면 WSL2 + Ubuntu가 가장 안전합니다. Windows를 버리는 게 아니라, Hermes에게 맞는 작업방을 따로 마련해 주는 셈입니다.

오래 함께 일할 에이전트가 필요할 때

메신저 봇, 예약 작업, 상시 실행이 목표라면 처음부터 VPS를 선택하는 편이 오히려 빠릅니다. 하루 체험은 로컬이 편하지만, 한 달 운영은 VPS가 더 편한 경우가 많습니다.

핵심 정리

Hermes Agent 설치에서 가장 중요한 첫 결정은 설치 명령어가 아니라 실행 환경 선택입니다.

공식적으로는 Linux, macOS, WSL2가 가장 안정적인 길이고, Windows 사용자는 WSL2를 기본값으로 생각하는 편이 좋습니다.¹³ Git만 준비되면 나머지 주요 의존성은 설치기가 도와주지만, 네트워크와 셸 환경, 그리고 나중에 연결할 모델의 컨텍스트 조건은 미리 염두에 두어야 합니다.¹²

로컬은 가장 빠른 시작점이고, WSL2는 Windows 사용자의 현실적인 해답이며, VPS는 늘 켜 두는 운영에 강하고, Docker는 격리와 재현성에 강합니다. 이 네 가지의 차이를 이해하면 이후 설치 과정에서 겪을 오류와 운영 비용을 크게 줄일 수 있습니다.

한마디로 정리하면 이렇습니다.

짧게 시험하려면 로컬, Windows라면 WSL2, 오래 굴리려면 VPS, 조심스럽게 굴리려면 Docker.

이 기준만 잡혀도 다음 장의 설치 과정은 훨씬 덜 헷갈립니다.

참고

¹Installation | Hermes Agent

²Quickstart | Hermes Agent

³Installation Guide | Hermes Agent

⁴How to Set Up Hermes Agent

⁵Self-Host Hermes Agent on a VPS: Step-by-Step Guide