Metadata-Version: 2.4
Name: hermes-nexusyn
Version: 1.0.0
Summary: Nexusyn memory provider plugin for Hermes Agent — multi-agent memory with hybrid retrieval, per-agent attribution, project scoping and server-side distillation.
Author-email: Nexusyn <support@nexusyn.ai>
License: MIT
Project-URL: Homepage, https://nexusyn.ai
Project-URL: Documentation, https://nexusyn.ai/docs
Project-URL: Repository, https://github.com/nexusyn/hermes-nexusyn
Keywords: hermes,hermes-agent,memory,nexusyn,ai,agents
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# hermes-nexusyn

[Nexusyn](https://nexusyn.ai) memory provider plugin for [Hermes Agent](https://github.com/NousResearch/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

```bash
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](https://app.nexusyn.ai) (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](https://github.com/nexusyn/hermes-nexusyn/blob/main/src/hermes_nexusyn/plugin/README.md).

## 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
