Metadata-Version: 2.5
Name: lazybrick
Version: 0.0.1
Summary: Compose, run, and benchmark reproducible model compression recipes.
Project-URL: Homepage, https://github.com/lazy-brick/lazybrick
Project-URL: Documentation, https://github.com/lazy-brick/lazybrick#readme
Project-URL: Issues, https://github.com/lazy-brick/lazybrick/issues
Project-URL: Source, https://github.com/lazy-brick/lazybrick
Author: LazyBrick contributors
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: ai,compression,inference,machine-learning,quantization
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: build>=1.2.2; extra == 'dev'
Requires-Dist: pytest>=8.3; extra == 'dev'
Requires-Dist: twine>=5.1; extra == 'dev'
Description-Content-Type: text/markdown

# LazyBrick

Compose, run, and benchmark reproducible model-compression recipes.

> **Pre-alpha:** `0.0.x` establishes the package, recipe envelope, and provenance
> primitives. It does not yet execute quantization algorithms or inference.

## Install

```bash
pip install lazybrick
```

## Validate a recipe

```bash
lazybrick validate examples/qwen3-awq.yaml
```

## Fingerprint a recipe

```bash
lazybrick fingerprint examples/qwen3-awq.yaml
```

```python
from lazybrick import load_recipe

recipe = load_recipe("examples/qwen3-awq.yaml")
print(recipe.fingerprint)
```

The fingerprint is calculated from canonical recipe content, so mapping-key order
does not change artifact identity.

## Direction

LazyBrick is intended to connect versioned model artifacts, external compression
plugins, runtimes, hardware targets, and evidence through a reproducible contract.
The design is deliberately narrow until the first complete compression workflow is
working.

See [IMPLEMENTATION_BLUEPRINT.md](IMPLEMENTATION_BLUEPRINT.md) for the proposed
architecture, milestones, open questions, and kill criteria.

## Development

```bash
python -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"
pytest
python -m build
python -m twine check dist/*
```

## License

Apache-2.0. Third-party models, datasets, runtimes, and plugin implementations keep
their own licenses.
