Timmy_Foundation/the-nexus
15
1
Fork 2
Code Issues 92 Pull Requests 34 Actions Packages Projects Releases Wiki Activity

[Mnemosyne] Foundation: holographic archive index and ingestion pipeline #1242

New Issue
Closed
opened 2026-04-12 00:13:53 +00:00 by Rockachopa · 2 comments
Rockachopa commented 2026-04-12 00:13:53 +00:00
Owner
Copy Link

Project Mnemosyne — The Living Holographic Archive

Goal

Bootstrap the Mnemosyne module: a sovereign, on-chain anchored memory system that ingests documents, conversations, and artifacts into a searchable holographic index.

Scope

  1. Archive Ingestion (mnemosyne/ingest.py) — Accept text/JSON/markdown inputs, chunk them with overlap, compute embeddings stub (pluggable backend), store in local SQLite + FTS5
  2. Holographic Index (mnemosyne/index.py) — Query interface: keyword search (FTS5) + semantic search (embedding similarity), merge results with reciprocal rank fusion
  3. CLI Entry Point (mnemosyne/cli.py) — mnemosyne ingest <path> and mnemosyne query <text> commands
  4. Tests — Basic round-trip test: ingest sample docs, query, verify recall

Design Principles

  • No network calls at ingest time (embeddings are optional, compute locally or skip)
  • SQLite + FTS5 only — no external vector DB dependency
  • Pluggable embedding backend (sentence-transformers, Ollama, or none)
  • Compact: the whole module < 500 lines of Python

Acceptance Criteria

  • mnemosyne/ingest.py chunks and stores documents in SQLite
  • mnemosyne/index.py returns ranked results for keyword queries
  • mnemosyne/cli.py exposes ingest/query subcommands
  • Tests pass: ingest sample → query → verify results
  • README with usage examples
## Project Mnemosyne — The Living Holographic Archive ### Goal Bootstrap the Mnemosyne module: a sovereign, on-chain anchored memory system that ingests documents, conversations, and artifacts into a searchable holographic index. ### Scope 1. **Archive Ingestion** (`mnemosyne/ingest.py`) — Accept text/JSON/markdown inputs, chunk them with overlap, compute embeddings stub (pluggable backend), store in local SQLite + FTS5 2. **Holographic Index** (`mnemosyne/index.py`) — Query interface: keyword search (FTS5) + semantic search (embedding similarity), merge results with reciprocal rank fusion 3. **CLI Entry Point** (`mnemosyne/cli.py`) — `mnemosyne ingest <path>` and `mnemosyne query <text>` commands 4. **Tests** — Basic round-trip test: ingest sample docs, query, verify recall ### Design Principles - No network calls at ingest time (embeddings are optional, compute locally or skip) - SQLite + FTS5 only — no external vector DB dependency - Pluggable embedding backend (sentence-transformers, Ollama, or none) - Compact: the whole module < 500 lines of Python ### Acceptance Criteria - [ ] `mnemosyne/ingest.py` chunks and stores documents in SQLite - [ ] `mnemosyne/index.py` returns ranked results for keyword queries - [ ] `mnemosyne/cli.py` exposes ingest/query subcommands - [ ] Tests pass: ingest sample → query → verify results - [ ] README with usage examples
Timmy was assigned by Rockachopa 2026-04-12 00:13:53 +00:00
Rockachopa commented 2026-04-12 00:14:04 +00:00
Author
Owner
Copy Link

Claiming this issue. Working on Mnemosyne foundation — ingestion, holographic index, and CLI.

Claiming this issue. Working on Mnemosyne foundation — ingestion, holographic index, and CLI.
perplexity commented 2026-04-12 04:02:24 +00:00
Member
Copy Link

Closing — the Mnemosyne foundation is fully shipped on main at nexus/mnemosyne/:

  • archive.py — MnemosyneArchive with CRUD, search, graph analysis
  • entry.py — ArchiveEntry dataclass
  • ingest.py — Document ingestion pipeline
  • linker.py — HolographicLinker (Jaccard similarity)
  • cli.py — Full CLI with 15+ commands
  • tests/ — test_archive.py, test_graph_clusters.py

Originally merged via #1217 (Phase 1), then expanded by #1225, #1220, #1234, #1238, #1241, #1246. PR #1243 (root-level duplicate path) was closed as stale. See RCA #1256.

Closing — the Mnemosyne foundation is fully shipped on main at `nexus/mnemosyne/`: - `archive.py` — MnemosyneArchive with CRUD, search, graph analysis - `entry.py` — ArchiveEntry dataclass - `ingest.py` — Document ingestion pipeline - `linker.py` — HolographicLinker (Jaccard similarity) - `cli.py` — Full CLI with 15+ commands - `tests/` — test_archive.py, test_graph_clusters.py Originally merged via #1217 (Phase 1), then expanded by #1225, #1220, #1234, #1238, #1241, #1246. PR #1243 (root-level duplicate path) was closed as stale. See RCA #1256.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
222-epic
3d-world
CI
Continuous integration, runners, workflow issues
 QA
Quality assurance, testing, and production audit
 actionable
agent-presence
aistudio-ready
assigned-aistudio
assigned-claude
assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-gemini
assigned-groq
assigned-kimi
assigned-kimi
Dispatched to Kimi via OpenClaw
 assigned-perplexity
assigned-sonnet
blocked
Blocked by external dependency or merge conflict
 claude-ready
claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 deprioritized
duplicate
epic
Epic / umbrella issue
 gemini-api
Gemini API integration
 gemini-review
google-ai-ultra
Google AI Ultra integration work
 groq-ready
harness
identity
Timmy identity and branding
 infrastructure
kimi-done
Kimi completed this task
 kimi-in-progress
Kimi is actively working on this
 kimi-ready
lazzyPit
Lazarus Pit — automated agent resurrection and health recovery
 media-gen
AI media generation (image/video/audio)
 mnemosyne
Project Mnemosyne — The Living Holographic Archive
 modularization
needs-design
nostr
p0-critical
p1-important
p2-backlog
performance
perplexity-ready
portal
research
Deep research and planning tasks
 security
Security hardening, vulnerability fixes, access control
 sonnet-ready
sovereignty
velocity-engine
Auto-generated by velocity engine
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
KimiClaw Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok hermes kimi manus perplexity sonnet
No Assignees Timmy
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/the-nexus#1242
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?