auto-code-fixer 0.3.6

Automatically fix Python code using ChatGPT

Auto Code Fixer

Auto Code Fixer is a CLI tool that detects runtime failures and automatically fixes Python code using OpenAI.

It is designed for real projects where an entry script imports multiple local modules. The tool runs your code in an isolated sandbox + venv, installs missing external dependencies, and applies fixes only after the code executes successfully.

---

Installation

pip install auto-code-fixer

---

Quick start

auto-code-fixer path/to/main.py --project-root . --ask

If you want it to overwrite without asking:

auto-code-fixer path/to/main.py --project-root . --no-ask

---

What it fixes (core behavior)

✅ Local/internal imports are treated as project code

If your entry file imports something like:

from mylib import add

…and mylib.py exists inside the project, Auto Code Fixer will:

• copy main.py + mylib.py into a sandbox
• execute inside the sandbox
• if the traceback points to mylib.py, it will fix mylib.py
• then apply the fix back to your repo (with backups)

✅ External imports are auto-installed

If execution fails with:

ModuleNotFoundError: No module named 'requests'

…it will run:

pip install requests

…but only inside the sandbox venv (so your system env isn’t polluted).

---

Safety

Backups

Before overwriting any file, it creates a backup:

• file.py.bak (or .bak1, .bak2, ...)

Dry run

auto-code-fixer path/to/main.py --project-root . --dry-run

---

Advanced options

Run a custom command (pytest, etc.)

Instead of python main.py, run tests:

auto-code-fixer . --project-root . --run "pytest -q" --no-ask

Model selection

export AUTO_CODE_FIXER_MODEL=gpt-4.1-mini
# or
auto-code-fixer main.py --model gpt-4.1-mini

Max retries / timeout

auto-code-fixer main.py --max-retries 8 --timeout 30

Optional AI planning (which file to edit)

auto-code-fixer main.py --ai-plan

This enables a helper that can suggest which local file to edit. It is best-effort.

Optional structured patch protocol (JSON + sha256)

auto-code-fixer main.py --patch-protocol

When enabled, the model is asked to return strict JSON with {files:[{path,new_content,sha256}]}. The tool verifies the SHA-256 hash of new_content before applying edits, and falls back to the legacy full-text mode if parsing/validation fails.

Optional formatting / linting (best-effort)

auto-code-fixer main.py --format black
auto-code-fixer main.py --lint ruff --fix

These run inside the sandbox venv and are skipped if the tools are not installed.

---

Environment variables

• OPENAI_API_KEY (required unless you always pass --api-key)
• AUTO_CODE_FIXER_MODEL (default model)
• AUTO_CODE_FIXER_ASK=true|false
• AUTO_CODE_FIXER_VERBOSE=true|false

---

Notes

• This tool edits code. Use it on a git repo so you can review diffs.
• For maximum safety, run with --ask and/or --dry-run.