llm-kosh 2.0.0__tar.gz

llm_kosh-2.0.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: llm-kosh
+Version: 2.0.0
+Summary: Local-first AI memory cartridge: persistent, cross-session memory for Claude and any LLM via MCP
+Author-email: Vaibhav Rastogi <rastogivaibhav@gmail.com>
+License: MIT
+Project-URL: Homepage, https://rastogivaibhav.github.io/llm-kosh
+Project-URL: Repository, https://github.com/rastogivaibhav/llm-kosh
+Project-URL: Bug Tracker, https://github.com/rastogivaibhav/llm-kosh/issues
+Keywords: mcp,llm,memory,claude,ai,context,cartridge,sqlite,fts5
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: watch
+Requires-Dist: watchdog>=3.0.0; extra == "watch"
+Provides-Extra: semantic
+Requires-Dist: sentence-transformers>=2.2.0; extra == "semantic"
+Provides-Extra: server
+Requires-Dist: fastapi>=0.100.0; extra == "server"
+Requires-Dist: uvicorn>=0.23.0; extra == "server"
+Requires-Dist: mcp>=1.0.0; extra == "server"
+Provides-Extra: all
+Requires-Dist: llm-kosh[semantic,server,watch]; extra == "all"
+
+# llm-kosh
+
+**Give your local LLMs a permanent, air-gapped memory cartridge.**
+
+`llm-kosh` is a lightning-fast, SQLite-backed memory system that gives AI assistants (like Claude and Cursor) permanent recall across sessions. Stop copy-pasting the same 15 architectural decisions and database schemas into every new chat. 
+
+By running completely locally, it guarantees zero cloud syncing, zero API costs, and absolute privacy for your proprietary codebase.
+
+## 🚀 The Killer Feature: Native MCP Server
+`llm-kosh` natively supports the **Model Context Protocol (MCP)**. This means tools like Claude Desktop and Cursor can automatically search and read your memory cartridge *without you doing anything*.
+
+### Claude Desktop Setup
+Simply add this to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "llm-kosh": {
+      "command": "uvx",
+      "args": ["llm-kosh", "mcp", "--root", "C:/path/to/your/cartridge", "--allow-write"]
+    }
+  }
+}
+```
+*Now, when you ask Claude "What database are we using for auth?", it automatically searches your `llm-kosh` cartridge and knows the answer.*
+
+## ✨ Features
+
+- 🧠 **Lightning Fast Local Memory:** Powered by an embedded SQLite FTS5 database. Sub-50ms search times across thousands of context files.
+- ⚡ **Global Quick Capture:** Press `Ctrl+Shift+Space` anywhere on your OS to instantly dump a thought, decision, or code snippet into your cartridge.
+- 🛡️ **Air-Gapped & Secure:** Built-in safety Airlock prevents destructive writes. No data ever leaves your machine unless you explicitly pack it.
+- 🖥️ **Beautiful Desktop UI:** Comes with a glassmorphism Electron/React desktop app to manage your memory, monitor the MCP daemon, and configure hotkeys.
+
+## 📦 Quickstart
+
+Get from zero to a running memory cartridge in under 2 minutes.
+
+**1. Install the core system**
+```bash
+pip install llm-kosh
+```
+
+**2. Initialize a new cartridge**
+```bash
+# Creates a new .llm-kosh root in your current directory
+llm-kosh init --owner "Your Name"
+```
+
+**3. Launch the Desktop App & Daemon**
+```bash
+# Starts the UI, the background watcher, and the MCP bridge
+llm-kosh desktop
+```
+
+---
+
+### 📚 Deep Dives:
+- [Architecture Overview](docs/ARCHITECTURE.md)
+- [MCP Integration Guide](docs/MCP_GUIDE.md)
+- [Comprehensive CLI Reference](docs/CLI_REFERENCE.md)

llm_kosh-2.0.0/README.md

@@ -0,0 +1,60 @@
+# llm-kosh
+
+**Give your local LLMs a permanent, air-gapped memory cartridge.**
+
+`llm-kosh` is a lightning-fast, SQLite-backed memory system that gives AI assistants (like Claude and Cursor) permanent recall across sessions. Stop copy-pasting the same 15 architectural decisions and database schemas into every new chat. 
+
+By running completely locally, it guarantees zero cloud syncing, zero API costs, and absolute privacy for your proprietary codebase.
+
+## 🚀 The Killer Feature: Native MCP Server
+`llm-kosh` natively supports the **Model Context Protocol (MCP)**. This means tools like Claude Desktop and Cursor can automatically search and read your memory cartridge *without you doing anything*.
+
+### Claude Desktop Setup
+Simply add this to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "llm-kosh": {
+      "command": "uvx",
+      "args": ["llm-kosh", "mcp", "--root", "C:/path/to/your/cartridge", "--allow-write"]
+    }
+  }
+}
+```
+*Now, when you ask Claude "What database are we using for auth?", it automatically searches your `llm-kosh` cartridge and knows the answer.*
+
+## ✨ Features
+
+- 🧠 **Lightning Fast Local Memory:** Powered by an embedded SQLite FTS5 database. Sub-50ms search times across thousands of context files.
+- ⚡ **Global Quick Capture:** Press `Ctrl+Shift+Space` anywhere on your OS to instantly dump a thought, decision, or code snippet into your cartridge.
+- 🛡️ **Air-Gapped & Secure:** Built-in safety Airlock prevents destructive writes. No data ever leaves your machine unless you explicitly pack it.
+- 🖥️ **Beautiful Desktop UI:** Comes with a glassmorphism Electron/React desktop app to manage your memory, monitor the MCP daemon, and configure hotkeys.
+
+## 📦 Quickstart
+
+Get from zero to a running memory cartridge in under 2 minutes.
+
+**1. Install the core system**
+```bash
+pip install llm-kosh
+```
+
+**2. Initialize a new cartridge**
+```bash
+# Creates a new .llm-kosh root in your current directory
+llm-kosh init --owner "Your Name"
+```
+
+**3. Launch the Desktop App & Daemon**
+```bash
+# Starts the UI, the background watcher, and the MCP bridge
+llm-kosh desktop
+```
+
+---
+
+### 📚 Deep Dives:
+- [Architecture Overview](docs/ARCHITECTURE.md)
+- [MCP Integration Guide](docs/MCP_GUIDE.md)
+- [Comprehensive CLI Reference](docs/CLI_REFERENCE.md)