python-vibe-cleanup 1.0.0

CLI tool to refactor messy AI-generated Python scripts into production-ready code using Claude.

python-vibe-cleanup

A CLI tool that takes any messy, AI-generated Python script and rewrites it into clean, production-ready code — using Claude claude-sonnet-4-6 via the Anthropic API.

Install

pip install python-vibe-cleanup

Or from source:

git clone https://github.com/yourusername/python-vibe-cleanup
cd python-vibe-cleanup
pip install -e .

Setup

Create a .env file in your working directory (or export the key in your shell):

cp .env.example .env
# then edit .env and add your key
ANTHROPIC_API_KEY=sk-ant-...

Usage

# Overwrite the file with clean code
vibe-clean my_messy_script.py

# Preview the output without modifying the file
vibe-clean my_messy_script.py --dry-run

# Show version
vibe-clean --version

What it fixes

Issue	Fix applied
Unused / duplicate imports	Removed and reordered (PEP 8)
Missing type hints	Full annotations on every function
No docstrings	Google-style docstrings added
Redundant logic	Extracted into named helpers
Bare except:	Replaced with specific exception types
print() diagnostics	Replaced with logging calls
Magic strings/numbers	Lifted to UPPER_CASE constants
Logic in __main__ guard	Moved into a main() function
PEP 8 violations	Fixed (88-char line limit, Black style)

Publishing to PyPI

pip install build twine
python -m build
twine upload dist/*

License

MIT