Repolode
Submit
outsourc-e

outsourc-e/hermes-workspace

A React/TypeScript web workspace for the Hermes Agent, combining chat, files, terminal, memory, skills and agent monitoring in one UI.

View on GitHubWebsite
Stars
6,733
Forks
1,055
Open issues
179
Last commit
2 days ago

What is it?

Hermes Workspace is a browser-based control panel for Hermes Agent, an AI agent runtime from Nous Research. It provides a single interface for streaming chat with tool-call rendering, browsing and editing agent memory, managing skills and MCP servers, working with workspace files in a Monaco editor, and using a cross-platform terminal.

The workspace connects to two services: the Hermes Agent gateway on port 8642 for chat and models, and the dashboard on port 9119 for sessions, skills, config and jobs. When only an OpenAI-compatible endpoint is available, it runs in a portable mode with basic chat. It also works directly with local runners such as Ollama and Atomic Chat.

The project is built with JavaScript and TypeScript and can be run locally with pnpm, through Docker Compose, or installed as a PWA. It also documents remote access over Tailscale or a LAN, with password protection and cookie settings for non-loopback binds.

Key features

  • 01Streaming chat with tool call rendering and multiple sessions.
  • 02Browse, search and edit agent memory with a markdown editor.
  • 03Skills browser and MCP server management page.
  • 04Workspace file browser with Monaco editor and a cross-platform PTY terminal.
  • 05Works with Ollama, LM Studio, vLLM and other OpenAI-compatible servers in portable mode.
  • 06Installable as a PWA and reachable over Tailscale or LAN.

Use cases

  • Running a self-hosted Hermes Agent and managing chats, memory and skills from a browser.
  • Accessing an agent server from a phone over Tailscale.
  • Chatting with a local model served by Ollama or LM Studio through a web UI.
  • Monitoring multiple agent profiles and their tasks from one dashboard.

Quick start

  1. 1

    Run the one-line installer

    curl -fsSL https://raw.githubusercontent.com/outsourc-e/hermes-workspace/main/install.sh | bash
  2. 2

    Start the Hermes gateway (terminal 1)

    hermes gateway run
  3. 3

    Start the workspace (terminal 2), then open http://localhost:3000

    cd ~/hermes-workspace && pnpm dev

Things to know

  • Requires Node.js 22 or newer and a running Hermes Agent gateway or another OpenAI-compatible backend.
  • Advanced features such as sessions, memory and skills need the Hermes Agent gateway and dashboard; portable mode shows them as unavailable.
  • Conductor depends on upstream dashboard endpoints and falls back to a Workspace-native mode when they are absent.

Topics

#ai-agent#react#typescript#chat-ui#self-hosted#mcp#docker#agent-ui#ai-workspace#hackathon

FAQ

What is hermes-workspace?
A React/TypeScript web workspace for the Hermes Agent, combining chat, files, terminal, memory, skills and agent monitoring in one UI. Hermes Workspace is a browser-based control panel for Hermes Agent, an AI agent runtime from Nous Research. It provides a single interface for streaming chat with tool-call rendering, browsing and editing agent memory, managing skills and MCP servers, working with workspace files in a Monaco editor, and using a cross-platform terminal.
Is hermes-workspace free to use? What license does it have?
hermes-workspace is open source under the MIT license. Check the license terms before using it in commercial products.
Is hermes-workspace still maintained?
Actively maintained. The last commit to hermes-workspace was on Oct 18, 2026.
What can I use hermes-workspace for?
Running a self-hosted Hermes Agent and managing chats, memory and skills from a browser. Accessing an agent server from a phone over Tailscale. Chatting with a local model served by Ollama or LM Studio through a web UI. Monitoring multiple agent profiles and their tasks from one dashboard.
How do I install hermes-workspace?
Run the one-line installer: curl -fsSL https://raw.githubusercontent.com/outsourc-e/hermes-workspace/main/install.sh | bash Start the Hermes gateway (terminal 1): hermes gateway run Start the workspace (terminal 2), then open http://localhost:3000: cd ~/hermes-workspace && pnpm dev
Where can I get hermes-workspace?
The source code and installation instructions are on GitHub: https://github.com/outsourc-e/hermes-workspace

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects