안녕하세요.
오늘은 오픈소스 AI 에이전트인 Hermes Agent를 Ubuntu 26.04에 설치하는 방법에 대해 알아보려고 합니다.
Hermes Agent란?
AI 비서를 내 로컬 환경에서 직접 구동할 수 있는 도구입니다. 자체 메모리 관리, 스킬 시스템, 메신저 연동 등 다양한 기능을 제공합니다.
필요한 사항
LLM API 키 (OpenAI, Anthropic Claude, OpenRouter 등)
1. Hermes Agent 설치
설치 방법은 3가지가 있습니다. (흰 박스 내부는 모두 bash 명령어)
방법 1: 원라이너 설치 (권장)
curl -fsSLO https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh
bash install.sh
방법 2: pipx로 설치
pipx install hermes-agent
방법 3: Docker로 설치
docker run --rm -it \
-v ~/.hermes:/root/.hermes \
-e OPENAI_API_KEY=$OPENAI_API_KEY \
nousresearch/hermes-agent:latest
2. 설치 확인
hermes --version
버전이 정상적으로 출력되면 설치 완료입니다.
추가로 시스템 진단도 실행해봅니다.
hermes doctor
`hermes doctor`는 의존성 누락이나 설정 오류가 있는지 자동으로 진단해줍니다.
3. 설정하기
3-1. 대화형 마법사 사용
hermes config
실행 후 나오는 질문에 답변만 하면 됩니다. 사용할 LLM 프로바이더, API 키, 모델 등을 설정합니다.
3-2. 수동 설정
# 프로바이더 설정
hermes config set provider openai
# 모델 설정
hermes config set model gpt-4o
# API 키 설정
hermes config set openai_api_key sk-xxxxxxxx
4. 실행하기
hermes run
정상적으로 연결되면 Hermes Agent와 대화가 가능한 프롬프트가 나타납니다.
5. 주요 기능
5-1. 자가 개선 학습 루프
Hermes는 대화를 진행할수록 패턴을 학습합니다. 주기적으로 대화 내용을 검토하여 스킬이나 메모리로 저장합니다.
5-2. 스킬 시스템
작업 수행 방법을 Markdown 파일로 저장하여 재사용할 수 있습니다.
5-3. 메시징 게이트웨이
Discord, Telegram, Slack, WhatsApp 등 15개 이상의 플랫폼과 연동 가능합니다.
5-4. MCP 통합
Model Context Protocol 서버를 연결하여 외부 도구를 확장할 수 있습니다.
5-5. 스케줄 자동화 (Cron)
내장 cron 기능으로 작업을 예약하고 결과를 메시징 채널로 전달합니다.
5-6. 런타임 백엔드
local, Docker, SSH, Daytona, Singularity, Modal 등 6가지 실행 환경을 지원합니다.
7. 자주 발생하는 오류
7-1. pipx 관련 오류
# pipx 재설치
pipx uninstall hermes-agent
pipx install hermes-agent
7-2. API 연결 오류
# 설정 확인
hermes config show
# API 키 재설정
hermes config set model.api_key [새로운키]
이상으로 Ubuntu 26.04에서 Hermes Agent를 설치하는 방법에 대해 알아보았습니다.
설치 과정은 매우 간단하지만, 다양한 LLM과 연동하여 강력한 AI 에이전트로 활용할 수 있다는 점이 큰 장점입니다.
공식 문서에서 더 자세한 내용을 확인할 수 있습니다.
참고 URL : https://hermes-ai.net/ko/docs/quickstart/
감사합니다.
댓글