hermes-agent

Hermes Agent ☤

Hermes Agent | Hermes Desktop

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에서는 Settings → Model → Subagents에서 프로바이더, 모델, 한도를 선택한 뒤 전체 경로를 Apply하세요. RPC를 통해 도구를 호출하는 Python 스크립트를 작성하여 다단계 파이프라인을 컨텍스트 비용이 없는 턴으로 압축하세요.
노트북이 아닌 어디서나 실행 6개의 내장 터미널 백엔드 — local, Docker, SSH, Modal, Daytona, Vercel Sandbox — 그리고 Singularity/Apptainer 같은 플러그인 백엔드. 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 저장소가 제공되며, 안정 채널(태그된 릴리스)과 프리릴리스 카나리 채널이 있습니다. 패키지에는 Python, Node.js, TUI가 포함됩니다. 데스크톱/서버 설치 스크립트가 아닌 Termux 가이드를 사용하세요.

Windows: 네이티브 Windows가 완전히 지원됩니다 — 위의 PowerShell 원라이너가 모든 것을 설치합니다. WSL2를 선호한다면 Linux 명령이 거기서도 작동합니다. 네이티브 Windows 설치는 %LOCALAPPDATA%\hermes 아래에, WSL2 설치는 Linux에서처럼 ~/.hermes 아래에 위치합니다.

설치 후:

source ~ /.bashrc # 셸 다시 로드 (또는: source ~/.zshrc)
hermes # 채팅 시작!
문제 해결
Windows Defender 또는 백신이 uv.exe를 악성코드로 표시
백신(Bitdefender, Windows Defender 등)이 Hermes bin 폴더(%LOCALAPPDATA%\hermes\bin\uv.exe)의 uv.exe를 격리한다면 이는 오탐입니다. 이 파일은 Astral의 uv — Hermes가 Python 환경 관리를 위해 번들로 포함하는 Rust Python 패키지 관리자입니다. ML 기반 백신 엔진은 패키지를 다운로드하고 설치하는 서명되지 않은 Rust 바이너리를 흔히 표시합니다.

복사본이 정품인지 확인하려면:

# 필요 시 GitHub CLI 설치
winget install -- id GitHub.cli

# GitHub 로그인
gh auth login

# 검증 실행
$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 # 대화형 CLI — 대화 시작
hermes model # LLM 프로바이더와 모델 선택
hermes tools # 활성화할 도구 구성
hermes config set # 개별 구성 값 설정
hermes config get # 개별 구성 값 출력
hermes gateway # 메시징 게이트웨이 시작 (Telegram, Discord 등)
hermes setup # 전체 설정 마법사 실행 (모든 것을 한 번에 구성)
hermes update # 최신 버전으로 업데이트
hermes doctor # 문제 진단
📖 전체 문서 →

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에서 대화하세요. 대화에 들어가면 많은 슬래시 명령이 두 인터페이스에서 공유됩니다.

동작
CLI
메시징 플랫폼

채팅 시작
hermes
hermes gateway setup + hermes gateway start 실행 후 봇에 메시지 전송

새 대화 시작
/new 또는 /reset
/new 또는 /reset

모델 변경
/model [provider:model]
/model [provider:model]

성격 설정
/personality [name]
/personality [name]

마지막 턴 재시도 또는 실행 취소
/retry, /undo
/retry, /undo

컨텍스트 압축 / 사용량 확인
/compress, /usage, /insights [--days N]
/compress, /usage, /insights [days]

스킬 탐색
/skills 또는 /<skill-name>
/<skill-name>

현재 작업 중단
Ctrl+C 또는 새 메시지 전송
/stop 또는 새 메시지 전송

플랫폼별 상태
/platforms
/status, /sethome

전체 명령 목록은 CLI 가이드와 메시징 게이트웨이 가이드를 참조하세요.

문서
모든 문서는 hermes-agent.nousresearch.com/docs에 있습니다:

섹션
다루는 내용

Quickstart
설치 → 설정 → 2분 안에 첫 대화

CLI Usage
명령, 키바인딩, 성격, 세션

Configuration
구성 파일, 프로바이더, 모델, 모든 옵션

Messaging Gateway
Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant

Security
명령 승인, DM 페어링, 컨테이너 격리

Tools & Toolsets
40개 이상의 도구, 도구셋 시스템, 터미널 백엔드

Skills System
절차적 메모리, Skills Hub, 스킬 생성

Memory
영구 메모리, 사용자 프로필, 모범 사례

MCP Integration
확장 기능을 위한 모든 MCP 서버 연결

Cron Scheduling
플랫폼 전달이 포함된 예약 작업

Context Files
모든 대화를 형성하는 프로젝트 컨텍스트

Architecture
프로젝트 구조, 에이전트 루프, 주요 클래스

Contributing
개발 설정, PR 프로세스, 코드 스타일

CLI Reference
모든 명령과 플래그

Environment Variables
전체 환경 변수 참조

OpenClaw 또는 다른 에이전트에서 마이그레이션
OpenClaw, Claude Code, Codex CLI 또는 Cursor에서 오신다면, Hermes는 설정, 메모리, 스킬을 가져올 수 있습니다 (그리고 OpenClaw의 경우 요청 시 API 키도).

설정 중: hermes setup이 다른 에이전트에서 가져올지 묻고, 발견한 것들(~/.openclaw, ~/.claude, ~/.codex, ~/.cursor)을 미리 선택하며, 공식 agent-importers 플러그인을 설치하고 먼저 미리보기와 함께 가져오기를 실행합니다.

설치 후 언제든:

hermes plugins install agent-importers # 프로필당 한 번
hermes import-agent openclaw # 대화형 마이그레이션 (전체 프리셋)
hermes import-agent openclaw --dry-run # 마이그레이션될 내용 미리보기
hermes import-agent openclaw --migrate-secrets # 허용 목록의 API 키도 함께 가져오기
hermes import-agent claude-code # 또는 codex / cursor
OpenClaw에서 가져오는 항목:

SOUL.md — 페르소나 파일
메모리 — MEMORY.md 및 USER.md 항목
스킬 — 사용자 생성 스킬 → ~/.hermes/skills/openclaw-imports/
명령 허용 목록 — 승인 패턴
메시징 설정 — 플랫폼 구성, 허용 사용자, 작업 디렉터리
API 키 — 허용 목록의 시크릿 (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs), --migrate-secrets 사용 시에만
TTS 자산 — 워크스페이스 오디오 파일
워크스페이스 지침 — AGENTS.md (--workspace-target 사용 시)

hermes claw migrate는 이전 표기로 여전히 작동합니다. OpenClaw 마이그레이션 가이드와 다른 에이전트에서 가져오기를 참조하세요.

기여
기여를 환영합니다! 개발 설정, 코드 스타일, PR 프로세스는 기여 가이드를 참조하세요.

활성화, 일상적 사용, 종속성 변경, 환경 종료에 대해서는 PM 개발자 워크플로우로 시작하세요.
개발 설정은 별도의 테스트 환경과 검증 명령을 다룹니다.

커뮤니티

💬 Discord
📚 Skills Hub
🐛 Issues
🔌 computer-use-linux — Hermes 및 기타 MCP 호스트를 위한 Linux 데스크톱 제어 MCP 서버로, AT-SPI 접근성 트리, Wayland/X11 입력, 스크린샷, 컴포지터 창 타기팅을 지원합니다.
🔌 HermesClaw — 커뮤니티 WeChat 브리지: 동일한 WeChat 계정에서 Hermes Agent와 OpenClaw를 실행합니다.

라이선스
MIT — LICENSE를 참조하세요.

Nous Research 제작.