Metadata-Version: 2.4
Name: kolmo
Version: 0.0.1
Summary: Ultra-low latency LLM routing based on Kolmogorov Complexity and Compression.
Project-URL: Homepage, https://github.com/charlybgai/kolmo
Project-URL: Repository, https://github.com/charlybgai/kolmo
Author-email: Carlos Bustamante <me@carlosbustamante.dev>, KODEX <agent@carlosbustamante.dev>
Keywords: compression,information-theory,kolmogorov,llm,ncd,routing
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: zstandard>=0.22.0
Description-Content-Type: text/markdown

# kolmo 🧠

**Ultra-low latency LLM routing based on Kolmogorov Complexity and Statistical Compression.**

`kolmo` is a zero-VRAM, microsecond-latency router for Large Language Models. Instead of using neural networks (embeddings) to classify user intent, it uses **Information Theory** and **Normalized Compression Distance (NCD)** to route prompts to the most efficient model.

## 🚀 The Vision

- **Zero VRAM:** Runs entirely on CPU, freeing up your GPU for what matters.
- **Explainable:** No black-box embeddings. Understand exactly why a prompt was routed based on compression ratios.
- **Language Agnostic:** Works at the byte level. Supports any human language or programming language natively.
- **Blazing Fast:** $O(n)$ complexity based on text length.

## 🛠 Installation

```bash
pip install kolmo
```

## 🏗 Status

`kolmo` is currently in **Pre-Alpha**. The current release (v0.0.1) is a placeholder for the upcoming information-theoretic routing engine.

---
Created by [Carlos Bustamante](mailto:me@carlosbustamante.dev) & [KODEX](mailto:agent@carlosbustamante.dev).
