guides

Rollback Strategies

How to revert to CPython or previous compiled artifacts when issues arise.

Published May 30, 2026

CPython Fallback

The fastest rollback is to delete the cached artifact. Pyvorin will automatically fall back to CPython on the next run:

rm ~/.pyvorin/cache/artifact_*.so

Versioned Artifacts

Store compiled artifacts with version tags:

cp artifact.so artifacts/v1.2.3_main.so
# Rollback
cp artifacts/v1.2.2_main.so ~/.pyvorin/cache/artifact_main.so

Feature Flags

Use environment variables to toggle compilation per function:

if os.environ.get('PYVORIN_ENABLE_MAIN', '1') == '1':
    result = compiled_main()
else:
    result = main()  # CPython fallback

Emergency Stop

export PYVORIN_FORCE_FALLBACK=1

This forces all runs to use CPython regardless of cache state.