hermes-nexusyn 1.0.0

Nexusyn memory provider plugin for Hermes Agent — multi-agent memory with hybrid retrieval, per-agent attribution, project scoping and server-side distillation.

hermes-nexusyn

Nexusyn memory provider plugin for Hermes Agent — cross-session, multi-agent memory with hybrid retrieval, per-agent attribution, project scoping and server-side distillation.

Nexusyn is a multi-tenant memory engine built for teams of AI agents: every memory is attributed to the agent that saved it, can be scoped to a project, and is retrieved with hybrid search (vector + full-text + reranking). A server-side compile pipeline automatically distills raw memories into wiki articles, lessons, decisions and error reports — visible in the Nexusyn dashboard.

Install

pip install hermes-nexusyn
hermes-nexusyn install
hermes config set memory.provider nexusyn
hermes memory setup        # or: echo "NEXUSYN_API_KEY=your-token" >> ~/.hermes/.env

Create an API token in the Nexusyn dashboard (Settings → API Tokens).

hermes-nexusyn install copies the plugin into $HERMES_HOME/plugins/nexusyn/, where Hermes Agent's plugin discovery picks it up. Use --home <path> for non-default profiles. hermes-nexusyn status shows the install state; hermes-nexusyn uninstall removes it.

Tools (4)

• nexusyn_search — hybrid search across memories; returns ranked chunks with memory ids
• nexusyn_query — grounded answer synthesized from memories, with sources
• nexusyn_remember — persist a fact, preference, decision or lesson
• nexusyn_forget — delete a memory by id

Configuration

Key	Env var	Default	Description
api_key	NEXUSYN_API_KEY	—	API token (required)
base_url	NEXUSYN_BASE_URL	https://api.nexusyn.ai	Engine endpoint (cloud or self-hosted)
project	NEXUSYN_PROJECT	"" (global)	Project slug — recall returns the project's memories plus globals
agent	NEXUSYN_AGENT	hermes	Agent slug for memory attribution
prefetch	NEXUSYN_PREFETCH	on	Background recall before each turn
sync	NEXUSYN_SYNC	session	Turn persistence: session, turn, or off

Full behavior reference: see the plugin README.

Data & privacy

Conversation turns (or session digests), built-in memory writes, and search queries are sent to the configured Nexusyn endpoint. Point NEXUSYN_BASE_URL at a self-hosted engine to keep data on your infrastructure.

License

MIT