Edgehdf5 Memory
HDF5-backed persistent cognitive memory for AI agents.
- Rating
- 3.8 (405 reviews)
- Downloads
- 8,513 downloads
- Version
- 1.0.0
Overview
HDF5-backed persistent cognitive memory for AI agents.
Complete Documentation
View Source →
EdgeHDF5 Memory
Persistent HDF5-backed memory with vector search, BM25 hybrid retrieval, Hebbian learning, and temporal decay.
Setup
# Install the CLI (one-time)
cargo install edgehdf5-cli
# Or from source:
cargo install --path crates/edgehdf5-cli
Set EDGEHDF5_PATH env var or pass --path to every command.
Commands
All output is JSON for easy parsing.
Create a memory file
edgehdf5 --path agent.h5 create --agent-id myagent --dim 384 --wal
Save an entry
Pass JSON via --json or stdin:
edgehdf5 --path agent.h5 save --json '{"chunk":"User asked about weather","embedding":[0.1,0.2,...],"source_channel":"discord","timestamp":1700000000.0,"session_id":"s1","tags":"weather"}'
Embedding must match the dimension specified at creation.
Search memory
edgehdf5 --path agent.h5 search --embedding '[0.1,0.2,...]' --query 'weather forecast' -k 5
Optional: --vector-weight 0.7 --keyword-weight 0.3 (defaults).
Recall a specific entry
edgehdf5 --path agent.h5 recall 42
Stats
edgehdf5 --path agent.h5 stats
Returns: count, active entries, WAL pending, config details.
Flush WAL
edgehdf5 --path agent.h5 flush-wal
Generate AGENTS.md
edgehdf5 --path agent.h5 agents-md
# Or write to file:
edgehdf5 --path agent.h5 agents-md --output AGENTS.md
Export all entries
edgehdf5 --path agent.h5 export
Outputs one JSON object per line (JSONL).
Snapshot
edgehdf5 --path agent.h5 snapshot backup.h5
Workflow: Saving Conversations
- After each exchange, construct a
MemoryEntryJSON with the conversation chunk and its embedding vector - Pipe to
edgehdf5 save - The WAL (if enabled) ensures low-latency writes — flush periodically with
flush-wal
Workflow: Recalling Context
- Embed the current query using your embedding model
- Run
edgehdf5 search --embedding '[...]' --query 'user text' -k 10 - Use returned chunks as context for the response
Notes
- Embeddings must be generated externally (e.g., via an embedding API or local model)
- The
.h5file is a standard HDF5 file readable by any HDF5 library - WAL files are stored alongside the
.h5file as.h5.wal
Installation
openclaw install edgehdf5-memory
💻Code Examples
cargo install --path crates/edgehdf5-cli
Set `EDGEHDF5_PATH` env var or pass `--path <file.h5>` to every command.
## Commands
All output is JSON for easy parsing.
### Create a memory fileedgehdf5 --path agent.h5 create --agent-id myagent --dim 384 --wal
### Save an entry
Pass JSON via `--json` or stdin:edgehdf5 --path agent.h5 save --json '{"chunk":"User asked about weather","embedding":[0.1,0.2,...],"source_channel":"discord","timestamp":1700000000.0,"session_id":"s1","tags":"weather"}'
Embedding must match the dimension specified at creation.
### Search memoryedgehdf5 --path agent.h5 search --embedding '[0.1,0.2,...]' --query 'weather forecast' -k 5
Optional: `--vector-weight 0.7 --keyword-weight 0.3` (defaults).
### Recall a specific entryedgehdf5 --path agent.h5 stats
Returns: count, active entries, WAL pending, config details.
### Flush WALedgehdf5 --path agent.h5 export
Outputs one JSON object per line (JSONL).
### Snapshot# Install the CLI (one-time)
cargo install edgehdf5-cli
# Or from source:
cargo install --path crates/edgehdf5-cliedgehdf5 --path agent.h5 agents-md
# Or write to file:
edgehdf5 --path agent.h5 agents-md --output AGENTS.mdTags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.
Adversarial Prompting
Adversarial analysis to critique, fix.