Hermes Agent with Venice | Venice API Docs

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

Hermes Agent 문서

공식 Hermes Agent 문서의 전체 문서, 공급자 설정, 구성 옵션.

왜 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

프라이빗 추론

데이터 보존 제로. prompt는 절대 저장되거나 로그되지 않습니다

지속적 메모리

Hermes는 세션과 재시작을 넘나들며 context를 기억합니다

15개 이상의 플랫폼

Telegram, Discord, Slack, WhatsApp 등 다양한 곳에서 에이전트에 접근하세요

설정

1. Hermes Agent 설치

macOS / Linux
WSL2 (Windows)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

먼저 WSL2를 설치한 뒤 같은 명령을 실행하세요:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

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

source ~/.zshrc   # 또는: source ~/.bashrc

2. Venice를 공급자로 설정

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

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에서 발급받으세요.

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

model:
  default: zai-org-glm-5
  provider: custom
  base_url: https://api.venice.ai/api/v1
  api_key: ${VENICE_API_KEY}

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

VENICE_API_KEY=your-key-here

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

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

hermes model              # 전체 마법사

또는 세션 도중 전환:

/model custom:claude-opus-4-7

4. 채팅 시작

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

hermes            # 클래식 CLI
hermes --tui      # 모던 TUI (권장)

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

Summarize this repo in 5 bullets and tell me what the main entrypoint is.

메시징 플랫폼 연결

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

hermes gateway setup

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

hermes gateway      # 메시징 게이트웨이 시작

프라이버시 모드

Hermes Agent의 Venice 모델은 Venice API와 같은 프라이버시 등급을 따릅니다:

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

Venice API 스킬

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

hermes skills install veniceai/skills

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

hermes skills search venice

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

주요 명령

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

리소스

Hermes Agent 문서

공식 문서

GitHub

소스 코드와 릴리스

Venice 모델 카탈로그

사용 가능한 모델 둘러보기

Venice 프라이버시

Venice가 데이터를 보호하는 방법

Guides

Getting Started

Text & Chat

Image & Video

Agents & Integrations

Agent Tooling

Coding Tools

SDKs & Frameworks

Projects

Hermes Agent

Hermes Agent 문서

왜 Venice + Hermes Agent인가요?

프라이빗 추론

지속적 메모리

15개 이상의 플랫폼

설정

1. Hermes Agent 설치

2. Venice를 공급자로 설정

3. 모델 선택

4. 채팅 시작

메시징 플랫폼 연결

프라이버시 모드

Venice API 스킬

주요 명령

리소스

Hermes Agent 문서

GitHub

Venice 모델 카탈로그

Venice 프라이버시

Hermes Agent 문서

​왜 Venice + Hermes Agent인가요?

프라이빗 추론

지속적 메모리

15개 이상의 플랫폼

​설정

​1. Hermes Agent 설치

​2. Venice를 공급자로 설정

​3. 모델 선택

​4. 채팅 시작

​메시징 플랫폼 연결

​프라이버시 모드

​Venice API 스킬

​주요 명령

​리소스

Hermes Agent 문서

GitHub

Venice 모델 카탈로그

Venice 프라이버시

왜 Venice + Hermes Agent인가요?

설정

1. Hermes Agent 설치

2. Venice를 공급자로 설정

3. 모델 선택

4. 채팅 시작

메시징 플랫폼 연결

프라이버시 모드

Venice API 스킬

주요 명령

리소스