HermesFace
democra-ai/HermesFace
Deploy Hermes Agent on Hugging Face Spaces with data persistence through a Hugging Face Dataset
HermesFace is a Hugging Face Space template that runs Hermes Agent in a Docker container on Hugging Face Spaces. It gives Hermes Agent users a way to host the agent without their own server, with state persisted by syncing to a Hugging Face Dataset.
What HermesFace does
HermesFace packages Hermes Agent as a Space you duplicate. After duplicating, you set repository secrets: HF_TOKEN, an access token with write permission, is required, along with at least one LLM API key such as OPENROUTER_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, NOUS_API_KEY or GOOGLE_API_KEY. Setting AUTO_CREATE_DATASET to true makes HermesFace create a private backup dataset on first startup.
The README says the Space gets 2 vCPU and 16 GB of RAM from Hugging Face at no cost, and that conversations, skills, memories and config survive restarts through the Dataset sync. It lists Telegram, Discord, Slack, WhatsApp, Signal, WeChat and iMessage among 16 or more channels, 47 built-in tools, and a React-based web dashboard for config, API keys and session monitoring. After duplicating, you should edit the datasets field in the Space's README to point at your own dataset repo or remove it.
Key features
- Duplicate-the-Space deployment of Hermes Agent on Hugging Face Spaces
- State persistence through Hugging Face Dataset sync
- Optional automatic creation of a private backup dataset
- Support for OpenRouter, OpenAI, Claude, Gemini and Nous Portal keys
- Web dashboard for config, API keys and session monitoring
When to use it
- Run a Hermes agent on Telegram or Discord without renting a VPS
- Try Hermes Agent on hosted infrastructure before buying hardware
- Keep a hosted agent's memories and skills across Space restarts
Who it is for: People who want to host Hermes Agent on Hugging Face Spaces instead of their own machine or server.
How it fits with Hermes Agent
Built around Hermes Agent: it wraps the agent in a Docker Space and adds Dataset-based persistence.
Requirements: A Hugging Face account with an HF_TOKEN that has write permission, and at least one LLM API key.
Note: Persistence relies on syncing data to a Hugging Face Dataset, so an HF token with write permission is required.
FAQ
What is HermesFace?
HermesFace is a Hugging Face Space that runs Hermes Agent on Hugging Face Spaces and keeps its data by syncing to a Hugging Face Dataset, so you do not need your own server.
What do I need to run HermesFace?
You need to duplicate the Space and set the HF_TOKEN secret with write permission plus one LLM API key, such as an OpenRouter key. Setting AUTO_CREATE_DATASET to true is recommended.
Is HermesFace free and open source?
Yes. The repository is published under the MIT license, and the README says Hugging Face Spaces provides the 2 vCPU and 16 GB of RAM at no cost.
Similar deployment for Hermes Agent
All deploymentProvision a hardened Hermes Agent on Hetzner with rootless Podman and Tailscale
mrobinson2 AzureAgentForgeTerraform-deployed multi-agent platform on Azure combining PaperClip, Hermes and Honcho
niyazmft Droid AI ToolkitTermux toolkit for running OpenClaw, Hermes, Ollama, n8n and other AI tools on Android
UndermountainCC hermes-operatorKubernetes operator that deploys and manages Hermes Agent instances from a HermesAgent resource
fly-apps Hermes Agent on Fly.ioExample deployment of Hermes Agent as a Fly.io Machines app with messaging access
orailnoor Pi DuckyRaspberry Pi Zero USB keyboard gadget that deploys Hermes Agent, Tailscale and RustDesk on a computer
Related guides: How to run Hermes Agent securely · How to install Hermes Agent · Connect Hermes agents on several machines with Hermes Desktop