헤르메스 에이전트

OPEN SOURCE · MIT LICENSE

Nous Research MIT 라이선스 공개 저장소

컴퓨터 한 대를 24시간 일하는 에이전트로 만듭니다

헤르메스(Hermes Agent)는 Nous Research가 공개한 오픈소스 자율 에이전트입니다. 내 맥이나 윈도우, 빌려 둔 서버에 직접 설치해 두고 그 안에서 클로드나 ChatGPT 같은 모델을 골라 붙여 씁니다. 터미널에서 부를 수도 있고 텔레그램이나 슬랙에서 말을 걸 수도 있습니다. 라이선스가 MIT라 프로그램 자체는 무료입니다. 돈은 붙여 쓴 모델 사용료에만 듭니다.

Nous Research가 만들었고 이름은 이 회사 모델에서 왔습니다

Nous Research

2023년 설립 · 뉴욕 · 오픈소스 AI 연구소

Nous Research는 2023년 제프리 퀘스넬을 비롯한 연구자들이 만든 뉴욕의 오픈소스 AI 연구소입니다. 모델 가중치를 공개하는 회사로 이름을 알렸습니다. 허깅페이스에 올린 Hermes 모델 계열이 대표작입니다. 헤르메스 에이전트는 이 회사가 2026년 3월에 처음 내놓은 MIT 라이선스 오픈소스 프로그램입니다.

오픈클로(OpenClaw)와는 무엇이 다른가. 메신저로 부르고 내 기기에 상주하는 개인 에이전트라는 발상을 먼저 크게 퍼뜨린 쪽은 오픈클로입니다. 두 프로그램은 하는 일이 상당히 겹칩니다.

데스크톱 앱을 설치하는 것이 가장 쉽습니다

공식 사이트에서 설치 프로그램을 받아 실행하면 데스크톱 앱과 터미널 명령이 한꺼번에 깔립니다. 터미널을 열 일이 없다면 여기서 끝내도 됩니다.

명령줄이 편하거나 리눅스와 서버에 올릴 때는 설치 스크립트를 씁니다. 스크립트가 파이썬 3.11, Node.js, ripgrep, ffmpeg 같은 준비물을 알아서 깔고 저장소를 받아 옵니다. 미리 챙길 것은 Git 하나입니다. 리눅스라면 curl과 xz-utils도 함께 있어야 합니다.

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

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

클로드나 ChatGPT 등을 연결합니다

붙이는 방법은 두 가지입니다. 이미 내고 있는 구독 계정으로 로그인하거나, API 키를 발급받아 넣습니다. 어느 쪽이든 hermes model을 실행하면 화면이 순서대로 물어봅니다.

hermes setup              # 처음 한 번, 전체 설정 안내
hermes model              # 제공사와 모델 고르기
hermes config get model   # 지금 무엇이 붙어 있는지 확인
hermes tools              # 쓸 도구 켜고 끄기

API 키를 발급받는 순서. 처음이라면 hermes setup이 순서대로 안내합니다. 모델만 바꾸고 싶으면 hermes model을 씁니다. 목록에서 제공사를 고르면 구독 로그인은 브라우저를 열고 API 키 방식은 키를 물어봅니다. 입력한 키는 ~/.hermes/.env에, 나머지 설정은 ~/.hermes/config.yaml에 알아서 나뉘어 저장됩니다.

텔레그램이나 슬랙에서 말을 걸게 만듭니다

게이트웨이를 한 번 설정해 두면 메신저에서 부르는 즉시 답이 옵니다. 공식 대시보드 기준 스물일곱 개 채널을 붙일 수 있고, 그중 손이 가장 덜 가는 쪽이 텔레그램입니다.

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

# 여러 명이 쓰려면 쉼표로 이어 적습니다

같은 hermes gateway setup 화면에서 고르기만 하면 됩니다. 회사에서 슬랙이나 팀즈를 쓴다면 그쪽이 자연스럽습니다.

늘 켜 두는 컴퓨터 한 대를 상주 서버로 씁니다

에이전트에게 메신저로 말을 걸거나 예약한 일을 돌리려면 게이트웨이 프로세스가 떠 있어야 합니다. 맥미니든 데스크톱이든, 책상 밑에 늘 켜 두는 컴퓨터가 한 대 있다면 거기에 올리는 편이 가장 간단합니다. 네 단계면 끝납니다.

hermes gateway start     # 지금 켜기
hermes gateway status    # 잘 떠 있는지 확인

tail -f ~/.hermes/logs/gateway.log   # 기록 들여다보기

서버를 빌려 도커로 올립니다

집이나 사무실에 늘 켜 둘 기기가 없거나 정전과 인터넷 사정에 휘둘리기 싫다면, 서버를 빌려 도커로 띄웁니다. 공식 이미지는 nousresearch/hermes-agent입니다.

어디서 빌리나. 한국에서 많이 쓰는 곳 네 군데입니다. 아래는 모두 메모리 2GB 기준 요금입니다. 서울에 데이터센터가 있으면 응답이 조금 더 빠릅니다.

mkdir -p ~/.hermes

docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent setup

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes
    restart: unless-stopped
    command: gateway run
    ports:
      - "8642:8642"
    volumes:
      - ~/.hermes:/opt/data

docker compose up -d
docker compose logs -f

내 컴퓨터와 빌린 서버, 무엇을 고를지

두 방식의 차이는 성능이 아니라 무엇까지 내가 책임지느냐입니다. 다뤄야 할 자료가 어디에 있는지부터 보십시오.

붙이기 전에 걸어 둘 안전장치는 세 가지입니다. 세 가지를 걸어 둔 뒤에는 에이전트에게 직접 "지금 이 설정이 안전한지, 그렇게 보는 이유가 무엇인지 알려 줘"라고 물어보십시오. 키가 그대로 드러나 있는지, 방화벽이 잘못 열려 있는지 스스로 짚어 줍니다.

용어 설명