# PyMolt

> Open-source Python migration CLI. Funnel: scan → setup → assess → contract (runtime behavioral verification), plus behavior-grounded codemod recipes from the Axiom Graph service. Offline-first; every command takes --json; every fact carries provenance and a confidence level.

## Install
- One-liner: curl -fsSL https://pymolt.zeelex.me/install.sh | sh
- Or: uv tool install pymolt (also pipx/pip). Python 3.12+ CLI; the injected tracer itself is pure stdlib 3.6+.

## For agents — use these instead of manual exploration
- MCP server: install with `uv tool install 'pymolt[mcp]'`, then `claude mcp add pymolt -- pymolt mcp` (stdio; works in any MCP client). Tools mirror the CLI: scan, setup_options/setup_apply, assess, contract_map/capture/report, codemods_preview (dry-run, never spends).
- Repo facts (surfaces, Python-version divergence, dependency edges): `pymolt scan . --json`. Do not read Dockerfiles/lockfiles/tox configs by hand — scan returns them structured, with provenance, in ~2k tokens.
- Configure the migration non-interactively: `pymolt setup .` (flags for manifest/toolset/target Python).
- Feasibility + risk on a target Python: `pymolt assess . --target-python <X.Y> --risk --json` — lock-first version resolution and live CVE / wheel / abandonment data. Never guess package versions from memory.
- Behavioral ground truth across a dependency bump: `pymolt contract report . --json` — diffs the code↔dependency boundary at runtime (result_changed / raise_changed / BLIND zones). After editing code, re-capture with `pymolt contract capture --when post-migration --mode tests -- <test command>` and re-check the report.
- Codemod recipes (`pymolt codemods .`) COST MONEY: $5/$10/$25 per recipe by delivered weight, first recipe free per account. The quote is a hard cap. Always show the human the quote and get explicit approval before any slot is consumed.

## Docs
- README (full CLI reference): https://github.com/zeelex/pymolt#readme
- Site: https://pymolt.zeelex.me

## Pricing
- CLI: free, open source, forever.
- Codemod recipes: S $5 (≤5 wt) / M $10 (6–25 wt) / L $25 (>25 wt); weight = renames ×1, behavioral rewrites ×3, computed from what is actually delivered and locally verified. Empty bundles cost nothing. First recipe free — any class.