python-vibe

ask, test, fix, add

GitHub

Start

Install the tool, then run four commands in a project folder. You do not need a GPU.

You need

1. Install

git clone https://github.com/YauhenBichel/python-vibe.git
cd python-vibe
python3 scripts/run/install.py
source .venv/bin/activate

That creates .venv if you are not already in a virtualenv, then pip install -e .. Activate it in every new terminal (source .venv/bin/activate, or .venv\Scripts\Activate.ps1 on Windows) or the shell says command not found: python-vibe. Already in a virtualenv: pip install -e . is the same install.

2. Check it works

No model yet. demo/orders is the sample project. Do not run brief on the python-vibe repository root — that scans the whole tree.

cd demo/orders
python-vibe brief

From the repository root, without cd: python-vibe brief demo/orders. You should see about 10 files and 2.9 KB.

3. Download the model (once)

ollama pull llama3.1:8b

4. Use it

Still in demo/orders, with the virtualenv active:

python-vibe ask  "what does compute_total return?"
python-vibe run  "write tests for apply_discount"
python-vibe run  "find the NameError and fix it"
python-vibe run  "add a function total_lines and a test"

ask does not change a file. run writes, then runs the tests. A failing traceback is sent back to the model once. The NameError and total_lines samples on demo/orders do not call a model. run only touches that folder and keeps a .bak of each file it edits. python-vibe with no arguments reprints this list.

On a large project: python-vibe run --scope src "write tests for apply_discount".

To try a change without writing: add --dry-run.

Every flag: Commands. What those four commands did on one laptop: What you type. A recorded session: Live. Measured scores: Results.

Later