thin-client

How Remote Compilation Works

The journey from Python source code to native machine code via the Pyvorin API.

Published May 30, 2026

Step 1: Source Hashing

The thin client computes a SHA-256 hash of your source code. If raw source upload is enabled, the full source is sent; otherwise only the hash is transmitted.

Step 2: License Validation

The API validates your license key (sent as a hash) and checks compile credit availability.

Step 3: AST Analysis

The server parses your code into an AST and checks for unsupported constructs.

Step 4: Type Inference

Pyvorin analyses variable types and code paths to generate optimised LLVM IR.

Step 5: LLVM Compilation

The LLVM IR is compiled to native machine code for the target platform.

Step 6: Artifact Packaging

The native binary is packaged with metadata and stored.

Step 7: Download and Cache

The thin client downloads the artifact and caches it locally for reuse.