{"slug": "the-lesson-stated-plainly", "title": "The lesson, stated plainly", "summary": "A developer warns that persisting embeddings requires persisting the embedder, as a vector index is only meaningful with the exact model that produced it. The project NeonMem now stores the embedder inside a single cartridge file, ensuring consistency and adding a dimension guard that degrades to keyword search on mismatch. The tool is free for personal use, local and private.", "body_md": "If you persist embeddings, you must persist the embedder.A vector index is\n\nonly meaningful next to the exact model that produced it.\n\nIt's an easy mistake because everything *looks* fine — the vectors are right\n\nthere on disk, the search runs, no error is thrown. It's only wrong by a\n\ndimension you can't see.\n\nThe embedder now travels *inside* the single cartridge file — same one-file,\n\nbinary-only format, no sidecar. On load it's restored, and every read (and every\n\nnewly-learned fact) is embedded with the **same** model the stored vectors were\n\nbuilt with. We also added a dimension guard: if an old cartridge ever mismatches,\n\nrecall degrades to keyword search instead of returning garbage.\n\nResult: \"import any docs → your agent answers from them\" now survives close,\n\nreopen, and a week later.\n\nFree for personal use, local and private: [neonmem.com](https://neonmem.com)\n\n(Windows + Linux AppImage).", "url": "https://wpnews.pro/news/the-lesson-stated-plainly", "canonical_source": "https://dev.to/neonmem_dev/the-lesson-stated-plainly-50ae", "published_at": "2026-06-16 07:23:03+00:00", "updated_at": "2026-06-16 07:47:08.724753+00:00", "lang": "en", "topics": ["machine-learning", "developer-tools", "ai-infrastructure"], "entities": ["NeonMem"], "alternates": {"html": "https://wpnews.pro/news/the-lesson-stated-plainly", "markdown": "https://wpnews.pro/news/the-lesson-stated-plainly.md", "text": "https://wpnews.pro/news/the-lesson-stated-plainly.txt", "jsonld": "https://wpnews.pro/news/the-lesson-stated-plainly.jsonld"}}