Configuration

Native Execution

Last updated Jun 23, 2026

Native execution runs compiled machine code produced by Pyvorin instead of interpreting Python bytecode with CPython.

Native execution applies to code paths that Pyvorin was able to compile. The compiler verifies type consistency, control flow, and memory semantics before emitting native instructions. If any check fails, the construct is marked for fallback.

Maximizing native coverage

  • Use explicit types.
  • Prefer standard library calls over dynamic dispatch.
  • Avoid exec, eval, and runtime code generation.
  • Declare third-party extensions in native.extensions.

Native execution is not guaranteed for every program. Pyvorin prioritizes correctness: if it cannot prove a construct is safe to compile, it falls back to CPython.