---
title: Hermes Agent
emoji: 🦕
colorFrom: purple
colorTo: indigo
sdk: docker
pinned: false
app_port: 7860
---

# Hermes Agent + WebUI

Self-hosted [Hermes Agent](https://github.com/NousResearch/hermes-agent) by Nous Research with [hermes-webui](https://github.com/nesquena/hermes-webui).

## Required HF Secrets

At least one provider key:

| Secret | Description |
|--------|-------------|
| `OPENROUTER_API_KEY` | OpenRouter (200+ models) |
| `GROQ_API_KEY` | Groq free models |
| `DEEPSEEK_API_KEY` | DeepSeek |
| `GOOGLE_API_KEY` | Gemini |
| `ANTHROPIC_API_KEY` | Claude |

## Optional Secrets

| Secret | Description |
|--------|-------------|
| `HERMES_WEBUI_PASSWORD` | Password-protect the UI |
| `TELEGRAM_BOT_TOKEN` | Telegram bot |
| `TELEGRAM_ALLOWED_USERS` | Comma-separated Telegram user IDs |
| `HERMES_PROVIDER` | Override provider (e.g. groq) |
| `HERMES_MODEL` | Override model |