Hermes Agent 설치부터 기본 세팅까지: 맥·윈도우 가능 여부 정리

AI 강좌

김하나

Hermes Agent 는 터미널, 메신저, IDE에서 사용할 수 있는 오픈소스 AI 에이전트입니다. 단순 채팅보다 한 단계 더 나아가 파일 확인, 터미널 실행, 브라우저 제어, 정기 작업, 메신저 응답 같은 실제 작업을 맡길 수 있습니다. 이번 글에서는 Hermes Agent를 처음 설치하고 기본 세팅하는 흐름을 macOS와 Windows 기준으로 정리합니다. 1. Hermes Agent로 할 수 있는 일 터미널에서 대화형 AI 에이전트 실행 파일 읽기/쓰기, 명령 실행, 코드 점검 같은 개발 보조 Telegram, Slack, Discord 등 메신저에서 업무 처리 메모리와 스킬을 통해 반복 업무 절차 저장 cron job으로 정기 리포트나 점검 자동화 OpenRouter, Anthropic, OpenAI, Gemini, DeepSeek, 로컬 모델 등 다양한 모델 제공자 사용 2. 윈도우에서도 가능한가? 가능합니다. 다만 Windows에서는 WSL2 Ubuntu 환경 에서 쓰는 방식이 가장 안정적입니다. macOS : 바로 설치해서 쓰기 좋습니다. 맥 사용자에게 가장 무난합니다. Linux : 서버나 VPS에서 상시 운영하기 좋습니다. Windows : WSL2 Ubuntu 안에서 설치하면 Linux와 비슷하게 사용할 수 있습니다. Hermes는 터미널, 파일 시스템, 백그라운드 서비스, 여러 CLI 도구와 자주 연결됩니다. 그래서 Windows 네이티브 환경보다 WSL2가 문제를 줄이기 좋습니다. 3. 설치 전 준비물 macOS, Linux, 또는 Windows WSL2 터미널 사용 환경 모델 제공자 API 키 또는 OAuth 로그인 예: OpenRouter, Anthropic, OpenAI, Gemini, DeepSeek 등 처음 테스트할 때는 여러 모델을 한 번에 고를 수 있는 OpenRouter나, 이미 쓰고 있는 OpenAI/Anthropic 계정으로 시작하면 편합니다. 4. macOS에서 설치하기 터미널을 열고 아래 명령어를 실행합니다. curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 설치 후 터미널을 새로 열거나 셸 설정을 다시 불러옵니다. source ~/.zshrc 이제 Hermes를 실행합니다. hermes 5. Windows에서 설치하기: WSL2 사용 먼저 PowerShell에서 WSL2를 설치합니다. wsl --install 설치 후 재부팅이 필요할 수 있습니다. Ubuntu 터미널이 열리면 그 안에서 아래 명령어를 실행합니다. curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 설치 후 bash 설정을 다시 불러오거나 Ubuntu 터미널을 새로 엽니다. source ~/.bashrc 실행 명령어는 macOS와 같습니다. hermes Windows에서 No models provided 같은 오류가 뜬다면 config.yaml 파일이 UTF-8 without BOM으로 저장되어 있는지 확인해보세요. 6. 기본 설정 마법사 설치 후에는 기본 설정 마법사를 실행합니다. hermes setup 모델만 먼저 고르고 싶다면: hermes model 현재 설정 확인: hermes config 설정 파일 위치 확인: hermes config path API 키를 넣는 환경 파일 위치 확인: hermes config env-path 7. API 키 넣기 Hermes는 여러 모델 제공자를 지원합니다. 환경 파일에 아래와 같은 값을 넣어 사용할 수 있습니다. OpenRouter: OPENROUTER_API_KEY Anthropic: ANTHROPIC_API_KEY Google Gemini: GOOGLE_API_KEY 또는 GEMINI_API_KEY DeepSeek: DEEPSEEK_API_KEY xAI/Grok: XAI_API_KEY API 키는