[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-11593":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":13,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":16,"rankGlobal":10,"rankLanguage":10,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":10,"pushedAt":10,"updatedAt":34,"readmeContent":35,"aiSummary":36,"trendingCount":15,"starSnapshotCount":15,"syncStatus":37,"lastSyncTime":38,"discoverSource":39},11593,"submarine","DenAB-NVS\u002Fsubmarine","DenAB-NVS","Sovereign, depth-adaptive AI memory. Open source. Local-first. Model-agnostic.","https:\u002F\u002Fcausalmemory.org",null,"JavaScript",67,13,25,0,44.74,"GNU Affero General Public License v3.0",false,"main",true,[22,23,24,25,26,27,28,29,30,31,32,33],"ai-depth-module","ai-memory","autonomous-ai-memory","competitive-adaptive-ai","deep-ai-memory","local-first","model-agnostic","native-memory","personalized-ai-layer","personalized-ai-memory","self-hosted","sovereign-memory","2026-06-12 04:00:55","# submarine\n\n> Sovereign, deeply-adaptive AI memory.\n> Open source. Local-first. Yours.\n\n---\n\n## Memory depth decides everything\n\nThe depth of an AI agent's memory decides everything.\n\n---\n\n## What submarine is\n\nsubmarine is a fully sovereign, open-source memory layer.\n\nYou control your data transparently, and you control its growth at the actual pace of competition.\n\nThose who move to this standard first turn their data into an asset.\n\nA personalized memory layer is not just the source of your effectiveness — it is what defines your position in the world today.\n\n---\n\n## The rules have changed\n\nThose who own information no longer rule the world. The world is ruled by those who own time.\n\nThat is why submarine does not merely store or consolidate data. It makes your data deeply adaptive to the most competitive tempo in existence.\n\nBut that is not all.\n\nThe modules that generate depth and dynamics today are already several orders ahead of every current assumption about \"how it should be\" — and orders ahead of future competitors who have not yet realized what the standard is.\n\n---\n\n## Models are the engine. submarine is the car.\n\nAny AI model receives only the context your architecture provides.\n\nModels are the engine. Engines come and go. Your deep, dynamic memory stays with you.\n\nLarge corporations are beginning to see the problem of native memory and the shift underway in the market — but only at the level of noticing it. Their answer, user retention through native memory inside their own AI model, amounts to telling you: *keep your car in our garage.*\n\nsubmarine absorbs that model with simple primitives — and only grows stronger in the process.\n\n---\n\n## Your life belongs to you\n\nYour life and your work belong to you — not to corporations.\n\nThat is what submarine says.\n\nAnd intellectual advantage is no longer on their side. They sell the engine. Whether they like it or not, the car is submarine. And the market is telling them the car will sit in your garage.\n\n---\n\n## The soil and the standard\n\nWe build unique modules of depth and adaptive dynamics for your memory. These solutions give you the exact advantage your competitor is looking for right now — or may have already found.\n\nOne way or another, the personalized memory layer is the new standard. The earlier you plant it, and the richer the soil, the more time ends up in your hands.\n\nsubmarine is not just the richest soil. It is a new standard that not everyone understands yet. And if you are reading this, your data is most likely worth being first — because this is no longer a conversation about competition. This is natural selection and evolution.\n\nIn the beginning was the word.\n\nAnd your data is worth being the beginning of something larger.\n\n---\n\n## What is actually inside\n\n| Principle | What it means |\n|---|---|\n| **Sovereignty** | Your data lives on your hardware. Not \"encrypted in our cloud.\" On your machine. |\n| **Model-agnostic** | Not a feature of a model. A layer above models. Switch labs tomorrow — context comes with you. |\n| **Zero marginal cost** | No LLM calls power the memory. Embeddings run locally. $0 per recall. |\n| **Depth over volume** | Not trying to store more. Trying to understand more deeply. |\n| **Embedded vector store** | LanceDB under the hood. Runs anywhere your code runs. No external service required. |\n\n### Architecture at a glance\n\nsubmarine organizes memory into three layers:\n\n- **Soul** — Persistent context. Identity, principles, project constants. Does not decay.\n- **Core** — How you work. Active decisions, open projects, evolving strategies.\n- **Cortex** — What is happening. Operational facts of this week, this hour. Fades naturally.\n\nThe system generates a single document — the **Crystal** — that carries distilled context to any model. One file. Any model. Full depth.\n\n### What makes it different\n\n- **Causal ranking** — every decision is linked to where it came from\n- **Contradiction detection** — notices when you change your mind, treats it as signal\n- **Immune system** — protects load-bearing truths from careless overwrites\n- **Purposeful forgetting** — the irrelevant fades, the important consolidates\n- **Event-driven updates** — context refreshes on events, not schedules\n\n### What this isn't\n\nsubmarine is not a chat memory plugin, not a thread summariser, not a vector database wrapper. It is a layered cognitive substrate with immune gates, causal structure, and purposeful forgetting. The difference shows up over months of use, not in a single demo.\n\n---\n\n## Configuration\n\nsubmarine organizes memory into layers. The top layer — Soul — holds persistent context that does not decay.\n\nYou define it in `SOUL.md`. This can be anything: your role, project context, team conventions, product principles — whatever should persist across every session.\n\nA minimal example:\n\n```md\n# SOUL.md\n\nRole: {your role or project context}\n\n## Persistent context\n- {fact or principle 1}\n- {fact or principle 2}\n\n## Preferences\n{communication style, output format, constraints}\n```\n\nSee `templates\u002FSOUL-TEMPLATE.md` for a full structure, or design your own. The format is open.\n\n---\n\n## Quick start\n\n### Requirements\n\n- Node.js 22+\n- [Ollama](https:\u002F\u002Follama.com\u002F) with the **bge-m3** embedding model (`ollama pull bge-m3`)\n- ~200 MB disk space\n- Any machine you own\n\n### Install\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FDenAB-NVS\u002Fsubmarine.git\ncd submarine\nnpm install\n```\n\n### Configure\n\n```bash\ncp submarine.config.example.json submarine.config.json\n# Edit config: set your embedding model, layer weights, server port\n```\n\nAuthentication is **off by default**. If you want to require an API key, copy `.env.example` to `.env`, uncomment `SUBMARINE_API_KEY`, set a strong value, and include `-H \"X-API-Key: \u003Cyour-key>\"` on every request below.\n\n### Run\n\n```bash\nnode index.mjs\n```\n\nsubmarine starts on port 3100 by default. Health check:\n\n```bash\ncurl http:\u002F\u002Flocalhost:3100\u002Fapi\u002Fv1\u002Fhealth\n```\n\n### First Crystal\n\n```bash\ncurl http:\u002F\u002Flocalhost:3100\u002Fapi\u002Fv1\u002Fcrystal\n```\n\nPaste the Crystal into any model's system prompt or context window. The Crystal carries your full context to any model in a single document.\n\nFor detailed setup including prerequisites, API reference, and integration examples, see [docs\u002FQUICKSTART.md](docs\u002FQUICKSTART.md).\n\n\n## Current state\n\n| Metric | Value |\n|---|---|\n| Version | 1.0.5 |\n| Tests | 46\u002F46 structural passing (4 runtime tests require live data) |\n| Memory layers | 3 active (Soul, Core, Cortex) |\n| Embeddings | BGE-M3, local, 1024-dim |\n| Efficiency gains | 21–37x on measured tasks (internal dynamic architecture — available to strategic partners under direct demonstration) |\n| License | AGPL-3.0 |\n| Cloud dependency | None |\n| Cost per recall | $0 |\n\n---\n\n## Who is this for\n\n- **Knowledge workers** tired of re-explaining themselves to every new AI session\n- **Developers** who want a sovereign memory layer they control end-to-end\n- **Teams** where accumulated context is a competitive advantage\n- **Anyone** who believes the most personal dataset of their life should not be a guest in another company's house\n\n---\n\n## What we share — and what we keep\n\nsubmarine is a complete, working foundation. Everything in this repository is production-ready, free, and yours to run. It is not a demo or a reduced version — it is a full system with its own integrity.\n\nWhat you see here is not everything we have built.\n\nBeyond this public foundation, we operate a deeper system — several orders of magnitude more capable along the dimensions that matter most: depth of memory, precision of recall, behavioral coherence across time. That system is not for public release. It is not for sale as a product.\n\nWe are direct about this because clarity matters more than marketing.\n\nIf you are building something where accumulated memory is the advantage, and the public foundation is not enough for what you are solving — we are open to strategic partnerships. Access to the deeper system comes through alignment, not through a checkout page.\n\nNot clients. Not users. **Partners** — aligned with the direction this project is taking.\n\n---\n\n## License\n\nsubmarine core is AGPL-3.0 — free, copyleft. Your modifications stay open. Your data stays yours.\n\nCommercial extensions for proprietary integrations, closed-source forks, or enterprise SLAs are available under a separate licence. Contact via the email below.\n\n---\n\n## Contact\n\n**D. Ashford** — Author of submarine\n- Email: [ashford.dev@proton.me](mailto:ashford.dev@proton.me)\n- Project: [causalmemory.org](https:\u002F\u002Fcausalmemory.org)\n\nStrategic partnerships that align with the project's direction — the conversation starts here.\n\n---\n\n*submarine — sovereign AI memory. Open source. Local-first. Yours.*\n","submarine 是一个开源的、本地优先的AI记忆层，旨在提供主权且深度自适应的人工智能记忆。其核心功能包括数据主权控制、模型无关性以及高度个性化的动态记忆生成。通过submarine，用户可以确保自己的数据存储在本地设备上，并能够根据实际竞争节奏调整数据增长，使数据成为有价值的资产。此外，它还支持任何AI模型作为引擎接入，而submarine本身则作为承载这些模型的“汽车”，提供了强大的自适应能力和持续的竞争优势。适用于需要保护数据隐私同时又希望利用AI技术提升效率和竞争力的个人或企业场景。",2,"2026-06-11 03:32:08","CREATED_QUERY"]