pyscriptc

Compile annotated Python to a native binary. No CPython at runtime.

pyscriptc compiles typed Python to native executables. It uses Python's inferred types and type hints to generate machine code from supported code. Static output runs without a Python runtime.

pyscriptc is experimental, aims for CPython compatibility, and supports a subset of Python, its builtins and standard library, and selected PyPI packages. For any code that's not supported, it can run it in CPython runtime. The CPython runtime is not bundled and is expected to be available at the host.

Installation

uv tool install pyscriptc

Building a binary needs a clang (or zig) on your PATH; pyscriptc doctor checks. See getting started for other install methods and toolchain setup.

Windows: the pyscriptc binary runs there (experimental) and coverage works. Emitted programs are experimental cross-compilation only: pyscriptc compile FILE --target x86_64-windows-gnu --driver zig builds a Windows binary from Linux or macOS, but no CI job runs the output and Windows semantics are unverified. Native Windows compiles are not supported yet.

Documentation

Documentation site, including the CLI reference and the Python subset.

Hello world

Create hello.py:

def main() -> None:
    print("hello from a native binary")


if __name__ == "__main__":
    main()

pyscriptc run hello.py
pyscriptc compile hello.py --emit bin -o hello && ./hello

Benchmarks

Compiled binary versus the same call under CPython 3.15.0, geometric mean per workload group, higher is better. Reference recorded 2026-10-15 on one Linux x86_64 host (8 CPUs, 5 runs per sample).

Source: benchmarks/baseline/reference.json. Fresh numbers are in the job summary of the latest nightly run. Reproduce with uv run python -m benchmarks.baseline.run --check.

Using the stdlib

The practical summary and the fenced constructs: The Python subset.

Using PyPI packages

We keep track of the share of the top 100 PyPI libraries that compiles. Mind that the compiler requires typed code. The per-library status lives in the generated .agents/docs/support/compat-top100.md (moving to the compat site, see The Python subset).

Contributing

See Contributing for setup and conventions.

License

Apache License 2.0. See LICENSE.