guides

Debugging Compiled Code

Strategies for debugging when compilation fails or produces wrong results.

Published May 30, 2026

Compile-Time Debugging

Check Job Details

pyvorin job details JOB_ID

This shows compiler stderr, failure stage, and recommended next actions.

Run with Local Native Compiler

pyvorin run script.py --local-native

The local compiler often produces more detailed error messages than the remote API.

Dry-Run Bundle

pyvorin compile script.py --dry-run-bundle

Verify which files are included without sending a compile request.

Runtime Debugging

Force Fallback

PYVORIN_FORCE_FALLBACK=1 pyvorin run script.py

Compare CPython output vs native output to isolate correctness issues.

Inspect Execution Status

pyvorin report

Review fallback reasons, deoptimization counts, and correctness matches.

Report Failures

pyvorin report-failure failure_event.json