Summary

Hermes Workspace provides a comprehensive, native web-based command center for AI agents, specifically targeting the Hermes Agent framework. It integrates chat, file management, memory browsing, skill orchestration, and a PTY terminal, offering a unified interface for developers and researchers to manage and interact with AI agents efficiently.

How It Works

The system features a direct FastAPI backend connection to the Hermes Agent, utilizing real-time Server-Sent Events (SSE) for streaming agent output and tool call rendering. Its core architecture is a Progressive Web App (PWA), ensuring full feature parity across desktop and mobile devices. The approach emphasizes deep integration with agent memory, skills registry, and a robust terminal interface.

Quick Start & Requirements

• Prerequisites: Node.js (>= 22.0.0), Python (>= 3.11).
• Core Dependency: Requires a specific fork of NousResearch/hermes-agent with WebAPI support (hermes webapi).
• Installation: Clone the workspace, run pnpm install, configure .env with HERMES_API_URL, and start with pnpm dev.
• Docker: Clone, copy .env.example to .env, and run docker compose up.
• API Providers: Supports Anthropic, OpenAI, OpenRouter, or local Ollama models via environment variables.
• Links: Node.js, Python.

Highlighted Details

• Real-time SSE streaming for agent output and tool calls.
• Comprehensive agent memory browsing, searching, and editing.
• Access to and management of over 2,000 skills from a registry.
• Full PTY terminal with persistent shell sessions and direct workspace access.
• Security hardening includes auth middleware, CSP headers, and exec approval prompts.
• Mobile-first PWA design ensures native-like experience on all devices.

Maintenance & Community

The project is actively developed by @outsourc-e and the community. A roadmap is available, detailing shipped and in-development features. Contribution guidelines are provided via CONTRIBUTING.md.

Licensing & Compatibility

Licensed under the MIT license, permitting broad use, modification, and distribution, including for commercial purposes.

Limitations & Caveats

Full functionality is contingent on using the outsourc-e/hermes-agent fork; the upstream agent will result in degraded features. Key components like a native Electron desktop app and a cloud-hosted version are still under active development. Model switching and configuration are also marked as in-development.