nousresearch/hermes-agent함께 성장하는 에이전트
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7225/75e85ef6fecf5a6227985f2082e5b35331fceff4d8db03720c82a7d9ee8b7eea.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="문서"></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="라이선스: MIT"></a>
<a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Nous Research 제작"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-%E4%B8%AD%E6%96%87-red?style=for-the-badge" alt="中文"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.ur-pk.md"><img src="https://img.shields.io/badge/Lang-%D8%A7%D8%B1%D8%AF%D9%88-green?style=for-the-badge" alt="اردو"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.es.md"><img src="https://img.shields.io/badge/Lang-Espa%C3%B1ol-orange?style=for-the-badge" alt="Español"></a>
</p>
**[Nous Research](https://nousresearch.com)가 만든 자기 개선형 AI 에이전트입니다.** 경험에서 스킬을 만들어 내고, 사용하는 동안 그 스킬을 개선하며, 스스로 지식을 축적하도록 자신을 독려하고, 과거 대화를 검색하며, 세션을 거듭하며 당신이 누구인지에 대한 모델을 점점 깊게 구축하는, 내장 학습 루프를 갖춘 유일한 에이전트입니다. 월 5달러짜리 VPS, GPU 클러스터, 또는 유휴 시 거의 비용이 들지 않는 서버리스 인프라에서 실행하세요. 노트북에 묶여 있지 않습니다 — 클라우드 VM에서 작업하는 동안 Telegram으로 대화할 수 있습니다.
원하는 모델을 무엇이든 사용하세요 — [Nous Portal](https://portal.nousresearch.com), OpenRouter, OpenAI, 자체 엔드포인트, 그리고 [다양한 다른 서비스](https://hermes-agent.nousresearch.com/docs/integrations/providers)를 지원합니다. `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>병렬 작업 흐름을 위한 격리된 하위 에이전트를 생성합니다. Desktop에서는 설정 → 모델 → 하위 에이전트에서 공급자, 모델, 한도를 선택한 뒤 전체 경로를 적용하세요. RPC를 통해 도구를 호출하는 Python 스크립트를 작성하여 다단계 파이프라인을 컨텍스트 비용이 없는 턴으로 축소하세요.</td></tr>
<tr><td><b>노트북뿐 아니라 어디서나 실행</b></td><td>일곱 가지 터미널 백엔드 — 로컬, Docker, SSH, Singularity, Modal, Daytona, Vercel Sandbox. Daytona와 Modal은 서버리스 지속성을 제공합니다 — 에이전트 환경이 유휴 시 최대 절전 모드로 전환되고 필요할 때 깨어나 세션 사이에 거의 비용이 들지 않습니다. 월 5달러짜리 VPS나 GPU 클러스터에서 실행하세요.</td></tr>
<tr><td><b>연구 준비 완료</b></td><td>배치 궤적 생성, 차세대 도구 호출 모델 훈련을 위한 궤적 압축.</td></tr>
</table>
---
## 빠른 설치
### Linux, macOS, WSL2
```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```
### Windows (네이티브, PowerShell)
> **알림:** 네이티브 Windows는 WSL 없이 Hermes를 실행합니다 — CLI, 게이트웨이, TUI, 도구 모두 네이티브로 작동합니다. WSL2를 선호한다면 위의 Linux/macOS 원라이너도 그곳에서 작동합니다. 버그를 발견하셨나요? [이슈를 등록해 주세요](https://github.com/NousResearch/hermes-agent/issues).
PowerShell에서 다음을 실행하세요:
```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 패키지 및 해당 업데이트 소유권에 대해서는 [설치 방법](https://hermes-agent.nousresearch.com/docs/getting-started/installation)을 참조하세요.
> **Android / Termux:** aarch64 기기용 서명된 APT 저장소가 제공되며, `stable` 채널(태그된 릴리스)과 사전 릴리스 `canary` 채널이 있습니다. 패키지에는 Python, Node.js 및 TUI가 포함됩니다. 데스크톱/서버 설치 스크립트가 아닌 [Termux 가이드](https://hermes-agent.nousresearch.com/docs/getting-started/termux)를 사용하세요.
>
> **Windows:** 네이티브 Windows가 완전히 지원됩니다 — 위의 PowerShell 한 줄 명령이 모든 것을 설치합니다. WSL2를 선호하는 경우 Linux 명령도 여기서 작동합니다. 네이티브 Windows 설치는 `%LOCALAPPDATA%\hermes` 아래에 위치하며, WSL2는 Linux에서처럼 `~/.hermes` 아래에 설치됩니다.
설치 후:
```bash
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 바이너리를 흔히 탐지합니다.
**복사본이 정품인지 확인하려면:**
```powershell
# 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](https://github.com/astral-sh/uv/issues/13553), [astral-sh/uv#15011](https://github.com/astral-sh/uv/issues/15011), [astral-sh/uv#10079](https://github.com/astral-sh/uv/issues/10079).
---
## 시작하기
```bash
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
```
📖 **[전체 문서 →](https://hermes-agent.nousresearch.com/docs/)**
---
## API 키 수집을 건너뛰세요 — Nous Portal
Hermes는 원하는 어떤 제공자와도 작동합니다 — 이는 바뀌지 않습니다. 하지만 모델, 웹 검색, 이미지 생성, TTS, 클라우드 브라우저를 위해 다섯 개의 개별 API 키를 수집하고 싶지 않다면, **[Nous Portal](https://portal.nousresearch.com)**이 이 모든 것을 하나의 구독으로 제공합니다:
- **300개 이상의 모델** — `/model <name>`으로 원하는 모델을 선택하세요
- **Tool Gateway** — 웹 검색, 이미지 생성(FAL), 텍스트 음성 변환(OpenAI), 클라우드 브라우저(Browser Use)가 모두 구독을 통해 라우팅됩니다. 추가 계정이 필요 없습니다.
새로 설치한 후 명령어 하나면 됩니다:
```bash
hermes setup --portal
```
OAuth를 통해 로그인하고, Nous를 제공자로 설정하며, Tool Gateway를 활성화합니다. 언제든지 `hermes portal info`로 연결 상태를 확인할 수 있습니다. 자세한 내용은 [Tool Gateway 문서 페이지](https://hermes-agent.nousresearch.com/docs/user-guide/features/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 가이드](https://hermes-agent.nousresearch.com/docs/user-guide/cli)와 [메시징 게이트웨이 가이드](https://hermes-agent.nousresearch.com/docs/user-guide/messaging)를 참고하세요.
---
## 문서
모든 문서는 **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)**에 있습니다:
| 섹션 | 다루는 내용 |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [빠른 시작](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | 설치 → 설정 → 2분 안에 첫 대화 |
| [CLI 사용법](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | 명령어, 키 바인딩, 페르소나, 세션 |
| [구성](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | 구성 파일, 프로바이더, 모델, 모든 옵션 |
| [메시징 게이트웨이](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| [보안](https://hermes-agent.nousresearch.com/docs/user-guide/security) | 명령 승인, DM 페어링, 컨테이너 격리 |
| [도구 및 도구 세트](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | 40개 이상의 도구, 도구 세트 시스템, 터미널 백엔드 |
| [스킬 시스템](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | 절차적 메모리, Skills Hub, 스킬 생성 |
| [메모리](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | 영구 메모리, 사용자 프로필, 모범 사례 |
| [MCP 통합](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | 확장 기능을 위한 모든 MCP 서버 연결 |
| [Cron 스케줄링](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | 플랫폼 전달을 포함한 예약 작업 |
| [컨텍스트 파일](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | 모든 대화를 형성하는 프로젝트 컨텍스트 |
| [아키텍처](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | 프로젝트 구조, 에이전트 루프, 주요 클래스 |
| [기여하기](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | 개발 환경 설정, PR 프로세스, 코드 스타일 |
| [CLI 레퍼런스](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | 모든 명령어와 플래그 |
| [환경 변수](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | 전체 환경 변수 레퍼런스 |
---
## OpenClaw에서 마이그레이션하기
OpenClaw에서 넘어오는 경우, Hermes는 설정, 메모리, 스킬, API 키를 자동으로 가져올 수 있습니다.
**최초 설정 시:** 설정 마법사(`hermes setup`)는 `~/.openclaw`를 자동으로 감지하고 구성이 시작되기 전에 마이그레이션을 제안합니다.
**설치 후 언제든지:**
```bash
hermes claw migrate # Interactive migration (full preset)
hermes claw migrate --dry-run # Preview what would be migrated
hermes claw migrate --preset user-data # Migrate without secrets
hermes claw migrate --overwrite # Overwrite existing conflicts
```
가져오는 항목:
- **SOUL.md** — 페르소나 파일
- **메모리** — MEMORY.md 및 USER.md 항목
- **스킬** — 사용자가 만든 스킬 → `~/.hermes/skills/openclaw-imports/`
- **명령 허용 목록** — 승인 패턴
- **메시징 설정** — 플랫폼 구성, 허용된 사용자, 작업 디렉터리
- **API 키** — 허용 목록에 포함된 시크릿(Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
- **TTS 자산** — 워크스페이스 오디오 파일
- **워크스페이스 지침** — AGENTS.md (`--workspace-target` 사용)
모든 옵션은 `hermes claw migrate --help`를 참조하거나, 드라이런 미리보기가 포함된 대화형 에이전트 안내 마이그레이션을 위해 `openclaw-migration` 스킬을 사용하세요.
---
## 기여
기여를 환영합니다! 개발 환경 설정, 코드 스타일, PR 절차는 [기여 가이드](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing)를 참조하세요.
활성화, 일상적 사용, 의존성 변경, 환경 종료에 대해서는 [PM 개발자 워크플로](https://github.com/nousresearch/hermes-agent/blob/main/website/docs/reference/package-management.md#developer-workflow)부터 시작하세요.
[개발 환경 설정](https://github.com/nousresearch/hermes-agent/blob/main/CONTRIBUTING.md#development-setup)에서는 별도의 테스트 환경과 검증 명령을 다룹니다.
---
## 커뮤니티
- 💬 [Discord](https://discord.gg/NousResearch)
- 📚 [Skills Hub](https://agentskills.io)
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — Hermes 및 기타 MCP 호스트를 위한 Linux 데스크톱 제어 MCP 서버로, AT-SPI 접근성 트리, Wayland/X11 입력, 스크린샷, 컴포지터 창 타기팅을 지원합니다.
- 🔌 [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — 커뮤니티 WeChat 브리지: 동일한 WeChat 계정에서 Hermes Agent와 OpenClaw를 실행합니다.
---
## 라이선스
MIT — [LICENSE](https://github.com/nousresearch/hermes-agent/blob/main/LICENSE)를 참조하세요.
[Nous Research](https://nousresearch.com)에서 제작했습니다.