Getting Started

First Compile

Last updated Jun 23, 2026

After installing Pyvorin and activating your licence, you can compile a Python file.

Basic compile

pyvorin compile app.py

Pyvorin analyses app.py, attempts native compilation, and writes output to the build directory configured in pyvorin.toml (default ./build).

What happens during compilation

  1. The CLI validates your licence and device token.
  2. Pyvorin parses and type-infers your code.
  3. Supported modules are compiled to native code.
  4. Unsupported constructs are marked for fallback and executed by CPython at runtime.
  5. Compile metrics are sent to the Portal.

Viewing results

pyvorin compile app.py --report

The report shows native coverage percentage, fallback reasons, compile duration, and credits used. Successful compiles deduct 1 credit; error compiles do not.

Run the output

./build/app

If the build fell back entirely to CPython, the output script runs as normal Python.