nexus.yaml 3.5 KB

123456789101112131415161718192021222324252627282930
  1. name: nexus
  2. repo: https://github.com/Neboy72/nexus-memory
  3. sha: 783488328eee1a9ae29ea6ae62bdb63be5dfade3
  4. subdir: plugins/memory/nexus
  5. version: "0.22.45"
  6. description: "Self-hosted long-term memory on Qdrant: automatic per-turn prefetch and write-back, plus recall/remember/forget, guardrail rules and a knowledge graph; Hermes and any MCP-connected agent share one collection. Embeddings run fully local by default (sentence-transformers with Qwen/Qwen3-Embedding-0.6B, 1024d, about 1.2 GB from Hugging Face on first use; on Apple Silicon the model is pinned to the CPU, because PyTorch's MPS backend aborts the whole process under two overlapping encodes). A cloud embedder runs only when NEXUS_EMBEDDING_PROVIDER names it and its key is present, and a key that merely sits in the environment never selects one. Access levels fail closed: a memory, a protection rule or a graph label without a known level counts as the most restrictive. A local service on 127.0.0.1:9122 serves embeddings and the full MCP toolset; its /embed and /mcp routes demand a per-installation key (service_auth.key, mode 0600) and reject non-loopback Host/Origin, while the open /healthz answers liveness only. The plugin starts that service when Hermes cannot load the embedding stack, and it keeps running afterwards. Session-end fact extraction sends conversation text to the model endpoint from Hermes config.yaml, and the consolidation daemon to its configured model, which defaults to Hermes's own default model through local Ollama; reads ~/.hermes/.env and config.yaml; state and daily backups under ~/.nexus-memory; NEXUS_UPDATE_CHECK=1 opts into a GitHub release check. Disclosure — when Hermes cannot load the embedding stack (and always on Apple Silicon unless NEXUS_EMBED_IN_HOST=1), the plugin starts `nexus-memory serve` on 127.0.0.1:9122 (embeddings, the full Nexus MCP toolset and a consolidation daemon that sends memory text to the Ollama endpoint at 127.0.0.1:11434 or NEXUS_OLLAMA_BASE under the model named by NEXUS_CONSOLIDATION_MODEL, nexus-memory.consolidation_model or Hermes's model.default, which can be an Ollama cloud model), and the service keeps running after Hermes exits; its /embed and MCP routes require a per-install key in ~/.nexus-memory/service_auth.key (0600) and a loopback Host/Origin; session-end fact extraction sends conversation text to the model endpoint in Hermes config.yaml, and the opt-in recall reranker (nexus-memory.rerank or NEXUS_RERANK=1) defaults to sending each query plus up to 20 memory snippets to that same endpoint using the provider API key it reads from config.yaml; reads ~/.hermes/.env and config.yaml; state and daily backups under ~/.nexus-memory; opt-in NEXUS_UPDATE_CHECK=1 adds a GitHub release check and an upgrade nudge to the system prompt."
  7. maintainer: Neboy72
  8. tier: community
  9. category: memory
  10. requires_hermes: ">=0.19"
  11. docs_url: https://github.com/Neboy72/nexus-memory/blob/783488328eee1a9ae29ea6ae62bdb63be5dfade3/plugins/memory/nexus/README.md
  12. image: https://raw.githubusercontent.com/Neboy72/nexus-memory/783488328eee1a9ae29ea6ae62bdb63be5dfade3/docs/images/nexus-logo-square.png
  13. capabilities:
  14. provides_tools:
  15. - nexus_recall
  16. - nexus_remember
  17. - nexus_forget
  18. - nexus_guardrail_check
  19. - nexus_guardrail_override
  20. - nexus_graph_traverse
  21. - nexus_find_entities
  22. - nexus_get_subgraph
  23. - nexus_get_related
  24. - nexus_cost_routing_stats
  25. - nexus_cost_routing_explain
  26. - nexus_sica_run
  27. provides_hooks:
  28. - transform_llm_output
  29. provides_middleware: []
  30. requires_env: []