首款具有全息存储功能的 AI 助理
A personal AI assistant that remembers. Nuggets combines holographic memory with a multi-channel messaging gateway so your AI actually learns from conversations — facts recalled often get promoted to permanent memory, and everything persists across restarts.
If you want the new plugin/MCP version of Nuggets for coding agents, start here.
Package:
nuggets-memory-pluginInstall:
npm install -g nuggets-memory-pluginThen register it with your agent host using the host's native MCP command.
hermes mcp add nuggets-memory --command nuggets-memory-pluginclaude mcp add nuggets-memory -- nuggets-memory-plugincodex mcp add nuggets-memory -- nuggets-memory-pluginWhat the plugin is for:
guide, nudges, recall, remember, list, and statusNotes:
npx.nuggets-memory/.LLM agents forget everything between sessions. RAG systems fix this but need vector databases, embedding APIs, and infrastructure. Nuggets takes a different approach:
Think of it as an AI that lives in your pocket, remembers what matters, and reaches out when it has something useful to say.
src/nuggets/)The core of the system. Pure TypeScript, zero dependencies.
Each "nugget" is a topic-scoped memory (e.g., user, project, agent). Facts are key-value pairs compressed into a fixed-size complex vector via HRR binding. Multiple facts superpose into one mathematical object but remain individually retrievable.
MEMORY.md for permanent contextuser (preferences), project (files, commands, repo context), or agent (self-knowledge) scopes. Recall searches across kinds in priority order.Storage is a simple JSON file per kind at ~/.nuggets/ (e.g., user.nugget.json, project.nugget.json). Vectors are never serialized — they're rebuilt deterministically from a seeded PRNG, so the files stay tiny. A migration script (npm run migrate:memory) splits legacy single-file memory into the new kind-based layout.
src/gateway/)A multi-channel message router that connects your AI to Telegram and WhatsApp.
.pi/extensions/)Hooks into the Pi agent lifecycle:
nuggets tool for remember/recall/forget with memory kind routing, auto-captures file paths and user preferences from conversation, injects memory into system promptschedule tool so it can create reminders and recurring tasks on its ownnpm install -g @mariozechner/pi-coding-agentnpm install -g @mariozechner/pi-coding-agent # install Pi (if not already)
git clone https://github.com/NeoVertex1/nuggets.git
cd nuggets
npm install
npm run setup
npm run devnpm run setup walks you through configuration interactively and is the recommended path for first run because it writes .env for you:
…The wizard validates inputs (API key format, token format, numeric chat ID), shows masked current values if .env already exists, and writes the file atomically.
/newbot, follow the prompts. You'll get a token like 123456789:AAF7_NRCOM2nxZt.../start. It replies with your numeric chat ID.npm run setup, paste both values, and you're done.…Message flow: You send a message → gateway routes it to your Pi process → Pi checks nuggets memory for context → Pi responds → gateway delivers the reply.
Proactive flow: Heartbeat timer fires → Pi checks memory for anything worth following up on → if yes, sends you a message. If not, stays silent.
Memory promotion: After enough sessions, facts that keep getting recalled (3+ times) are promoted from holographic memory to MEMORY.md, where they become permanent context for every future session.
…| Command | What it does |
|---|---|
npm run setup |
Interactive setup wizard — creates .env |
npm run dev |
Start the gateway (Telegram + WhatsApp) |
npm test |
Run tests |
npm run migrate:memory |
Migrate legacy single-file memory to kind-based layout |
npm run typecheck |
Type-check without emitting |
npm run build |
Compile to dist/ |
npm testTests cover HRR math (bind/unbind accuracy, orthogonalization), nugget operations (remember/recall/forget lifecycle), and shelf management.
MIT
npm run migrate:memory| Migrate legacy single-file memory to kind-based layout | |npm run typecheck| Type-check without emitting | |npm run build| Compile todist/` |
npm testTests cover HRR math (bind/unbind accuracy, orthogonalization), nugget operations (remember/recall/forget lifecycle), and shelf management.
MIT
暂无开放 Issues,或尚未同步最近议题。