Metadata-Version: 2.4
Name: governed-compression
Version: 0.1.0
Summary: Private research surface for governed compression experiments
License-Expression: Apache-2.0
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.26
Provides-Extra: test
Requires-Dist: pytest>=7; extra == "test"
Requires-Dist: ruff>=0.4; extra == "test"
Dynamic: license-file

# governed-compression

Private research implementation surface for governed vector and KV-cache compression.

## Purpose

This repo exists to provide a better implementation surface than the current fragmented TurboQuant-adjacent landscape.

Core goals:

- CPU reference implementation first
- reproducible benchmarks
- Windows via WSL2 first
- tuple-based experiment logging from day one
- method comparison across TurboQuant-style, QJL, and simple baselines

## Initial Scope

- vector encode / decode
- approximate dot product
- distortion metrics
- simple benchmark harness
- experiment logging

This repo is not yet a full inference-runtime integration project.

## Layout

```text
governed_compression/
  core/
  bench/
  logging/
tests/
examples/
docs/
```

## Quick Start

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
python -m governed_compression.cli
```

## Current Status

Stage 1 scaffold only.
