Metadata-Version: 2.4
Name: sharle
Version: 0.0.1
Summary: SHarLe (Spec-Harness-Learning): a framework for spec-driven harness-based learning with LLMs.
Project-URL: Homepage, https://github.com/MaximeRivest/sharle
Project-URL: Repository, https://github.com/MaximeRivest/sharle
Project-URL: Issues, https://github.com/MaximeRivest/sharle/issues
Author-email: Maxime Rivest <mrive052@gmail.com>
License: MIT
License-File: LICENSE
Keywords: agents,ai,evaluation,harness,learning,llm,spec
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Description-Content-Type: text/markdown

# SHarLe — Spec-Harness-Learning

[![PyPI version](https://img.shields.io/pypi/v/sharle.svg)](https://pypi.org/project/sharle/)
[![Python versions](https://img.shields.io/pypi/pyversions/sharle.svg)](https://pypi.org/project/sharle/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**SHarLe** (*Spec-Harness-Learning*) is a Python framework for spec-driven,
harness-based learning with large language models.

> 🚧 Early development — APIs are unstable.

## Install

```bash
pip install sharle
```

## Quickstart

```python
import sharle

print(sharle.__version__)
```

## Development

This project uses [`uv`](https://docs.astral.sh/uv/) for environment management.

```bash
# create env and install with dev extras
uv sync --extra dev

# run tests
uv run pytest

# lint & format
uv run ruff check .
uv run ruff format .

# type-check
uv run mypy
```

### Building & publishing

```bash
uv run python -m build
uv run twine check dist/*
uv run twine upload dist/*
```

## License

MIT © Maxime Rivest
