> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-docs-revamp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> Hermes Agent에서 Venice AI를 모델 공급자로 사용하세요

[Hermes Agent](https://hermes-agent.nousresearch.com)는 [Nous Research](https://nousresearch.com)가 만든 오픈소스 셀프 호스팅 AI 에이전트입니다. 지속적 메모리, 자율 스킬 생성, 실행 시간이 길수록 더 강력해지는 내장 학습 루프를 갖추고 있습니다. Venice API를 가리키면 텍스트, 이미지, 비디오, 오디오, 임베딩 등 230개 이상의 모델과 도구에 에이전트가 접근할 수 있습니다.

<Card title="Hermes Agent 문서" icon="arrow-up-right-from-square" href="https://hermes-agent.nousresearch.com/docs/">
  공식 Hermes Agent 문서의 전체 문서, 공급자 설정, 구성 옵션.
</Card>

## 왜 Venice + Hermes Agent인가요?

Venice API는 하나의 OpenAI 호환 endpoint를 통해 Hermes Agent에 Venice 플랫폼 전체에 대한 접근을 제공합니다.

| Capability   | What you get                            |
| ------------ | --------------------------------------- |
| **텍스트 및 채팅** | 프라이빗 및 익명화 모델(GLM, Qwen, Claude, GPT 등) |
| **이미지**      | 생성, 편집, 업스케일링, 배경 제거                    |
| **비디오**      | 생성 및 전사                                 |
| **오디오**      | 음성 합성(TTS), 음악 생성, speech-to-text       |
| **임베딩**      | RAG 및 시맨틱 검색을 위한 벡터 임베딩                 |
| **도구**       | 웹 스크래핑, 웹 검색, 텍스트 파싱, crypto RPC        |

<CardGroup cols={3}>
  <Card title="프라이빗 추론" icon="shield-halved">
    데이터 보존 제로. prompt는 절대 저장되거나 로그되지 않습니다
  </Card>

  <Card title="지속적 메모리" icon="brain">
    Hermes는 세션과 재시작을 넘나들며 context를 기억합니다
  </Card>

  <Card title="15개 이상의 플랫폼" icon="comments">
    Telegram, Discord, Slack, WhatsApp 등 다양한 곳에서 에이전트에 접근하세요
  </Card>
</CardGroup>

## 설정

### 1. Hermes Agent 설치

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={"dark"}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>

  <Tab title="WSL2 (Windows)">
    먼저 [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install)를 설치한 뒤 같은 명령을 실행하세요:

    ```bash theme={"dark"}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>
</Tabs>

설치 후 셸을 다시 로드하세요:

```bash theme={"dark"}
source ~/.zshrc   # 또는: source ~/.bashrc
```

### 2. Venice를 공급자로 설정

모델 설정 마법사를 실행합니다:

```bash theme={"dark"}
hermes model
```

**Custom endpoint (self-hosted / VLLM / etc.)** 를 선택하고, 묻는 대로 다음 정보를 입력하세요:

| Field            | Value                          |
| ---------------- | ------------------------------ |
| **API base URL** | `https://api.venice.ai/api/v1` |
| **API key**      | Venice API 키                   |
| **Model name**   | Venice 모델 ID(아래 참고)            |

아직 API 키가 없다면 [venice.ai/settings/api](https://venice.ai/settings/api)에서 발급받으세요.

<Tip>
  `~/.hermes/config.yaml`에서 Venice를 직접 설정할 수도 있습니다:

  ```yaml theme={"dark"}
  model:
    default: zai-org-glm-5
    provider: custom
    base_url: https://api.venice.ai/api/v1
    api_key: ${VENICE_API_KEY}
  ```

  그리고 `~/.hermes/.env`에 키를 설정합니다:

  ```bash theme={"dark"}
  VENICE_API_KEY=your-key-here
  ```
</Tip>

### 3. 모델 선택

마법사가 모델을 물을 때 용도에 맞게 선택하세요:

| Use case   | Model                   | Privacy    |
| ---------- | ----------------------- | ---------- |
| 일반         | `zai-org-glm-5`         | Private    |
| 추론         | `kimi-k2-6`             | Private    |
| 코딩         | `claude-opus-4-7`       | Anonymized |
| 비전         | `z-ai-glm-5v-turbo`     | Anonymized |
| Uncensored | `venice-uncensored-1-2` | Private    |

재시작 없이 언제든지 모델을 변경할 수 있습니다:

```bash theme={"dark"}
hermes model              # 전체 마법사
```

또는 세션 도중 전환:

```text theme={"dark"}
/model custom:claude-opus-4-7
```

### 4. 채팅 시작

클래식 CLI나 모던 TUI를 여세요:

```bash theme={"dark"}
hermes            # 클래식 CLI
hermes --tui      # 모던 TUI (권장)
```

모든 것이 잘 작동하는지 prompt를 시도해 보세요:

```text theme={"dark"}
Summarize this repo in 5 bullets and tell me what the main entrypoint is.
```

## 메시징 플랫폼 연결

CLI가 동작하면 게이트웨이를 통해 메시징 앱을 연결하세요:

```bash theme={"dark"}
hermes gateway setup
```

이 단계는 Telegram, Discord, Slack, WhatsApp, Signal 등 다양한 플랫폼 연결을 안내합니다. 에이전트는 Venice 기반으로 연결된 모든 채널에서 접근 가능해집니다.

```bash theme={"dark"}
hermes gateway      # 메시징 게이트웨이 시작
```

## 프라이버시 모드

Hermes Agent의 Venice 모델은 Venice API와 같은 [프라이버시 등급](/overview/privacy)을 따릅니다:

* **Private** 모델(GLM, Qwen, DeepSeek, Llama, Venice Uncensored)은 Venice GPU 풀에서 실행됩니다. prompt는 절대 저장되거나 로그되지 않습니다.
* **Anonymized** 모델(Claude, GPT, Gemini, Grok)은 모든 식별 정보를 제거한 채 Venice를 통해 프록시됩니다. 제3자 공급자는 사용자가 아닌 Venice를 고객으로 봅니다.

## Venice API 스킬

Hermes Agent에는 [Agent Skills](https://github.com/veniceai/skills) 포맷과 호환되는 내장 스킬 시스템이 있습니다. Venice는 에이전트에게 모든 Venice endpoint(chat, image 생성, 비디오, 오디오, 임베딩, augment 도구 등)를 사용하는 방법을 가르치는 공식 스킬을 배포합니다.

Venice 스킬을 GitHub에서 직접 설치하세요:

```bash theme={"dark"}
hermes skills install veniceai/skills
```

또는 개별 스킬을 검색하세요:

```bash theme={"dark"}
hermes skills search venice
```

Hermes는 각 스킬의 `SKILL.md` frontmatter로 스킬을 발견하고 필요할 때 로드합니다.

## 주요 명령

| Command             | Description  |
| ------------------- | ------------ |
| `hermes`            | 채팅 시작        |
| `hermes model`      | 공급자 또는 모델 변경 |
| `hermes tools`      | 활성화할 도구 설정   |
| `hermes gateway`    | 메시징 게이트웨이 시작 |
| `hermes --continue` | 마지막 세션 재개    |
| `hermes doctor`     | 문제 진단        |
| `hermes update`     | 최신 버전으로 업데이트 |

## 리소스

<CardGroup cols={2}>
  <Card title="Hermes Agent 문서" icon="book" href="https://hermes-agent.nousresearch.com/docs/">
    공식 문서
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/NousResearch/hermes-agent">
    소스 코드와 릴리스
  </Card>

  <Card title="Venice 모델 카탈로그" icon="list" href="/models/text">
    사용 가능한 모델 둘러보기
  </Card>

  <Card title="Venice 프라이버시" icon="shield-halved" href="/overview/privacy">
    Venice가 데이터를 보호하는 방법
  </Card>
</CardGroup>