헤르메스 에이전트 뭔가요? 스스로 배우는 AI 에이전트를 2026 기준으로 처음부터 쉽게 설명
퀀텀점프클럽 정상록13분 읽기1 views헤르메스 에이전트 뭔가요? 스스로 배우는 AI 에이전트를 2026 기준으로 처음부터 쉽게 설명
헤르메스 에이전트: Nous Research가 만든 오픈소스(누구나 공짜로 쓰고 고칠 수 있게 공개된 소프트웨어) AI 에이전트(스스로 판단해 작업을 처리하는 AI)예요. 쓰면서 배운 내용을 기억하고, 작업 절차를 스스로 쌓아 간다는 점이 특징이에요.
이름은 들어봤지만 정확히 뭔지 모르겠다면 잘 찾아오셨어요. 이 글을 끝까지 읽으면 헤르메스 에이전트가 무엇이고, 무료인지, 설치하기 전에 무엇을 준비해야 하는지 내 말로 설명할 수 있게 돼요. 읽는 데 10분 정도 걸려요.
헤르메스 에이전트는 무엇인가요?
헤르메스 에이전트는 AI에게 일을 시키는 프로그램이에요. 챗봇이 질문에 글로 답하는 데서 멈춘다면, 에이전트는 파일을 열고 명령을 실행하는 도구까지 직접 써서 일을 끝내요. 비서에게 "자료 찾아서 정리해 줘"라고 맡기는 것과 비슷해요.
공식 README(프로젝트 첫 안내 문서)는 첫 줄에서 이 프로그램을 "The self-improving AI agent built by Nous Research"라고 소개해요. "Nous Research가 만든, 스스로 나아지는 AI 에이전트"라는 뜻이에요.
여기서 "스스로 나아진다"는 말은 구체적인 기능을 가리켜요. README에 따르면 헤르메스는 경험에서 스킬(특정 작업의 절차를 적어 둔 문서)을 만들고, 쓰는 동안 그 스킬을 고치고, 지난 대화를 검색하고, 대화가 쌓일수록 사용자를 더 잘 파악해요.
공식 GitHub 저장소 정보도 확인했어요. 2026년 10월 11일 확인 기준 별(마음에 든다는 표시) 수는 252,535개이고, 저장소가 만들어진 날은 2025년 7월 22일이에요. 가장 최신 릴리스는 2026년 10월 8일에 나온 v0.21.6이에요. 별 수는 관심의 신호일 뿐 품질을 보증하는 숫자는 아니고, 읽는 날에는 숫자가 달라져 있을 수 있어요.
누가 만들었고 무료인가요?
헤르메스 에이전트는 Nous Research가 만들었어요. 공식 GitHub 저장소 기준 라이선스(소프트웨어를 쓰는 조건을 적은 약속)는 MIT예요. MIT 라이선스는 누구나 소프트웨어를 받아 쓰고 고칠 수 있게 허용하는 조건이라, 프로그램 자체는 무료로 받아 쓸 수 있어요.
다만 무료는 프로그램까지예요. 헤르메스는 연결한 AI 모델에게 일을 시키는 구조라서, 그 모델을 쓰는 비용은 따로 들어요. 공식 빠른 시작 문서가 소개하는 연결 방법은 이런 것들이에요.
- Nous Portal 구독: 구독하면 300개 이상의 모델 중에서 고를 수 있다고 안내해요. 구독 가격은 공식 페이지에서 확인하세요.
- ChatGPT(OpenAI가 만든 대화형 AI)·Codex 구독: 화면에 뜬 기기 코드를 브라우저에 입력하는 방식으로 로그인해서 OpenAI Codex 모델을 써요.
- Anthropic(클로드를 만든 회사): Max 요금제와 추가 사용 크레딧으로 로그인하거나, API(프로그램끼리 정보를 주고받는 창구) 키를 써요. 서비스에 접속하기 위한 비밀번호 같은 문자열이에요. API 키 방식은 쓴 만큼 요금이 붙어요.
README는 "Run it on a $5 VPS, a GPU cluster, or serverless infrastructure that costs nearly nothing when idle"라고 적어 놓았어요. 5달러짜리 VPS(빌려 쓰는 인터넷 위의 작은 컴퓨터)부터 큰 연산 설비까지, 그리고 쓰지 않을 때는 거의 돈이 들지 않는 환경에서도 돌릴 수 있다는 뜻이에요.
여기서 $5는 헤르메스의 가격이 아니에요. README가 헤르메스를 올려 둘 서버 비용 수준을 예로 든 숫자예요. 소프트웨어는 무료이고, 서버를 빌리면 서버 비용이 들고, AI 모델 사용료는 또 따로라고 나눠서 생각하면 돼요.
챗GPT 같은 챗봇과 무엇이 다른가요?
챗GPT 같은 챗봇은 대화창에서 질문하고 답을 받는 데 초점이 있어요. 공식 소개를 기준으로 헤르메스가 다른 점은 네 가지예요.
- 기억을 파일로 남겨요. 공식 메모리 문서에 따르면 에이전트의 메모
MEMORY.md는 2,200자, 사용자 프로필USER.md는 1,375자가 한도예요. 한도를 넘으면 자동으로 압축하지 않고 오류를 내요. 무작정 쌓아 두는 창고보다 핵심만 적는 메모장에 가까워요. - 스킬이 쌓여요. 스킬은 특정 작업의 절차를 적은
SKILL.md문서이고~/.hermes/skills/폴더에 저장돼요. 설치한 스킬은 슬래시 명령(채팅창에서/로 시작해 부르는 짧은 명령)이 돼요. 공식 스킬 문서는 에이전트가 스킬을 직접 만들고 고칠 수 있다고 설명해요. - 서버에서 계속 일해요. README는 "talk to it from Telegram while it works on a cloud VM"이라고 적어요. 클라우드 서버에서 일하게 두고 텔레그램(메신저 앱)으로 말을 걸 수 있다는 뜻이에요. 게이트웨이(메신저 앱과 에이전트를 이어 주는 중계 프로그램) 하나로 Telegram, Discord, Slack, WhatsApp, Signal, CLI(글자로 명령을 입력하는 화면)까지 6곳에서 대화할 수 있어요.
- AI 모델을 갈아 끼워요.
hermes model명령으로 모델 제공자를 바꿀 수 있어요. README는 이를 "no code changes, no lock-in"이라고 표현해요. 코드를 고치지 않아도 되고 한 곳에 묶이지 않는다는 뜻이에요.
어떤 일을 맡길 수 있나요?
README에 따르면 내장 cron(정해진 시각에 일을 자동으로 시키는 예약 기능)이 있어요. "Daily reports, nightly backups, weekly audits"처럼 일간 보고서, 야간 백업, 주간 점검 같은 일을 자연어로 말해 두면 사람이 없어도 돌아가요. 결과를 받을 메신저도 고를 수 있어서, 매일 아침 보고서를 텔레그램으로 받아 보는 식의 사용이 가능해요.
README의 기능 표는 내장 도구가 40개 이상이라고 안내해요. 여러 작업을 나눠 맡기는 하위 에이전트(subagent)도 만들 수 있어요. 처음부터 이걸 다 쓸 필요는 없어요. 공식 빠른 시작 문서는 "if Hermes cannot complete a normal chat, do not add more features yet"라고 권해요. 기본 대화가 제대로 되기 전에는 기능을 더 얹지 말라는 뜻이에요.
터미널 실행 환경은 7가지예요
터미널(글자로 명령을 입력하는 창) 실행 환경은 에이전트가 명령을 실행할 장소를 정하는 설정이에요. README가 나열한 7가지는 local(내 컴퓨터), Docker(프로그램을 격리된 상자 안에서 돌리는 도구), SSH(원격 컴퓨터에 접속하는 방법), Singularity, Modal, Daytona, Vercel Sandbox예요. 뒤의 넷은 처음에는 몰라도 돼요. 일단 local로 시작하면 돼요.
설치하려면 무엇이 필요한가요?
설치 자체는 명령 한 줄이지만, 그 앞에서 확인할 것이 몇 가지 있어요.
-
운영체제를 확인해요. 공식 플랫폼 문서가 1등급으로 지원하는 환경은 4가지예요. macOS(Apple Silicon), Windows 10/11, Linux/WSL2(윈도우 안에서 리눅스를 쓰게 해 주는 기능), Docker예요. Intel 맥은 DMG 설치 프로그램이 동작하지 않아서 Intel용 데스크톱 묶음을 받거나 명령어 설치 방법을 써야 해요. macOS와 Windows는 Hermes Desktop 설치 프로그램이 권장 경로라서, 터미널이 부담스럽다면 공식 사이트에서 내려받아 실행하는 쪽이 쉬워요.
-
터미널을 열고 설치 명령을 붙여넣어요. 아래는 macOS, Linux, WSL2용 명령이에요. 설치 스크립트를 내려받아 바로 실행해 주는 한 줄이에요.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
이 설치 스크립트는 Git, curl, tar, SHA-256 확인 도구가 이미 있다고 가정해요. 파일을 내려받고, 풀고, 변조되지 않았는지 확인하는 기본 도구들이에요. Windows는 PowerShell(윈도우용 명령 창)에서 아래 명령을 실행해요. 같은 일을 하는 Windows용 한 줄이에요.
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
- 터미널이 새 명령을 알아보게 해요. 설치 직후에는 터미널이 새로 깔린
hermes명령의 위치를 모르는 경우가 있어요. 아래 명령은 설정을 다시 읽게 한 다음 헤르메스를 실행해요. zsh를 쓰면~/.zshrc, bash를 쓰면~/.bashrc로 바꿔요.
source ~/.zshrc
hermes
- AI 모델을 고르고 컨텍스트를 확인해요. 첫 설정에서
hermes setup을 실행하면 3가지 모드를 보여 줘요. Quick Setup(Nous Portal로 로그인하는 가장 빠른 길), Full Setup(제공자와 도구를 하나씩 직접 고르는 길), Blank Slate(꼭 필요한 것만 켜고 시작하는 길)예요. 이미 쓰는 서비스가 있다면 아래 명령으로 모델 제공자를 고를 수 있어요.
hermes model
공식 빠른 시작 문서에 따르면 연결하는 모델은 컨텍스트가 최소 64,000토큰(64K)이어야 하고, 그보다 작은 모델은 시작할 때 거부돼요. 토큰은 AI가 글을 잘라 읽는 단위예요. 클라우드로 쓰는 대형 모델은 대부분 이 조건을 쉽게 넘는다고 문서가 안내해요. 내 컴퓨터에서 돌리는 로컬 모델이라면 컨텍스트를 65536 이상으로 직접 맞춰야 해요.
- 첫 대화로 확인해요. 위의
hermes로 열린 화면에서 간단한 질문 하나를 던져 보세요. 답이 정상으로 오면 준비가 끝난 거예요. 공식 문서는 설치부터 첫 대화까지 5분 안쪽을 기준으로 잡아요.
비밀값(API 키 같은 것)은 ~/.hermes/.env 파일에, 일반 설정은 ~/.hermes/config.yaml 파일에 저장된다고 공식 문서가 설명해요. 이 두 파일의 위치만 알아 두면 설정을 고칠 일이 생겼을 때 헤매지 않아요.
안전한가요?
에이전트는 내 컴퓨터에서 명령을 실행할 수 있어서, 안전 장치가 어떻게 돼 있는지 아는 게 중요해요. 공식 보안 문서에 따르면 위험한 명령은 실행 전에 확인을 거치고, 그 승인 모드는 3가지예요.
- smart(기본값): 위험도를 따져서 가벼운 명령은 통과시키고, 정말 위험한 명령은 자동으로 막고, 애매한 경우는 사람에게 물어요.
- manual: 위험한 명령이 나올 때마다 사용자에게 승인을 요청해요.
- off: 모든 확인을 꺼요. 공식 문서도 믿을 수 있는 환경에서만 쓰라고 경고해요.
처음에는 기본값 smart를 바꾸지 않는 편이 안전해요. 클라우드 모델을 연결하면 대화 내용이 그 서비스로 전달된다는 점도 기억해 두세요. 버전 번호가 0.21.6으로 아직 1.0 전이라서 명령이나 기본값이 바뀔 수 있다고 생각하고 쓰는 게 좋아요.
처음 하면 여기서 막힙니다
공식 빠른 시작 문서의 "자주 막히는 지점" 표와 설치 안내, README의 문제 해결 항목에서 뽑았어요. 증상, 원인, 해결 순서로 적었어요.
- 열리긴 하는데 답이 비거나 이상해요. 제공자 로그인이나 모델 선택이 잘못된 경우예요.
hermes model을 다시 실행해서 제공자, 모델, 인증을 확인하세요. - 게이트웨이는 켜졌는데 봇에 메시지가 안 가요. 봇 토큰(봇을 증명하는 열쇠), 허용 사용자 목록, 플랫폼 설정이 덜 끝난 경우예요.
hermes gateway setup을 다시 실행하고hermes gateway status로 확인하세요. hermes --continue가 이전 대화를 못 찾아요. 프로필이 바뀌었거나 대화가 저장되지 않은 경우예요.hermes sessions list로 대화 목록을 확인하세요.- 로컬 모델이 시작할 때 거부돼요. 컨텍스트가 64K보다 작은 경우예요. 컨텍스트를 65536 이상으로 올리세요.
- 설치 직후
hermes명령을 못 찾아요. 터미널이 새 경로를 아직 읽지 않은 경우예요.source ~/.zshrc를 실행하세요. - Windows 백신이
uv.exe를 악성으로 잡아요. 서명이 없는 Rust 실행 파일이 오탐(잘못 잡힘)되는 경우예요. 폴더 단위로 예외를 등록하세요.
그래도 안 풀리면 공식 문서가 권하는 6단계 복구 순서를 그대로 따라 보세요. hermes doctor, hermes model, hermes setup, hermes sessions list, hermes --continue, hermes gateway status 순서예요. 맨 앞의 hermes doctor는 설정 문제를 진단해 주는 명령이에요.
마무리
'헤르메스 에이전트 뭔가요'를 검색해 오셨다면, 한 줄로 Nous Research가 만든 스스로 배우는 오픈소스 AI 에이전트예요. 기억과 스킬이 쌓이고, 서버에서 일하면서 텔레그램으로 대화할 수 있다는 점이 챗봇과 가장 달라요. 소프트웨어는 MIT 라이선스라 무료이지만, 연결하는 AI 모델 사용료와 서버 비용은 따로 생각해야 해요.
처음에는 기능을 욕심내지 말고 hermes로 열린 화면에서 기본 대화가 되는지부터 확인해 보세요. 그다음에 게이트웨이와 예약 작업을 하나씩 얹으면 훨씬 덜 막혀요.
관련 글
자주 묻는 질문
헤르메스 에이전트는 무료인가요?
프로그램 자체는 MIT 라이선스라 무료로 받아 쓸 수 있어요. 다만 연결하는 AI 모델의 사용료는 별도예요. Nous Portal 구독 가격은 공식 페이지에서 확인하세요. README에 나온 $5는 서버를 빌리는 비용의 예시이지 헤르메스의 가격이 아니에요.
코딩을 전혀 몰라도 쓸 수 있나요?
터미널에서 명령을 입력하는 단계가 있어서 처음에는 조금 낯설 수 있어요. macOS와 Windows는 Hermes Desktop 설치 프로그램이 권장 경로라서, 공식 사이트에서 내려받아 실행하면 명령어 설치보다 부담이 적어요.
어떤 AI 모델을 연결할 수 있나요?
Nous Portal, OpenRouter, OpenAI, 직접 연 주소(자체 엔드포인트) 등을 연결할 수 있고 hermes model로 바꿀 수 있어요. 어떤 모델이든 컨텍스트가 64K 이상이어야 시작할 때 거부되지 않아요.
노트북을 꺼도 계속 일하나요?
헤르메스를 클라우드 서버에 설치해 게이트웨이를 켜 두면 노트북과 상관없이 서버에서 일해요. README도 "It's not tied to your laptop"이라고 적어요. 노트북에 묶이지 않는다는 뜻이에요. 반대로 내 노트북에만 설치했다면 그 노트북이 꺼질 때 같이 멈춰요.
OpenClaw를 쓰던 사람은 옮겨 올 수 있나요?
네, hermes claw migrate 명령으로 OpenClaw에서 옮겨 올 수 있다고 README가 안내해요. OpenClaw를 쓴 적이 없다면 이 명령은 건너뛰어도 돼요.
