OpenHermit Agent Operations Platform
Deploy AI agents as durable, centrally managed production services with isolated workspaces.
- Source repo
- HCF-STUDIOS/openhermit
- Stars
- ★ 90
- Last updated
- 3d ago
- License
- MIT
- Primary language
- TypeScript
- FA score
- 54/100 · Major gaps
At a glance
- How it runs
- Works with
- Universal · cross-platformOpenAI API (Partial support)
- Cost
- Free software; you pay for model usage
- Setup effort
- High · needs real infrastructure
- You'll need
- Typical use
- An internal platform team needs separate agents for multiple teams or customers, with centrally managed sessions, secrets, and configuration.
- Not a fit if
- Teams seeking a fully managed agent service
- Individuals unwilling to operate a database and gateway
- Source review
- 54/100 · Major gaps
What does this agent do, and when should you use it?
OpenHermit is an open-source platform for deploying and operating fleets of AI agents. Its Hono Gateway provides the control plane, API, authentication, routing, lifecycle management, and scheduling, with an admin UI at /admin/. Agent sessions, memories, instructions, skills, MCP configuration, schedules, and secrets live in PostgreSQL, while workspace files live in a per-agent sandbox. Sandbox options include self-hosted Docker and E2B, Daytona, or Tenki. Users can interact through the CLI, Web UI, and channels such as Telegram, Discord, and Slack; deployment requires operating the database and gateway and configuring a model provider.
An administrator runs hermit setup to configure the database connection and Gateway credentials, then uses commands such as hermit agents create and start to create and run agents. Each agent's sessions, event history, memories, instructions, skills, MCP servers, secrets, and schedules are stored as PostgreSQL state scoped by agent_id, while code runs in that agent's sandbox workspace. The Gateway exposes session routes under /api/agents/{agentId}, including synchronous requests, SSE, WebSocket RPC, approvals, and checkpoints; channel adapters route messages to agents. Administrators can use the CLI or admin UI to distribute instructions, enable skills and MCP servers, manage schedules, and inspect status. Agent replies are delivered through the CLI, Web UI, or enabled channels.
- An internal platform team needs separate agents for multiple teams or customers, with centrally managed sessions, secrets, and configuration.
- An operations team wants agents to run recurring summaries or other scheduled jobs and track their run history.
- A product team wants users to reach platform agents through Telegram, Discord, or Slack.
- An engineering team needs code execution in isolated per-agent workspaces and wants to choose Docker, E2B, Daytona, or Tenki as the sandbox backend.
- A research team needs durable web research runs with a reviewed plan, cited evidence in the final report, and pause-and-resume support.
How do you install or deploy this agent?
Install Node.js/npm and prepare PostgreSQL, Gateway credentials, and a model-provider configuration. Install the npm package globally:
npm install -g openhermitOr install from source:
git clone https://github.com/HCF-S/openhermit.git
cd openhermit
npm installIf using Docker, E2B, Daytona, or Tenki for agent sandboxes, configure the selected backend's runtime as well. The README does not specify a Node.js version.
How do you use this agent?
Set DATABASE_URL, GATEWAY_ADMIN_TOKEN, and GATEWAY_JWT_SECRET, then start the Gateway and Web app and create an agent:
hermit setup
hermit gateway start
hermit web start
hermit status
hermit doctor
hermit agents create main
hermit agents start main
hermit chat --agent mainThe Gateway defaults to http://127.0.0.1:4000, with its admin UI at /admin/; the end-user Web app defaults to http://127.0.0.1:4310. Configure a model provider and set its key with hermit config secrets set; for example:
hermit config set model.provider openai
hermit config set model.model gpt-5-mini
hermit config secrets set OPENAI_API_KEY sk-...An API client can create a session with POST /api/agents/{id}/sessions, then send a message to /api/agents/{id}/sessions/{sessionId}/messages. Use ?stream=true for streaming or connect to that agent's WebSocket RPC endpoint.
What are this agent's strengths and limitations?
- Centralizes sessions, memories, instructions, skills, MCP configuration, schedules, and secrets in PostgreSQL, with per-agent scoping and fleet-wide operations.
- Runs each agent in an isolated sandbox and supports self-hosted Docker plus E2B, Daytona, and Tenki backends.
- Includes Telegram, Discord, and Slack adapters alongside CLI, Web UI, HTTP/SSE, and WebSocket interfaces.
- Schedules support timeouts, concurrency policies, and error backoff; Deep Research runs persist, can pause and resume, and produce reports with cited evidence excerpts.
- Self-hosting requires configuring PostgreSQL, Gateway authentication secrets, and a model provider, then operating the services.
- Deep Research can use many model calls and input tokens; the README provides worst-case budgets, and free model quotas are usually insufficient.
- Deep Research currently supports HTML/text web sources only; PDFs, uploaded files, and MCP sources are unsupported, and an unclean restart requires manual resume.
- The README does not specify a minimum Node.js version; cloud sandbox backends also require their provider configuration.
How does this agent compare with similar options?
The README contrasts OpenHermit with file-based CLI agents such as Claude Code, OpenClaw, and Hermes: OpenHermit centralizes internal state in PostgreSQL and provides fleet operations. It does not compare their detailed feature sets or document migration paths.
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| OpenHermit Agent Operations Platform This agent | 54 · Major gaps | CLIFree + model costs | ★ 90 | 3d ago | TypeScript | — |
| Dorothy Agent Workbench | 48 · Major gaps | Desktop appFree + model costs | ★ 357 | 16d ago | TypeScript | Claude Code |
| SuperAgentX Workflow Framework | 43 · Major gaps | Library / SDKFree + model costs | ★ 207 | 4mo ago | Python | OpenAI API |
| OpenClaw Chinese Edition | 53 · Major gaps | CLIFree + model costs | ★ 3.8k | today | JavaScript | OpenAI API · Claude API |
How does FollowAgents rate this agent?
Why each dimension lost points
least_privilege: docs clearly separate host/docker/e2b/daytona/tenki sandboxes, flag the host backend as devops-only and requiring private access, and layer roles with policy; however safe defaults still depend on the operator tightening policy, so not full marks. user_confirmation: the policy/approval chapter defines allow/deny/require_approval, most-restrictive-wins, and timeout-as-reject, with solid evidence. data_flow_transparency: README and the Internal State table explain PostgreSQL-backed state, encrypted secrets, attachment backends, and env-only credentials. sensitive_data_handling: AES-256-GCM encryption of agent_secrets and channel credentials with credentials kept out of config, but no key rotation or audit detail, deducted. dependency_security: only top-level package.json is visible; no lockfile audit, vulnerability scanning, or SBOM evidence. external_effects: exec, MCP, and channel egress create external side effects; a policy layer exists but approval is not enforced by default, deducted. rollback: checkpoint routes and sandbox soft-delete exist, but soft-delete does not reclaim e2b/daytona remote resources, so rollback semantics are incomplete. source_attribution: README points to Amiko and the repo, but publisher identity is unverified and the FAQ's 'licence is operator-known' conflicts with the MIT declaration, deducted.
self_consistency: README, SKILL.md, and manual agree on CLI commands, env vars, and state model, but the FAQ's licence statement conflicts with LICENSE and the skill's exec backend list (docker/host/e2b) diverges from the five-backend sandbox doc, deducted. dependency_availability: Node>=20, PostgreSQL, a model API key, and optional E2B/Daytona/Tenki/S3/Supabase SDKs are documented, but no lockfile or pinned-version evidence is shown, deducted. failure_messages: the troubleshooting chapter is symptom-first with concrete checks, CLI/gateway code catches errors and sets exit codes, and a doctor command exists; coverage is good but not exhaustive.
audience_and_scenarios: separate admin and end-user skills plus a manual spanning quickstart to operations make the audience and scenarios clear. capability_boundaries: skill descriptions scope each skill and cross-reference the other, and the tool table lists default role grants, so boundaries are clear. trigger_precision: skill descriptions are single-sentence triggers, but skill-creator's own examples and rules are generic and activation relies on model judgment, deducted. environment_fit: supports local, Docker, cloud sandboxes, multiple model providers, and local Ollama, giving broad environment fit.
information_architecture: README is well structured and docs/ plus the numbered manual provide clear navigation. install_notes: global npm install, setup wizard, docker compose Postgres, and a full env var table are present. naming_stability: README uses HCF-S/openhermit while the skill file cites HCF-STUDIOS/openhermit, an inconsistency, deducted. examples_and_faq: Quick Start, CLI reference, FAQ, troubleshooting, and recipes give ample examples. known_limitations: Deep Research explicitly lists PDF unsupported, web-only sources, and manual resume after unclean restart, and the host backend risk is flagged. license: LICENSE is MIT and package.json declares MIT, consistent. versioning_changelog: monorepo version is 0.0.0 with no CHANGELOG or release policy, deducted. maintenance_responsibility: README points to Amiko and contributing guidance, but the publisher is unverified and ownership of maintenance is not clearly established, deducted.
output_usability: CLI, API, web UI, and channel adapters are all present, so outputs are directly usable for deployment and operations. marginal_value: it addresses centralized multi-agent state and sandboxed execution, a clear increment over file-based agents. cost_benefit: the Deep Research section gives per-depth token and cost caps plus a local-model path, making cost predictable, though Postgres and model spend are required, so a small deduction.
claim_traceability: most README claims trace to docs/ and source files, but some performance and cost figures lack stated measurement methods. cross_source_corroboration: README, SKILL.md, and manual corroborate each other in many places, but the repo name and licence wording are inconsistent, deducted. fact_inference_separation: docs mostly separate design from current state, but phrases like 'verified registry ids' lack a checkable source, deducted.
- Publisher identity is unverified and the repo name differs between README (HCF-S) and the skill file (HCF-STUDIOS); verify provenance before deployment.
- The host sandbox backend gives unsandboxed shell access to the gateway host and must be paired with private access and strict policy; never use it for general-purpose agents.
- Default policy does not automatically require approval for exec or MCP calls; operators must explicitly configure require_approval and deny rules.
- Soft-deleting a sandbox does not reclaim e2b/daytona remote resources, so clean them up manually to avoid ongoing billing.
- Deep Research is model-intensive, with single extraction calls up to ~50k input tokens; free tiers are usually insufficient, so budget for paid keys.
- The FAQ says the licence is 'operator-known', conflicting with the MIT declaration; confirm licensing terms before compliant use.
- No lockfile audit, dependency vulnerability scanning, or SBOM is shown; perform your own dependency security review before production use.
FAQ
What infrastructure does OpenHermit need?
DATABASE_URL, GATEWAY_ADMIN_TOKEN, and GATEWAY_JWT_SECRET, plus a running Gateway and a configured model provider. Agent workspaces need Docker or a supported cloud sandbox backend.How much can Deep Research cost?
quick with gpt-5-mini to about $4.50 for thorough with claude-sonnet-4-5; search charges are separate.How are secrets stored?
OPENHERMIT_SECRETS_KEY. Without it, the Gateway falls back to per-agent secrets.json for local development secrets, but DB-backed channel credentials are unavailable.How can users message an agent?
Can Deep Research use PDFs or uploaded files as evidence?
Thanks — we use this to improve the page.