Metadata-Version: 2.4
Name: furb
Version: 0.1.0
Summary: The core of an AI harness, in one python file.
Author: Abel Lucas
Author-email: Abel Lucas <uaelucas@gmail.com>
License-Expression: AGPL-3.0-only
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Dist: pydantic>=2.13.5
Requires-Dist: pydantic-ai-slim>=2.27.1
Requires-Dist: python-minifier>=3.3.0
Requires-Python: >=3.14
Project-URL: Source, https://github.com/uael/furb
Project-URL: Issues, https://github.com/uael/furb/issues
Description-Content-Type: text/markdown

# furb

The core of an AI harness, in one python file, `src/furb/engine.py`. A model does everything with python that it
writes: the engine, minified, is its whole system prompt, and each word it answers with runs on a chain of the
engine. The contract is `src/furb/engine.pyi`, whose docstrings hold every law, one sentence per line, and the suite
in `test/` holds one test per sentence.

`pip install furb` installs the engine and the `furb` command. It needs python 3.14.

From a clone of this repository:

- `uv sync` installs the environment, and `uv run pytest -q` runs the suite.
- `uv run python script/smoke.py` runs one real life on opus/low through the claude command line.
- `uv run python script/deepswe.py run <task>` runs one DeepSWE task and grades it.

Copyright (C) 2026 Abel Lucas. furb is free software under the GNU Affero General Public License, version 3, which
`LICENSE` holds: you may use, study, change and share it, and anyone who ships it or runs a changed furb as a
service must offer the source under the same terms. The engine carries no notice of its own, since its text is the
system prompt of a model and every word of it counts.
