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.