# Hermes Agent

Hermes Agent is a self-improving AI agent by Nous Research that creates and refines skills from experience, builds a persistent model of you across sessions, and runs on any infrastructure from a low-cost VPS to a GPU. It is open source and self-hosted, installable on Docker Hub, Proxmox, Kubernetes (Helm), ZimaOS, TrueNAS, Umbrel and Unraid.

Canonical page: https://ourlocalhost.com/app/529/hermes-agent

## Description

Hermes Agent is a self-improving AI agent by Nous Research that creates and refines skills from experience, builds a persistent model of you across sessions, and runs on any infrastructure from a low-cost VPS to a GPU cluster with support for any model provider.

## Platform availability

Available on 6 of 9 platforms: Unraid, TrueNAS, Umbrel, ZimaOS, Proxmox, Helm.

## Health score

73/100 (Good), based on 4 of 4 factors.
- Maintained: 70 (last commit 17 days ago)
- Popular: 100 (251,654 GitHub stars)
- Easy to install: 85 (6 install platforms, install notes, Docker image)
- Light to run: 20 (8 GB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/nousresearch/hermes-agent/
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=hermesagent
- Kubernetes (Helm): https://artifacthub.io/packages/helm/hermes-agent/hermes-agent
- ZimaOS: https://github.com/IceWhaleTech/CasaOS-AppStore/tree/main/Apps/Hermes
- TrueNAS: https://apps.truenas.com/catalog/hermes-agent/
- Umbrel: https://apps.umbrel.com/app/hermes-agent
- Unraid: https://ca.unraid.net/apps/hermes-agent-09ajzql1sqn7yp?q=Hermes-Agent
- Official website: https://hermes-agent.nousresearch.com/
- GitHub: https://github.com/NousResearch/hermes-agent
- Documentation: https://hermes-agent.nousresearch.com/docs

## Common questions

### How can I confirm the Hermes Agent terminal install worked?

After installing, open a terminal and run hermes doctor, then test a simple message with hermes chat -q 'Hello'. If the command is not found or the test chat fails, the install or model connection is not finished.

### How do I connect a model and the Tool Gateway tools in one step?

Run hermes setup --portal, which uses one OAuth to cover a model plus web search, image generation, TTS, and browser tools.

### Can I reach Hermes Agent from messaging apps rather than only the CLI?

Yes, it connects to Telegram, Discord, Slack, WhatsApp, Signal, and CLI from a single gateway process.

### Can I use a model endpoint other than Nous Portal?

You can use OpenRouter, OpenAI, your own endpoint, or other supported providers, and switch with hermes model.

### Can I run unattended scheduled tasks with Hermes Agent?

The built-in cron scheduler can run natural-language automations such as daily reports, nightly backups, and weekly audits with delivery to any platform.

## Alternatives

- Goose OSS: An Open Source AI Agent (think Claude CoWork) that help you to automates engineering tasks seamlessly with local execution, customization,…
- Khoj: Open-source platform supporting local and cloud AI chat, semantic search, document retrieval, and image generation across multiple devices…
- Kimi: AI tool for reasoning across math, coding, and image analysis, processing up to 128k tokens, handling visual data, benchmarks, and chain-of…
- LocalAI: LocalAI is a free, open-source, self-hosted AI engine that provides a drop-in, OpenAI-compatible API for running local models.
- Maid (AI): Maid is a cross-platform Flutter app for interfacing with GGUF / llama.cpp models locally, and with Ollama and OpenAI models remotely.
- Manus: Transforms thoughts into actions with personalized travel itineraries, stock analysis, and educational content while autonomously completin…
- Odysseus: Self-hosted AI workspace with chat, agents, deep research, documents, email, calendar, and model Cookbook.
- OpenClaw: OpenClaw is an open-source, self-hosted AI assistant gateway that connects large language models (LLMs) to Discord, Telegram, and WhatsApp,…
- Poe: Poe is a web-based AI platform that hosts multiple assistant bots—including Claude and various GPT and image/audio models—to provide conver…
- Together Chat: Together Chat is a next-generation consumer app designed to let you interact seamlessly with today's most popular open-source models, inclu…
- nanoclaw: NanoClaw is a lightweight, secure personal AI assistant that runs each agent in its own isolated container on your own server.

---
Source: Our Local Host (https://ourlocalhost.com/app/529/hermes-agent), the self-hosted and open-source app directory.
