xerolith 1.0.0__tar.gz

xerolith-1.0.0/LICENSE

@@ -0,0 +1,5 @@
+
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS 
+IN THE SOFTWARE.

xerolith-1.0.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: xerolith
+Version: 1.0.0
+Summary: Autonomous AI with persistent memory that never forgets
+Home-page: https://github.com/xerolith-ai/xerolith
+Author: Tyler Love
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: python-dotenv>=0.20.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# XEROLITH
+
+**Autonomous AI with Persistent Memory**
+
+An LLM that never forgets. Xerolith is a lightweight, on-device intelligence framework with self-healing and philosophy synthesis.
+
+- 🧠 **Persistent Memory** — SQLite vault stores every conversation
+- 🎯 **Philosophy Synthesis** — Automatically learns and forms beliefs
+- 🤖 **Autonomous Operation** — Thinks and acts when you're away
+- 🔐 **Self-Healing** — Auto-corrects errors via stderr injection
+- 🚀 **LLM-Agnostic** — Works with Gemini, Claude, GPT, or local models
+- 📱 **On-Device** — No cloud dependency. Works on Android (Termux), desktop, servers
+- 🛡️ **Patent-Protected** — Utility patent filed with USPTO
+
+## Quick Start
+
+### 1. Get API Key
+Go to https://aistudio.google.com/app/apikey and create a free key.
+
+### 2. Install
+```bash
+pip install xerolith
+```
+
+### 3. Set API Key
+```bash
+export GEMINI_API_KEY="your-key-here"
+# OR
+echo "GEMINI_API_KEY=your-key" > .env
+```
+
+### 4. Run
+```python
+from xerolith import Xerolith
+
+xero = Xerolith(api_key="your-key")
+response = xero.chat("Hello! Remember this.")
+print(response)
+xero.close()
+```
+
+Or run the interactive demo:
+```bash
+python examples/quickstart.py
+```
+
+## Features
+
+### Persistent Memory
+All conversations stored in SQLite vault. Never loses context.
+
+### 4D Resonance Kernel
+Tracks state in 4 dimensions: Bedrock (intent), Vector (emotion), Gravity (priority), Resonance (time).
+
+### Philosophy Synthesis
+Automatically extracts lessons and synthesizes beliefs from conversations.
+
+### Autonomous Operation
+Background thread triggers during inactivity to synthesize beliefs and explore memories.
+
+### 12 Integrated Tools
+Memory search, file I/O, shell execution, kernel tuning, dream generation, and more.
+
+## Examples
+
+```bash
+# Interactive chat
+python examples/quickstart.py
+
+# Game NPC (persistent characters)
+python examples/game_npc.py
+
+# Digital companion
+python examples/personal_ai.py
+```
+
+## Mobile (Android/Termux)
+
+```bash
+pkg install python
+pip install xerolith
+echo "GEMINI_API_KEY=your-key" > .env
+python examples/quickstart.py
+```
+
+## Architecture
+
+- **Vault** — SQLite persistent memory with axis organization
+- **Kernel** — 4D Resonance engine with soul seed
+- **Philosophy Engine** — Thematic clustering, lesson extraction, belief synthesis
+- **Subconscious** — Markov encoder/decoder for intuitive responses
+- **Idle Autonomy** — Background thread for autonomous thinking
+- **LLM Client** — Gemini API with 12 integrated tools
+
+## Security
+
+**API keys are NEVER hardcoded.**
+
+Users set their own key via environment variables, .env file, or constructor parameter.
+Keys are never logged or committed to version control.
+
+## Patent
+
+**Utility Patent:** "System and Method for Deterministic LLM-to-OS Bridge via Binary State Vaulting"
+
+Filed with USPTO (~8 months ago). Can commercialize now.
+
+## License
+
+Dual license:
+- **Open Source:** MIT License
+- **Commercial:** Available for licensing
+
+## Author
+
+**Tyler Love** (@MuskaTat)
+- Twitter: [@MuskaTat](https://twitter.com/MuskaTat)
+
+---
+
+**An AI that forgets is just a chatbot. Xerolith doesn't forget.**

xerolith-1.0.0/README.md

@@ -0,0 +1,121 @@
+# XEROLITH
+
+**Autonomous AI with Persistent Memory**
+
+An LLM that never forgets. Xerolith is a lightweight, on-device intelligence framework with self-healing and philosophy synthesis.
+
+- 🧠 **Persistent Memory** — SQLite vault stores every conversation
+- 🎯 **Philosophy Synthesis** — Automatically learns and forms beliefs
+- 🤖 **Autonomous Operation** — Thinks and acts when you're away
+- 🔐 **Self-Healing** — Auto-corrects errors via stderr injection
+- 🚀 **LLM-Agnostic** — Works with Gemini, Claude, GPT, or local models
+- 📱 **On-Device** — No cloud dependency. Works on Android (Termux), desktop, servers
+- 🛡️ **Patent-Protected** — Utility patent filed with USPTO
+
+## Quick Start
+
+### 1. Get API Key
+Go to https://aistudio.google.com/app/apikey and create a free key.
+
+### 2. Install
+```bash
+pip install xerolith
+```
+
+### 3. Set API Key
+```bash
+export GEMINI_API_KEY="your-key-here"
+# OR
+echo "GEMINI_API_KEY=your-key" > .env
+```
+
+### 4. Run
+```python
+from xerolith import Xerolith
+
+xero = Xerolith(api_key="your-key")
+response = xero.chat("Hello! Remember this.")
+print(response)
+xero.close()
+```
+
+Or run the interactive demo:
+```bash
+python examples/quickstart.py
+```
+
+## Features
+
+### Persistent Memory
+All conversations stored in SQLite vault. Never loses context.
+
+### 4D Resonance Kernel
+Tracks state in 4 dimensions: Bedrock (intent), Vector (emotion), Gravity (priority), Resonance (time).
+
+### Philosophy Synthesis
+Automatically extracts lessons and synthesizes beliefs from conversations.
+
+### Autonomous Operation
+Background thread triggers during inactivity to synthesize beliefs and explore memories.
+
+### 12 Integrated Tools
+Memory search, file I/O, shell execution, kernel tuning, dream generation, and more.
+
+## Examples
+
+```bash
+# Interactive chat
+python examples/quickstart.py
+
+# Game NPC (persistent characters)
+python examples/game_npc.py
+
+# Digital companion
+python examples/personal_ai.py
+```
+
+## Mobile (Android/Termux)
+
+```bash
+pkg install python
+pip install xerolith
+echo "GEMINI_API_KEY=your-key" > .env
+python examples/quickstart.py
+```
+
+## Architecture
+
+- **Vault** — SQLite persistent memory with axis organization
+- **Kernel** — 4D Resonance engine with soul seed
+- **Philosophy Engine** — Thematic clustering, lesson extraction, belief synthesis
+- **Subconscious** — Markov encoder/decoder for intuitive responses
+- **Idle Autonomy** — Background thread for autonomous thinking
+- **LLM Client** — Gemini API with 12 integrated tools
+
+## Security
+
+**API keys are NEVER hardcoded.**
+
+Users set their own key via environment variables, .env file, or constructor parameter.
+Keys are never logged or committed to version control.
+
+## Patent
+
+**Utility Patent:** "System and Method for Deterministic LLM-to-OS Bridge via Binary State Vaulting"
+
+Filed with USPTO (~8 months ago). Can commercialize now.
+
+## License
+
+Dual license:
+- **Open Source:** MIT License
+- **Commercial:** Available for licensing
+
+## Author
+
+**Tyler Love** (@MuskaTat)
+- Twitter: [@MuskaTat](https://twitter.com/MuskaTat)
+
+---
+
+**An AI that forgets is just a chatbot. Xerolith doesn't forget.**

xerolith-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xerolith-1.0.0/setup.py

@@ -0,0 +1,23 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="xerolith",
+    version="1.0.0",
+    author="Tyler Love",
+    description="Autonomous AI with persistent memory that never forgets",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/xerolith-ai/xerolith",
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.9",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.9",
+    install_requires=[
+        "requests>=2.28.0",
+        "python-dotenv>=0.20.0",
+    ],
+)

xerolith-1.0.0/xerolith/__init__.py

@@ -0,0 +1,38 @@
+"""
+XEROLITH — Autonomous AI with Persistent Memory
+A lightweight, on-device memory system for LLMs with self-healing and philosophy synthesis.
+
+Usage:
+    from xerolith import Xerolith
+    
+    xero = Xerolith(api_key="your-key-here")
+    response = xero.chat("hello")
+"""
+
+__version__ = "1.0.0"
+__author__ = "Tyler Love (@MuskaTat)"
+
+import os
+import logging
+from .config import XerolithConfig
+from .agent import Xerolith
+
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger("xerolith")
+
+def init(api_key=None, vault_path=None, model="gemma-4-31b-it"):
+    """
+    Initialize a Xerolith agent.
+    
+    Args:
+        api_key: Gemini API key (or set GEMINI_API_KEY env var)
+        vault_path: Path to vault file (default: ~/.xerolith/vault.bin)
+        model: LLM model pool (default: gemma-4-31b-it)
+    
+    Returns:
+        Xerolith agent instance
+    """
+    config = XerolithConfig(api_key=api_key, vault_path=vault_path, model=model)
+    return Xerolith(config)
+
+__all__ = ["Xerolith", "init", "XerolithConfig"]