Migration Guide from CPython

May 30, 2026 | 5 min read

Phase 1: Assessment

  1. Run pyvorin scan on each module to identify unsupported patterns.
  2. Profile with cProfile to find the top 5 slowest functions.
  3. Document dependencies on generators, async/await, or dynamic eval.

Phase 2: Refactor

  1. Extract hot paths into pure functions with supported types.
  2. Replace generators with list comprehensions where possible.
  3. Add type hints to improve compilation quality.

Phase 3: Compile

  1. Run pyvorin proof on each refactored module.
  2. Verify correctness_match=True and acceptable speedup.
  3. Commit compiled artifacts to cache or container image.

Phase 4: Monitor

  1. Set up pyvorin benchmark in CI to detect regressions.
  2. Review usage reports weekly for fallback rates.
  3. Iterate on functions with low speedup or high fallback rates.