API Server
The API server exposes hermes agent as an OpenAI compatible HTTP endpoint. Any frontend that speaks the OpenAI format — Open WebUI, LobeChat, LibreChat, NextCha
The API server exposes hermes-agent as an OpenAI-compatible HTTP endpoint. Any frontend that speaks the OpenAI format — Open WebUI, LobeChat, LibreChat, NextChat, ChatBox, and hundreds more — can connect to hermes-agent and use it as a backend. …
What this page covers
- Quick Start
- 1. Enable the API server
- 2. Start the gateway
- 3. Connect a frontend
- Endpoints
- POST /v1/chat/completions
- POST /v1/responses
- GET /v1/responses/\{id\}
- DELETE /v1/responses/\{id\}
- GET /v1/models
- GET /v1/capabilities
- GET /health
- GET /health/detailed
- Runs API (streaming-friendly alternative)
- POST /v1/runs
- GET /v1/runs/\{runid\}
- GET /v1/runs/\{runid\}/events
- POST /v1/runs/\{runid\}/stop
- POST /v1/runs/\{runid\}/approval
- Jobs API (background scheduled work)
- GET /api/jobs
- POST /api/jobs
- GET /api/jobs/\{jobid\}
- PATCH /api/jobs/\{jobid\}
- DELETE /api/jobs/\{jobid\}
- POST /api/jobs/\{jobid\}/pause
- POST /api/jobs/\{jobid\}/resume
- POST /api/jobs/\{jobid\}/run
- Sessions API (session control over REST)
- Skills and toolsets discovery
- Long-term memory scoping (X-Hermes-Session-Key)
- System Prompt Handling
- Authentication
- Configuration
- Environment Variables
- config.yaml
- Security Headers
- CORS
- Compatible Frontends
- Multi-User Setup with Profiles
- Limitations
- Proxy Mode
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Core Features
Features Overview
Hermes Agent includes a rich set of capabilities that extend far beyond basic chat. From persistent memory and file aware context to browser automation and voic
Tools & Toolsets
Tools are functions that extend the agent's capabilities. They're organized into logical toolsets that can be enabled or disabled per platform. Available Tools
Skills System
Skills are on demand knowledge documents the agent can load when needed. They follow a progressive disclosure pattern to minimize token usage and are compatible
Curator
The curator is a background maintenance pass for agent created skills . It tracks how often each skill is viewed, used, and patched, moves long unused skills th
Persistent Memory
Hermes Agent has bounded, curated memory that persists across sessions. This lets it remember your preferences, your projects, your environment, and things it h
Memory Providers
Hermes Agent ships with 8 external memory provider plugins that give the agent persistent, cross session knowledge beyond the built in MEMORY.md and USER.md. On