Community Apps

Hermes Agent

By Andreas Dueren

Self-improving AI agent with multi-platform messaging gateway

v0.23.1-3b4215785882 4096MB Updated 16 Nov 2026
chat
Install this app
In your Cloudron dashboard, open the App Store, choose "Community apps" and paste this URL:
https://git.due.ren/cloudron-apps/hermes/-/raw/main/CloudronVersions.json

Description

Hermes Agent is a self-improving AI assistant by Nous Research. It features a built-in learning loop that creates and refines skills, searches past conversations, and builds user profiles across sessions.

Key Features:

  • Multi-platform messaging: Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email, and more
  • OpenAI-compatible API server for integration with Open WebUI, LobeChat, LibreChat, etc.
  • Flexible LLM support: OpenRouter, OpenAI, Anthropic, xAI/Grok, and custom endpoints
  • Procedural memory with autonomous skill creation
  • Built-in cron scheduler for unattended tasks
  • Parallel subagent processing

An opinionated, best-effort package

This is a community package maintained by one person. It is not made or supported by Nous Research or Cloudron. It is opinionated: it bundles extra tools and changes some defaults to fit a self-hosted Cloudron setup. It is provided as is, on a best-effort basis, without any guarantee of support, response times or compatibility. Read the release notes before updating and keep backups.

Patches to upstream Hermes code (small, rebased on every upstream release, the build fails if upstream changes underneath them):

  • Dashboard login works behind Cloudron's /kanban path prefix and validates the public callback address.
  • The gateway runs without a configured login provider; the dashboard is then switched off with an explanatory 503 page, never exposed without authentication.
  • Email uses Cloudron's sendmail and recvmail addons with separate SMTP and IMAP credentials.
  • The gateway recognizes the package's renamed CLI launchers.
  • Terminal color query replies are kept out of CLI input.
  • Message sending passes media to plugin platforms (needed for Nextcloud Talk).
  • Nextcloud Talk voice transcript echoes reply to the voice message, so they stay in its thread.
  • Messages for secondary profiles are tagged with the profile that serves them.
  • An optional restricted (public) mode with a root-owned policy for a separately supervised, less-trusted profile.
  • Security updates for vulnerable JavaScript dependencies when upstream's lockfile still pins an affected version.

Bundled additions that upstream does not ship:

  • Browsers: CloakBrowser (stealth Chromium over CDP, used by Hermes' browser tools when enabled) and Camofox (anti-detection Firefox), in addition to upstream's Chromium and agent-browser.
  • CLIs: Cloudron CLI, Claude Code CLI, Bitwarden CLI, rclone, Tailscale (userspace networking) and the Nextcloud desktop sync client.
  • A Nextcloud Talk messaging platform plugin and optional Nextcloud/WebDAV workspace sync.
  • Skills: GitLab instance, online search (Perplexity, self-hosted Vane) and Gemini image generation.
  • Profile gateways that run several bots in one app, and an optional supervised restricted profile.
  • Cloudron OIDC login for the dashboard, protected public webhook ingress and a static landing page at /.

Different from upstream's defaults and runtime:

  • Pinned versions instead of upstream's install script: Node.js, Python, uv and a checksum-pinned SQLite build with FTS5. ffmpeg and ripgrep are installed at build time by upstream's own package manager.
  • Hermes does not update itself. The install is marked as externally managed, and updates come only through Cloudron.
  • Stricter build gates: npm and pnpm audits for high and critical advisories, and a minimum release age for dependencies.
  • Backups contain only data that cannot be recreated: sessions, memories, skills, cron jobs, configuration, credentials and your own files. Checkpoints, caches, tool environments, browser binaries and registered git clones live outside /app/data. They are emptied on every restart or update and reinstalled or re-cloned automatically in the background.
  • SQLite integrity is checked before Hermes starts.

Full details, configuration and the exact patch list are in the package README.

Screenshot

Recent Changes

  • Nextcloud Talk: voice transcripts now appear in the voice message's thread. The 🎙️ "…" echo is sent as a reply to the voice message instead of a new main-chat message (Talk 35 threads). Other platforms are unchanged.