NousResearch/hermes-agent

<p align="center"> <img src="assets/banner.png" alt="Hermes Agent" width="100%"> </p>

Hermes Agent ☤

<p align="center"> <a href="https://hermes-agent.nousresearch.com/">Hermes Agent</a> | <a href="https://hermes-agent.nousresearch.com/">Hermes Desktop</a> </p> <p align="center"> <a href="https://hermes-agent.nousresearch.com/docs/"><img src="https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge" alt="Documentation"></a> <a href="https://discord.gg/NousResearch"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a> <a href="https://github.com/NousResearch/hermes-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License: MIT"></a> <a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Built by Nous Research"></a> <a href="README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-中文-red?style=for-the-badge" alt="中文"></a> <a href="README.ur-pk.md"><img src="https://img.shields.io/badge/Lang-اردو-green?style=for-the-badge" alt="اردو"></a> <a href="README.es.md"><img src="https://img.shields.io/badge/Lang-Español-orange?style=for-the-badge" alt="Español"></a> </p>

Nous Research가 구축한 자기 개선 AI 에이전트입니다. 경험으로부터 스킬을 생성하고, 사용 중에 개선하며, 지속적인 지식을 위해 스스로를 넛지하고, 과거 대화를 검색하며, 세션을 넘어 당신에 대한 깊어지는 모델을 구축하는 내장 학습 루프를 가진 유일한 에이전트입니다. $5 VPS, GPU 클러스터, 또는 유휴 상태일 때 거의 비용이 들지 않는 서버리스 인프라에서 실행할 수 있습니다. 노트북에 묶여 있지 않습니다 — 클라우드 VM에서 작업하는 동안 Telegram을 통해 대화할 수 있습니다.

원하는 어떤 모델이든 사용할 수 있습니다 — Nous Portal, OpenRouter (200개 이상의 모델), NovitaAI (AI 네이티브 클라우드: Model API, Agent Sandbox, GPU Cloud), NVIDIA NIM (Nemotron), Xiaomi MiMo, z.ai/GLM, Kimi/Moonshot, MiniMax, Hugging Face, OpenAI, 또는 자체 엔드포인트. hermes model로 전환 — 코드 변경 없음, 종속 없음.

<table> <tr><td><b>실제 터미널 인터페이스</b></td><td>멀티라인 편집, 슬래시 명령 자동완성, 대화 기록, 중단 및 리디렉션, 스트리밍 도구 출력을 갖춘 전체 TUI.</td></tr> <tr><td><b>당신이 있는 곳에서 작동</b></td><td>Telegram, Discord, Slack, WhatsApp, Signal, CLI — 모두 단일 게이트웨이 프로세스에서. 음성 메모 전사, 플랫폼 간 대화 연속성.</td></tr> <tr><td><b>폐쇄된 학습 루프</b></td><td>주기적인 넛지가 있는 에이전트 큐레이팅 메모리. 복잡한 작업 후 자율 스킬 생성. 사용 중 스킬 자체 개선. 세션 간 회상을 위한 LLM 요약을 포함한 FTS5 세션 검색. <a href="https://github.com/plastic-labs/honcho">Honcho</a> 변증법적 사용자 모델링. <a href="https://agentskills.io">agentskills.io</a> 오픈 표준과 호환.</td></tr> <tr><td><b>예약된 자동화</b></td><td>내장 cron 스케줄러로 모든 플랫폼에 전달. 일일 보고서, 야간 백업, 주간 감사 — 모두 자연어로, 무인 실행.</td></tr> <tr><td><b>위임 및 병렬화</b></td><td>병렬 작업 스트림을 위해 격리된 하위 에이전트 생성. RPC를 통해 도구를 호출하는 Python 스크립트 작성, 다단계 파이프라인을 제로 컨텍스트 비용 턴으로 축소.</td></tr> <tr><td><b>노트북뿐만 아니라 어디서나 실행</b></td><td>6가지 터미널 백엔드 — 로컬, Docker, SSH, Singularity, Modal, Daytona. Daytona와 Modal은 서버리스 지속성을 제공 — 유휴 상태일 때 에이전트 환경이 최면 상태가 되고 요청 시 깨어나며, 세션 간 비용이 거의 들지 않습니다. $5 VPS 또는 GPU 클러스터에서 실행.</td></tr> <tr><td><b>연구 준비 완료</b></td><td>일괄 궤적 생성, 차세대 도구 호출 모델 훈련을 위한 궤적 압축.</td></tr> </table>

빠른 설치

Linux, macOS, WSL2, Termux

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)

설치 프로그램이 모든 것을 처리합니다: uv, Python 3.11, Node.js, ripgrep, ffmpeg, 그리고 휴대용 Git Bash (MinGit, %LOCALAPPDATA%\hermes\git에 압축 해제 — 관리자 권한 불필요, 시스템 Git 설치와 완전히 격리됨). Hermes는 이 번들 Git Bash를 사용하여 셸 명령을 실행합니다.

이미 Git이 설치되어 있으면 설치 프로그램이 이를 감지하고 대신 사용합니다. 그렇지 않으면 약 45MB의 MinGit 다운로드만 필요합니다 — 시스템 Git을 건드리거나 간섭하지 않습니다.

Android / Termux: 테스트된 수동 경로는 Termux 가이드에 문서화되어 있습니다. Termux에서 Hermes는 선별된 .[termux] 추가 기능을 설치합니다. 전체 .[all] 추가 기능은 현재 Android와 호환되지 않는 음성 종속성을 가져오기 때문입니다.

>

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를 격리하는 경우, 이는 오탐(false positive)입니다. 이 파일은 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를 출력하면 정상입니다.

• Windows Defender: PowerShell을 관리자로 실행 → Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
• Bitdefender: Bitdefender 콘솔에서 예외 추가 (Protection > Antivirus > Settings > Manage Exceptions)
• 폴더를 허용 목록에 추가하고 파일 해시는 추가하지 마세요 — Hermes는 uv를 업데이트하고 해시는 버전마다 변경됩니다.

Hermes를 허용 목록에 추가하려면:

자세한 내용은 업스트림 Astral 보고서를 참조하세요: astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079

시작하기

hermes              # 대화형 CLI — 대화 시작
hermes model        # LLM 제공자 및 모델 선택
hermes tools        # 활성화할 도구 구성
hermes config set   # 개별 구성 값 설정
hermes gateway      # 메시징 게이트웨이 시작 (Telegram, Discord 등)
hermes setup        # 전체 설정 마법사 실행 (모든 것을 한 번에 구성)
hermes claw migrate # OpenClaw에서 마이그레이션 (OpenClaw에서 오는 경우)
hermes update       # 최신 버전으로 업데이트
hermes doctor       # 문제 진단

📖 전체 문서 →

API 키 수집 건너뛰기 — Nous Portal

Hermes는 원하는 제공자와 함께 작동합니다 — 그것은 변하지 않습니다. 하지만 모델, 웹 검색, 이미지 생성, TTS, 클라우드 브라우저를 위해 다섯 개의 개별 API 키를 수집하고 싶지 않다면, Nous Portal이 하나의 구독으로 모두를 커버합니다:

• 300개 이상의 모델 — /model <name>으로 아무 모델이나 선택
• 도구 게이트웨이 — 웹 검색(Firecrawl), 이미지 생성(FAL), 텍스트 음성 변환(OpenAI), 클라우드 브라우저(Browser Use)가 모두 구독을 통해 라우팅됩니다. 추가 계정 불필요.

새 설치에서 한 명령:

hermes setup --portal

이것은 OAuth를 통해 로그인하고, Nous를 제공자로 설정하며, 도구 게이트웨이를 활성화합니다. hermes portal info로 언제든지 연결된 것을 확인할 수 있습니다. 자세한 내용은 Tool Gateway 문서 페이지를 참조하세요.

원할 때마다 도구별로 자체 키를 계속 가져올 수 있습니다 — 게이트웨이는 백엔드별로, 전부 아니면 전무(all-or-nothing)가 아닙니다.

CLI vs 메시징 빠른 참조

Hermes에는 두 가지 진입점이 있습니다: hermes로 터미널 UI를 시작하거나, 게이트웨이를 실행하고 Telegram, Discord, Slack, WhatsApp, Signal, 이메일을 통해 대화합니다. 대화에 들어가면 많은 슬래시 명령이 두 인터페이스에서 공유됩니다.

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

문서

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

[...truncated...]