hermes-agent — Updated!
함께 성장하는 에이전트
Hermes Agent ☤
Nous Research가 만든 자기 개선형 AI 에이전트입니다. 경험에서 스킬을 만들어 내고, 사용하는 동안 그 스킬을 개선하며, 스스로 지식을 축적하도록 자신을 독려하고, 과거 대화를 검색하며, 세션을 거듭하며 당신이 누구인지에 대한 모델을 점점 깊게 구축하는, 내장 학습 루프를 갖춘 유일한 에이전트입니다. 월 5달러짜리 VPS, GPU 클러스터, 또는 유휴 시 거의 비용이 들지 않는 서버리스 인프라에서 실행하세요. 노트북에 묶여 있지 않습니다 — 클라우드 VM에서 작업하는 동안 Telegram으로 대화할 수 있습니다.
원하는 모델을 무엇이든 사용하세요 — Nous Portal, OpenRouter, OpenAI, 자체 엔드포인트, 그리고 다양한 다른 서비스를 지원합니다. hermes model로 전환하세요 — 코드 변경도, 종속도 없습니다.
| 진짜 터미널 인터페이스 | 여러 줄 편집, 슬래시 명령 자동 완성, 대화 기록, 중단 후 방향 전환, 스트리밍 도구 출력을 갖춘 완전한 TUI. |
| 당신이 있는 곳에서 함께합니다 | Telegram, Discord, Slack, WhatsApp, Signal, CLI — 모두 단일 게이트웨이 프로세스에서. 음성 메모 전사, 플랫폼 간 대화 연속성. |
| 닫힌 학습 루프 | 주기적 넛지가 있는 에이전트가 관리하는 메모리. 복잡한 작업 후 자율적 스킬 생성. 사용 중 스킬이 스스로 개선. 세션 간 회상을 위한 LLM 요약이 포함된 FTS5 세션 검색. Honcho 변증법적 사용자 모델링. agentskills.io 공개 표준과 호환. |
| 예약된 자동화 | 모든 플랫폼으로 전달되는 내장 cron 스케줄러. 일일 보고서, 야간 백업, 주간 감사 — 모두 자연어로, 무인으로 실행됩니다. |
| 위임과 병렬화 | 병렬 작업 흐름을 위한 격리된 하위 에이전트를 생성합니다. Desktop에서는 설정 → 모델 → 하위 에이전트에서 공급자, 모델, 한도를 선택한 뒤 전체 경로를 적용하세요. RPC를 통해 도구를 호출하는 Python 스크립트를 작성하여 다단계 파이프라인을 컨텍스트 비용이 없는 턴으로 축소하세요. |
| 노트북뿐 아니라 어디서나 실행 | 일곱 가지 터미널 백엔드 — 로컬, Docker, SSH, Singularity, Modal, Daytona, Vercel Sandbox. Daytona와 Modal은 서버리스 지속성을 제공합니다 — 에이전트 환경이 유휴 시 최대 절전 모드로 전환되고 필요할 때 깨어나 세션 사이에 거의 비용이 들지 않습니다. 월 5달러짜리 VPS나 GPU 클러스터에서 실행하세요. |
| 연구 준비 완료 | 배치 궤적 생성, 차세대 도구 호출 모델 훈련을 위한 궤적 압축. |
빠른 설치
Linux, macOS, WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows (네이티브, PowerShell)
알림: 네이티브 Windows는 WSL 없이 Hermes를 실행합니다 — CLI, 게이트웨이, TUI, 도구 모두 네이티브로 작동합니다. WSL2를 선호한다면 위의 Linux/macOS 원라이너도 그곳에서 작동합니다. 버그를 발견하셨나요? 이슈를 등록해 주세요.
PowerShell에서 다음을 실행하세요:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
소스 설치 프로그램은 Python 3.14, Node.js, npm, ripgrep, FFmpeg 및 Python 종속성을 PM에 위임합니다. Git이 없으면 검증된 Git for Windows 아카이브를 Hermes의 도구 저장소에 준비합니다. 시스템 Git을 대체하지는 않습니다. 별도의 MSIX/App Installer 패키지 및 해당 업데이트 소유권에 대해서는 설치 방법을 참조하세요.
Android / Termux: aarch64 기기용 서명된 APT 저장소가 제공되며,
stable채널(태그된 릴리스)과 사전 릴리스canary채널이 있습니다. 패키지에는 Python, Node.js 및 TUI가 포함됩니다. 데스크톱/서버 설치 스크립트가 아닌 Termux 가이드를 사용하세요.Windows: 네이티브 Windows가 완전히 지원됩니다 — 위의 PowerShell 한 줄 명령이 모든 것을 설치합니다. WSL2를 선호하는 경우 Linux 명령도 여기서 작동합니다. 네이티브 Windows 설치는
%LOCALAPPDATA%\hermes아래에 위치하며, WSL2는 Linux에서처럼~/.hermes아래에 설치됩니다.
설치 후:
source ~/.bashrc # reload shell (or: source ~/.zshrc)
hermes # start chatting!
문제 해결
Windows Defender 또는 백신이 uv.exe를 악성코드로 탐지하는 경우
백신(Bitdefender, Windows Defender 등)이 Hermes bin 폴더(%LOCALAPPDATA%\hermes\bin\uv.exe)의 uv.exe를 격리하는 경우, 이는 오탐입니다. 해당 파일은 Astral의 uv로, Hermes가 Python 환경을 관리하기 위해 번들로 포함한 Rust 기반 Python 패키지 관리자입니다. 머신러닝 기반 백신 엔진은 패키지를 다운로드하고 설치하는 서명되지 않은 Rust 바이너리를 흔히 탐지합니다.
복사본이 정품인지 확인하려면:
# Install GitHub CLI if needed
winget install --id GitHub.cli
# Login to GitHub
gh auth login
# Run verification
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash
Attestation에 "Verification succeeded"라고 표시되고 마지막 줄에 True가 출력되면 정상입니다.
Hermes를 화이트리스트에 추가하려면:
- Windows Defender: 관리자 권한으로 PowerShell 실행 →
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin" - Bitdefender: Bitdefender 콘솔에서 예외 추가 (Protection > Antivirus > Settings > Manage Exceptions)
- 파일 해시가 아닌 폴더를 화이트리스트에 추가하세요 — Hermes는
uv를 업데이트하며 해시는 버전마다 변경됩니다
더 자세한 내용은 업스트림 Astral 보고서를 참조하세요: astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079.
시작하기
hermes # Interactive CLI — start a conversation
hermes model # Choose your LLM provider and model
hermes tools # Configure which tools are enabled
hermes config set # Set individual config values
hermes config get # Print individual config values
hermes gateway # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update # Update to the latest version
hermes doctor # Diagnose any issues
📖 전체 문서 →
API 키 수집을 건너뛰세요 — Nous Portal
Hermes는 원하는 어떤 제공자와도 작동합니다 — 이는 바뀌지 않습니다. 하지만 모델, 웹 검색, 이미지 생성, TTS, 클라우드 브라우저를 위해 다섯 개의 개별 API 키를 수집하고 싶지 않다면, **Nous Portal**이 이 모든 것을 하나의 구독으로 제공합니다:
- 300개 이상의 모델 —
/model <name>으로 원하는 모델을 선택하세요 - Tool Gateway — 웹 검색, 이미지 생성(FAL), 텍스트 음성 변환(OpenAI), 클라우드 브라우저(Browser Use)가 모두 구독을 통해 라우팅됩니다. 추가 계정이 필요 없습니다.
새로 설치한 후 명령어 하나면 됩니다:
hermes setup --portal
OAuth를 통해 로그인하고, Nous를 제공자로 설정하며, Tool Gateway를 활성화합니다. 언제든지 hermes portal info로 연결 상태를 확인할 수 있습니다. 자세한 내용은 Tool Gateway 문서 페이지를 참고하세요.
원한다면 언제든지 도구별로 자체 키를 사용할 수도 있습니다. 게이트웨이는 백엔드별로 적용되며, 전부 아니면 전무 방식이 아닙니다.
CLI vs 메시징 빠른 참조
Hermes에는 두 가지 진입점이 있습니다. hermes로 터미널 UI를 시작하거나, 게이트웨이를 실행하고 Telegram, Discord, Slack, WhatsApp, Signal 또는 Email에서 대화할 수 있습니다. 대화에 들어가면 많은 슬래시 명령이 두 인터페이스에서 공통으로 사용됩니다.