Hermes Agent 시작하기: 설치, 설정, 스킬 작성
요약
Nous Research가 개발한 오픈 소스 자율 에이전트인 Hermes Agent의 설치 및 설정 방법을 소개합니다. Hermes는 작업 과정을 '스킬'로 저장하고 학습하여 시간이 지날수록 더욱 유능해지는 자율적인 학습 루프를 특징으로 합니다.
핵심 포인트
- 자율 에이전트로서 작업 절차를 마크다운 형태의 '스킬'로 저장 및 재사용
- 사용 환경에 구애받지 않고 VPS, 홈 서버, 서버리스 등 어디서나 실행 가능
- OpenRouter, Anthropic, OpenAI 등 20개 이상의 LLM 제공업체 지원
- 학습 루프를 통해 지침을 스스로 패치하며 지속적으로 성능 개선
여러분은 아마 지금까지 AI 코딩 어시스턴트를 사용해 보셨을 것입니다. Copilot은 코드 라인을 완성해주고, Cursor는 함수를 다시 작성하며, Claude Code는 PR(Pull Request)의 디버깅을 도와줍니다. 이들은 모두 동일한 개념의 변형입니다. 즉, 에디터 내부에서 상주하며 더 빠르게 코드를 작성할 수 있도록 도와주는 AI입니다.
Hermes Agent는 조금 다릅니다. 이것은 코파일럿(copilot)이 아닙니다. Nous Research가 구축한 오픈 소스 자율 에이전트 (open-source autonomous agent)로, 스스로의 경험으로부터 학습하고, 즉석에서 재사용 가능한 스킬(skill)을 생성하며, 여러분이 배치하는 어디에서나 실행됩니다. 저렴한 VPS, 홈 서버, 또는 유휴 상태일 때 비용이 거의 들지 않는 서버리스 인프라 등 말이죠. 여러분이 SSH로 접속할 일도 없는 클라우드 VM에서 Hermes가 작업하는 동안, 여러분은 Telegram을 통해 대화할 수 있습니다. 이것은 여러분의 노트북에 종속되지 않습니다.
이 프로젝트가 217,000개의 GitHub stars를 보유한 데에는 이유가 있습니다. 이것이 실제로 무엇인지, 어떻게 약 1분 만에 실행할 수 있는지, 그리고 시도해 볼 만한 첫 세 가지 요소는 무엇인지 소개합니다.
Hermes Agent의 실체
Hermes Agent는 내장된 학습 루프 (built-in learning loop)를 가진 자율 에이전트입니다. 루프는 다음과 같이 작동합니다: 여러분과 Hermes가 까다로운 버그 수정, 배포 파이프라인 설정, 또는 새로운 도구 연결과 같이 사소하지 않은 무언가를 완수할 때마다, Hermes는 해당 절차를 **스킬 (skill)**로 저장할 수 있습니다. 스킬은 단순히 지침이 담긴 마크다운 (markdown) 파일일 뿐입니다. 다음에 유사한 작업이 발생하면, Hermes는 처음부터 방법을 찾아내는 대신 해당 스킬을 로드하고 플레이북 (playbook)을 따릅니다.
스킬은 사용하면서 점점 더 좋아집니다. 만약 스킬의 지침이 오래되었거나 단계가 누락되었다면, Hermes는 즉석에서 이를 패치합니다. 시간이 흐름에 따라, 여러분은 복리로 쌓이는 검증된 절차들의 라이브러리를 축적하게 됩니다. 이것이 Hermes를 챗봇 (chatbot)과 구분 짓는 지점입니다. Hermes는 단순히 질문에 답하는 것에 그치지 않고, 실행 시간이 길어질수록 더욱 유능해집니다.
내부적으로는 MIT 라이선스를 따르는 Python 프로젝트로, 사용자가 지정하는 어떤 LLM (Large Language Model) 제공업체와도 통신할 수 있습니다. OpenRouter, Anthropic, OpenAI, Google, DeepSeek 및 로컬 모델을 포함하여 20개 이상의 제공업체가 지원됩니다. 권장되는 설정 방식은 Nous Portal을 통하는 것입니다. 이를 통해 단 한 번의 OAuth 로그인과 통합된 청구 시스템을 이용할 수 있으며, 300개 이상의 모델과 웹 검색, 이미지 생성, TTS (Text-to-Speech), 브라우저 자동화를 위한 내장 도구에 접근할 수 있습니다. 하지만 선호에 따라 직접 API 키를 가져와 사용할 수도 있습니다.
설치 방법
설치 프로그램이 모든 과정을 처리합니다. macOS, Linux, WSL2 또는 Termux를 통한 Android의 경우:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows의 PowerShell에서는:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
설치 프로그램은 Python, Node.js, ripgrep, ffmpeg 및 Hermes에 필요한 기타 모든 요소를 가져옵니다. 저장소(repo)를 클론하고, 가상 환경(virtual environment)을 설정하며, hermes 명령어를 전역적으로 연결합니다. 이 모든 과정은 2분 미만으로 완료됩니다.
설치 후, 셸(shell)을 다시 로드하고 작동하는 에이전트를 만드는 가장 빠른 경로를 실행하세요:
hermes setup --portal
이 명령은 OAuth를 위한 브라우저를 엽니다. 한 번의 로그인으로 모델 접근 권한과 4가지 Tool Gateway 도구(웹 검색, 이미지 생성, TTS, 클라우드 브라우저)를 모두 사용할 수 있습니다. 여러 API 키를 관리할 필요가 없습니다. 완료되면 hermes라고 입력하기만 하면 대화를 시작할 수 있습니다.
macOS, Linux, Windows를 위한 네이티브 데스크톱 앱도 있습니다. hermes desktop으로 실행할 수 있습니다. 하지만 대부분의 사용자는 CLI (Command Line Interface)에서 시작합니다.
가장 먼저 시도할 것: 경험을 바탕으로 스킬 작성하기
스킬(Skills)은 Hermes가 실제로 제 역할을 해내는 핵심 요소입니다. Hermes가 작동하는 것을 확인하는 가장 빠른 방법은 다음과 같습니다.
Hermes를 사용하여 사소하지 않은 작업을 수행해 보세요. 프로젝트를 설정하거나, 도구를 구성하거나, 몇 차례의 턴 (turns)이 필요한 무언가를 디버깅하도록 요청해 보세요. 작업에 성공하면, Hermes는 해당 접근 방식을 스킬 (skill)로 저장할 것을 제안할 것입니다. '예'라고 답하세요. 이제 그 스킬은 지침 (instructions), 주의 사항 (pitfalls), 그리고 검증 체크리스트 (verification checklist)가 포함된 마크다운 (markdown) 파일 형태로 ~/.hermes/skills/에 저장됩니다.
다음에 당신(또는 해당 Hermes 인스턴스를 사용하는 다른 사람)이 동일한 종류의 작업에 직면했을 때, Hermes는 해당 스킬을 로드하고 플레이북 (playbook)을 따릅니다. 스킬은 내용이 틀렸을 때 패치 (patched)되고, 모호할 때 더 날카롭게 다듬어집니다. 몇 주 동안 정기적으로 사용하다 보면, 더 이상 같은 말을 반복할 필요가 없어집니다. Hermes는 당신의 프로젝트가 어떻게 구조화되어 있는지, 어떤 린터 (linter)를 선호하는지, 그리고 테스트를 어떻게 실행하는지를 기억합니다.
Skills Hub에는 Apple Notes 관리부터 LLM 미세 조정 (fine-tuning)에 이르기까지 모든 것을 다루는 88,000개 이상의 커뮤니티 스킬이 준비되어 있으며, 이 또한 설치할 수 있습니다. 설치된 모든 스킬은 /gif-search funny cats 또는 /axolotl fine-tune Llama 3와 같은 슬래시 명령어 (slash command)가 됩니다. Hermes는 필요할 때만 스킬의 지침을 로드하므로, 사용하지 않는 기능에 토큰 (tokens)을 낭비하지 않습니다.
두 번째: 메시징 플랫폼 연결하기
Hermes는 SSH로 접속해야 하는 도구가 아니라, 어디서든 대화할 수 있는 존재로 설계되었습니다. hermes setup --portal을 실행한 후, 메시징 게이트웨이 (messaging gateway)를 구성하세요:
hermes gateway setup
이 과정을 통해 Telegram, Discord, Slack, WhatsApp, Signal 또는 20개 이상의 지원 플랫폼 중 하나를 연결할 수 있습니다. 연결이 완료되면, Hermes가 어딘가에 있는 서버에서 오래 걸리는 작업을 처리하는 동안 당신은 휴대폰으로 Hermes에게 메시지를 보낼 수 있습니다. 작업이 완료되면 Hermes가 알림을 보내줍니다. 이 순간 Hermes는 단순한 터미널 도구처럼 느껴지는 것을 넘어, 곁에 두고 사용하는 에이전트 (agent)처럼 느껴지기 시작할 것입니다.
세 번째: 병렬 작업을 위한 서브 에이전트 (subagents) 생성하기
Hermes는 자체적인 컨텍스트 윈도우 (context windows)를 가지고 병렬로 실행되는 격리된 서브 에이전트 (subagents)에게 작업을 위임할 수 있습니다. 이는 상태 (state)를 공유할 필요가 없는 독립적인 작업들이 있을 때 유용합니다. 예를 들어, 한 서브 에이전트가 코드를 린트 (lint) 하는 동안 다른 서브 에이전트가 주제를 조사하거나, 동시에 세 개의 서로 다른 API를 확인할 수 있습니다.
대화 중에 Hermes에게 "X와 Y를 병렬로 조사해줘"라고 요청하기만 하면 서브 에이전트가 생성됩니다. 이들은 작업이 완료되면 결과를 보고합니다. 단순한 모델이지만, 다단계 워크플로 (multi-step workflows)가 순차적이지 않고 빠르게 느껴지게 만드는 요소입니다.
Copilot, Cursor, Claude Code와 무엇이 다른가
해당 도구들은 IDE 코파일럿 (copilots)입니다. 에디터 내부에서 코드를 더 빠르게 작성할 수 있도록 도와줍니다. Hermes는 당신이 배포하는 곳 어디에서나 상주하는 자율 에이전트 (autonomous agent)입니다. 표로 비교하면 다음과 같습니다:
| Copilot / Cursor / Claude Code | Hermes Agent | |
|---|---|---|
| 상주 위치 | 당신의 에디터 | 어디든 (VPS, server, Modal, Daytona) |
| ... |
더 빠른 자동 완성 (autocomplete)을 원한다면 Copilot을 사용하세요. 만약 당신의 스택 (stack)을 학습하고, 당신의 인프라 (infrastructure)에서 실행되며, 시간이 지날수록 더 유용해지는 에이전트를 원한다면 Hermes를 시도해 보아야 합니다.
저는 이전에 AI 에이전트가 읽기 쉬운 사이트 만들기와 WebMCP를 통해 에이전트가 사용할 수 있는 사이트 만들기에 대해 글을 쓴 적이 있습니다. Hermes는 그 방정식의 반대편에 있는 존재입니다. 해당 콘텐츠를 실제로 소비하고 그에 따라 행동할 수 있는 에이전트입니다. Hermes를 설치하고, 한 가지를 가르쳐 보세요. 그리고 그것이 점점 더 나아지는 과정을 지켜보십시오.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기