py-harness
Four jobs on your laptop: ask, write a test, fix a bug, add
one small function. Only touches the folder you point at. Daily work
is py-harness plus Ollama llama3.1:8b. Not everyday-ready.
Site: yauhenbichel.github.io/py-harness.
Run it
git clone https://github.com/YauhenBichel/py-harness.git
cd py-harness
python3 scripts/run/install.py
source .venv/bin/activate
ollama pull llama3.1:8b
cd demo/orders
py-harness brief
py-harness ask "what does compute_total return?"
py-harness run "find the NameError and fix it"
Activate .venv in every new terminal. If the shell says
command not found: py-harness, it is not active. The sample project
is demo/orders — do not run brief on this repository.
ask never writes. run writes, then runs the tests. The NameError
sample is built into the tool (no model). Another folder:
py-harness ask ~/app "what does add return?".
Start · Commands · Contributing · Security
What it looks like
Replay: asciinema play docs/media/live-demo.cast.
Full log: Live demo.
VS Code — py-harness editors vscode, then Tasks: Run Task.
Replay: asciinema play docs/media/vscode-demo.cast.
VS Code.
Cursor — py-harness editors cursor --allow-writes, then chat or Tasks.
Replay: asciinema play docs/media/cursor-demo.cast.
Cursor.
Scores
One laptop. 29 Aug–5 Sep 2026. Not everyday-ready.
| What I tried | Result |
|---|---|
| 0.5B as daily work | 0 / 4 vibe, 0 / 2 parse |
Four Start commands on demo/orders |
0 / 4, then 4 / 4 after the harness |
| Same bench, code must run | 8B 6–9 / 9; 7B coder 7 / 9; 30B timeout |
| Same-night daily (write tests, clamp, sum × 3) | 8B 9 / 9, 7B coder 7 / 9. Keep the 8B |
| Extra 7B–8B on disk | Warm SWE helper 75s. A second 8B client still held /api/chat. Empty helper not remasured. |
| A real repository (4,580 files) | reading works; writing 1 / 12 |
The long table: Experiments. Every score: Results. Which tags timed out: Hub models.
More
| If you want | Go here |
|---|---|
| What each folder is | Folders |
| Tests | PYTHONPATH=src python -m unittest discover -s tests -q |
| 0.5B style prior | YauhenBichel/python-vibe-0.5b |
| Train / serve / API | Commands |
| A first issue | good first issue |
Vulnerabilities: a public GitHub issue. Do not paste live keys.
Contributors
Thank you to everyone who has helped py-harness.
Yauhen Bichel |
Mark Xian |
Itzsaurav |
svkzn |
Aditya |
Huangshuo Kuang |
The list is filled by Contributors from GitHub commits (bots omitted). Contributor graph · good first issue
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file py_harness_cli-0.3.0.tar.gz.
File metadata
- Download URL: py_harness_cli-0.3.0.tar.gz
- Upload date:
- Size: 162.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
86b8aee9d0e6bf2b34330272f93e625181379fa4ebc099dcbc29fcdbcb831f63
|
|
| MD5 |
cf145a582a5652ea0bc5b33307e78a20
|
|
| BLAKE2b-256 |
bf61dad37a77efd28050f54d6c4a3da3e72e478b75b28344e99b47be801cb968
|
File details
Details for the file py_harness_cli-0.3.0-py3-none-any.whl.
File metadata
- Download URL: py_harness_cli-0.3.0-py3-none-any.whl
- Upload date:
- Size: 195.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
280b3dd969d201dd3dc87d627f3138b8eb396c78824b1d66672497940f663a47
|
|
| MD5 |
bef5dfa1d688f88077e13e3dc0a60290
|
|
| BLAKE2b-256 |
6b6b40a77e8a115b487beb71a84d9133d109c2e4f27cc68e68bdba46de43e607
|
