selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

hermes-agent-with-webui logo

Self-host hermes-agent-with-webui

v0.52.678

Web UI for Hermes Agent with memory and scheduling

BetaOpen SourceMIT
Updated10 minutes ago
LanguagePython
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
19 523
Port
8787 (HTTP web server)
Requires
Hermes Agent, Python
Docker
ghcr.io/nesquena/hermes-webui
Install with Docker

What is hermes-agent-with-webui?

Hermes WebUI provides a browser-based interface for the Hermes Agent, an autonomous AI agent that keeps context across sessions and executes scheduled tasks while you're away. The WebUI matches the Hermes command-line experience: streaming chat with support for multiple model providers, session organization with projects and tags, a workspace file browser with inline previews, voice input via the Web Speech API, profile switching, optional password and passkey authentication, OIDC login, and a theme/skin system with live preview. It runs as a single Python standard-library HTTP server with a vanilla JavaScript frontend — no build step, framework, or bundler needed. Installation options include a one-line bootstrap script, Docker (single- and multi-container), NixOS module, and manual launch. The server binds to 127.0.0.1:8787 by default and can be reached remotely via SSH tunnels, Tailscale, or Cloudflare Tunnel. Native desktop clients exist for Windows, Linux, and macOS, plus iOS (Hermex) and Android apps. The project is MIT-licensed and developed by the community around nesquena/hermes-webui, running on top of the Hermes Agent by Nous Research.

Should you self-host hermes-agent-with-webui?

hermes-agent-with-webui scores 79/100 on selfhost.directory (how scoring works) and ranks #5 of 120 in AI Assistant. It has 19 523 GitHub stars, +658 in the last 30 days.

It shipped 794 stable releases in the past year. The latest, v0.52.678, came out on 15 November 2026.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is AstrBot (88/100, 46 944 stars). It scores higher overall, so compare the two before you pick. See hermes-agent-with-webui vs AstrBot side by side.

Features

  • Control Center
  • Cron Job Management
  • Model aliases
  • Multi-provider model support
  • OIDC AuthenticationRequires all four config values: issuer, client_id, allow_claim, allow_values
  • Passkey/WebAuthn authentication
  • Password Authentication
  • Profile switching
  • Session Management
  • Skills Management
  • Slash Commands
  • Streaming chat via SSE
  • Theme and skin system
  • Voice InputChrome, Edge, Safari only
  • Workspace file browser

hermes-agent-with-webui README

Hermes Web UI

Hermes Agent is a sophisticated autonomous agent that lives on your server, accessed via a terminal or messaging apps, that remembers what it learns and gets more capable the longer it runs.

Hermes WebUI is a lightweight, dark-themed web app interface in your browser for Hermes Agent. Full parity with the CLI experience - everything you can do from a terminal, you can do from this UI. No build step, no framework, no bundler. Just Python and vanilla JS.

Layout: three-panel. Left sidebar for sessions and navigation, center for chat, right for workspace file browsing. Model, profile, and workspace controls live in the composer footer — always visible while composing. A circular context ring shows token usage at a glance. All settings and session tools are in the Hermes Control Center (launcher at the sidebar bottom).

How to install hermes-agent-with-webui

Install hermes-agent-with-webui with Docker

Docker, Docker Compose

git clone https://github.com/nesquena/hermes-webui cd hermes-webui cp .env.docker.example .env docker compose up -d

Single-container and multi-container compose files available

How to configure hermes-agent-with-webui

  • HERMES_WEBUI_AGENT_DIRauto-discoveredPath to the Hermes Agent source or installed module root
  • HERMES_WEBUI_PYTHONauto-discoveredPython executable
  • HERMES_WEBUI_HOST127.0.0.1Bind address (0.0.0.0 for all IPv4, :: for all IPv6, ::1 for IPv6 loopback)

    values: 0.0.0.0, ::, ::1

  • HERMES_WEBUI_PORT8787Port
  • HERMES_WEBUI_STATE_DIR$HERMES_HOME/webui (Windows default %LOCALAPPDATA%\hermes\webui, POSIX default ~/.hermes/webui)Where sessions and state are stored

hermes-agent-with-webui releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in AI Assistant

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…