NexSandglass: memory tool for Hermes Agent

Local-only memory plugin for Hermes Agent with drift tracking, four-way search and no external dependencies

What NexSandglass does

NexSandglass, whose Chinese name means sandglass memory system, runs entirely on the local machine using the Python standard library and SQLite, with no API key and no external dependencies. It builds a user profile from fact tags and decision particles, tracks a drift rate across saving money, willingness to invest and giving up, and flags decision fatigue and hesitation patterns. Standing rules the user sets, such as confirming before pushing, are injected automatically and violations are counted.

Search runs four paths at once, a shadow index, SQLite FTS5, an IDX index and TF-IDF, in both Chinese and English. For Hermes, it is installed with hermes plugins install and chosen as the memory provider, and it coexists with the built-in memory while capturing writes through the on_memory_write hook. The README notes that the Hermes Desktop dropdown may not list it because of a Desktop limitation, and gives hermes config set memory.provider nexsandglass as the fix. An optional layer can call a local GGUF model or an OpenAI-compatible endpoint and falls back to pure rules when no model is available.

Key features

Installs as a Hermes plugin and is selected as the memory provider
Local-only: Python standard library and SQLite, no API key
Four-way concurrent search across a shadow index, FTS5, IDX and TF-IDF
Drift-rate tracking and hesitation detection over decision chains
Standing rules injected automatically, with violation counts
Optional local-model summarizing that falls back to rules

When to use it

Giving Hermes Agent a private memory with no cloud service
Tracking how a user's decisions and preferences change over time
Replacing the built-in memory provider with one config setting

Who it is for: Hermes Agent users who want a fully local memory provider; the README is written in Chinese and search handles Chinese and English.

How it fits with Hermes Agent

Built for Hermes Agent as a memory plugin for Hermes Studio and Desktop, installed with hermes plugins install and tagged hermes-agent on GitHub.

How to install NexSandglass

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

pip install nexsandglass
hermes plugins install lovevin1314-tech/NexSandglass
hermes config set memory.provider nexsandglass
hermes plugins update NexSandglass

Requirements: Python, with no API key and no external dependencies (standard library and SQLite)

FAQ

What is NexSandglass?

NexSandglass is a local-only memory system for Hermes Agent, called the sandglass memory system in its Chinese README. It records conversation history, tracks decision drift and injects a short context into each turn.

Does NexSandglass work with Hermes Agent?

Yes. It is installed as a Hermes plugin and set as the memory provider, and it works alongside Hermes' built-in memory.

How do I install NexSandglass?

Run hermes plugins install lovevin1314-tech/NexSandglass, then restart Hermes Desktop and choose NexSandglass in the memory settings. If it is not listed, run hermes config set memory.provider nexsandglass and restart.