Skip to main content
Give your Hermes agents persistent memory with ByteRover. The ByteRover memory provider automatically native retrieves relevant knowledge before each response, curates new insights after each turn, and preserves context before compression — so your agents remember decisions, patterns, and fixes across sessions.

​
Prerequisites

Ensure the following are installed and available in your PATH:

​
ByteRover CLI initialization

ByteRover CLI needs an LLM provider to power its curation and query features. Supported list: ByteRover, OpenRouter, Anthropic, OpenAI, Google Gemini, xAI, Groq, Mistral, DeepInfra, Cohere, Together AI, Perplexity, Cerebras, Vercel, MiniMax, GLM, Moonshot AI, and OpenAI Compatible. To see all available providers:
Run one of the following to get started:

​
Hermes integration guide

Option 1 — Interactive setup (recommended):
When prompted, select byterover from the list of available memory providers. Option 2 — Manual configuration:
After memory configuration, restart your Hermes gateway:
If you get stuck on the gateway restart command, reinstall the gateway:
Then start the Hermes gateway:
Then restart the Hermes gateway:

​
Features

​
Context Retrieval

Before each LLM call, the provider runs brv query with the user’s message and injects the results as additional context. Your agent automatically has relevant memories, past decisions, and patterns available without any manual prompting.

​
Automatic Curation

After each conversation turn, the provider runs brv curate in the background to extract and store valuable knowledge — architectural decisions, bug fixes, recurring patterns, and more. This happens asynchronously and does not add latency to responses.

​
Pre-Compression Flush

When the agent’s context window approaches compression, the provider extracts and stores insights before the conversation history is summarized. Nothing valuable is lost when the context is compacted.

​
Hermes Agent Tools

ByteRover integration exposes three tools that your agent can call directly: Context-tree directory: $HERMES_HOME/byterover/.brv (profile-scoped, created automatically on first use)

LLM Providers

Connect an external provider or use the built-in LLM

Onboard Context

Learn how to seed your context tree with existing knowledge

Reference

Troubleshooting, error

Local & Cloud

Exploring local & cloud options