hermes-lcm-x.yaml 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. name: hermes-lcm-x
  2. title: LCM-X
  3. repo: https://github.com/electricsheephq/lcm-x
  4. sha: 984a40045372f1f24a87d060194786f4d1843b90
  5. subdir: plugin
  6. description: "Lossless memory for long sessions: LCM-X keeps every turn in a local store instead of compacting it away, and the agent can search and expand it. The store is local SQLite (lcm.db) with a recoverable DAG of summaries over it and 16 lcm_* tools for search, recall and expansion (lcm_memory only with LCM_ENTITIES_ENABLED=1). Select it with context.engine: lcm-x. Upgrading from hermes-lcm (breaking in v0.24.0): stop Hermes, then in plugins.enabled replace hermes-lcm with hermes-lcm-x and run exactly one LCM copy (the install script prints the steps; the old engine name lcm still resolves with a deprecation warning); lcm.db and the lcm: config block are unchanged. Summaries use the model Hermes is configured with. Disclosure — local semantic recall is on by default once its dependency companion is installed (hermes plugins install electricsheephq/lcm-x/companions/hermes-lcm-x-local-embeddings --ref <the LCM-X commit>; it carries fastembed): summaries and message chunks are embedded in-process with BAAI/bge-small-en-v1.5 after a one-time model download, in the background, and stay on the machine. Without the companion, recall answers from full text and lcm_doctor prints the install command; on hosts with 2 or fewer effective CPUs the default answers from full text unless LCM_EMBEDDINGS_ENABLED=true; LCM_EMBEDDINGS_ENABLED=false turns semantic recall off. Cloud embedding providers (Voyage via VOYAGE_API_KEY, an OpenAI-compatible endpoint, or a local Ollama) send message text to that provider and run only with LCM_EMBEDDINGS_ENABLED=true and an explicit model. For known cloud providers the provider-bound copy is privacy-transformed by default (LCM_EMBEDDING_PRIVACY_ENABLED=false opts out), while lcm.db keeps the raw text. Every turn (user, assistant and tool output) is stored in plaintext in lcm.db (secret redaction at rest is opt-in); on gateway platforms the sender's platform user ID is recorded with each user message by default (LCM_SENDER_CAPTURE=0 turns it off), and oversized tool outputs are by default written as plaintext files under HERMES_HOME/lcm-large-outputs and replaced in the model's context by recoverable references. The engine also reads Hermes' state.db read-only for session lineage, reads private AIAgent attributes via the call stack on Hermes builds without subagent hooks, and runs git on its own install directory for lcm_status/lcm_doctor; tiktoken may fetch its BPE file on first use."
  7. maintainer: 100yenadmin
  8. tier: community
  9. category: memory
  10. requires_hermes: '>=0.21.3'
  11. docs_url: https://github.com/electricsheephq/lcm-x#readme
  12. version: "0.29.1"
  13. image: https://raw.githubusercontent.com/electricsheephq/lcm-x/3a4a08ff501347a79669fab51444c471b09b551d/docs/media/banner.png
  14. platforms: []
  15. capabilities:
  16. provides_tools:
  17. - lcm_grep
  18. - lcm_recall
  19. - lcm_query_state
  20. - lcm_compute
  21. - lcm_compile_evidence
  22. - lcm_evidence_pack
  23. - lcm_retrieve
  24. - lcm_recent
  25. - lcm_load_session
  26. - lcm_describe
  27. - lcm_expand
  28. - lcm_expand_query
  29. - lcm_status
  30. - lcm_inspect
  31. - lcm_doctor
  32. - lcm_memory
  33. provides_hooks:
  34. - pre_llm_call
  35. - post_llm_call
  36. - subagent_start
  37. - subagent_stop
  38. provides_middleware: []
  39. requires_env: []