# pyscriptc

> Generated by docmd

Developer and agent documentation for pyscriptc: compile annotated Python to native binaries. Island is the floor and native is the ceiling.

## Documentation Files

- [Examples](https://pyscriptc.pages.dev/docs/examples/)
  Small programs that compile and run today.
- [Example programs](https://pyscriptc.pages.dev/docs/examples/programs/)
  Programs in the repository that compile today, with the value each one prints.
- [Getting started](https://pyscriptc.pages.dev/docs/getting-started/)
  Install pyscriptc, check the toolchain, and compile your first Python file to a native binary.
- [Comparison with other tools](https://pyscriptc.pages.dev/docs/guide/comparison/)
  How pyscriptc relates to Nuitka, Cython, mypyc, Codon, Numba and scriptc, by what each project's own documentation says.
- [Debugging and logs](https://pyscriptc.pages.dev/docs/guide/debugging/)
  Stage timings, refusal tables, IR dumps, and audit logs.
- [HTTP](https://pyscriptc.pages.dev/docs/guide/http/)
  The native urllib.request client, what it covers, and where it still differs from CPython.
- [Libraries and fallback mode](https://pyscriptc.pages.dev/docs/guide/libraries/)
  How to use third-party and unsupported modules: embed them with --fallback=cpython or call compiled code from Python via bindings.
- [Mobile apps](https://pyscriptc.pages.dev/docs/guide/mobile/)
  Compile Python into a static library and link it into an iOS or Android app.
- [The Python subset](https://pyscriptc.pages.dev/docs/guide/python-subset/)
  What pyscriptc compiles, how to write code inside the subset, and where to check the live support status.
- [pyscriptc](https://pyscriptc.pages.dev/docs/)
  Compile annotated Python to a native binary.
- [Contributing](https://pyscriptc.pages.dev/docs/project/contributing/)
  How to set up the repo and land a change.
- [Telemetry and privacy](https://pyscriptc.pages.dev/docs/project/telemetry/)
  What pyscriptc collects, and how to turn it off.
- [Supported CPython versions](https://pyscriptc.pages.dev/docs/project/versions/)
  Which Python versions pyscriptc supports and why.
- [CLI](https://pyscriptc.pages.dev/docs/reference/cli/)
  Every pyscriptc subcommand and flag.
- [Config](https://pyscriptc.pages.dev/docs/reference/config/)
  The pyscriptc config surface: pyscriptc.toml, pyproject.toml and PEP 723.
- [Diagnostics](https://pyscriptc.pages.dev/docs/reference/diagnostics/)
  Every PSxxxx diagnostic code, what it means, and how to change your code.
- [Divergences from CPython](https://pyscriptc.pages.dev/docs/reference/divergences/)
  The parity contract and every numbered difference from CPython 3.14.
- [Runtime pack and licenses](https://pyscriptc.pages.dev/docs/reference/runtime-pack/)
  The bundled CPython runtime pack for \`--embed-python=bundle\` compiles, its pinned versions, and the licenses that travel with it.
- [Stability and contracts](https://pyscriptc.pages.dev/docs/reference/stability/)
  Support tiers, stability guarantees, versioned axes, and internal compiler surfaces.

## Public Data Files

- [compat.json](https://pyscriptc.pages.dev/compat/data/compat.json)
  Live compatibility metrics across builtins, standard library, and PyPI top-100 packages (schema/format: compat_schema.py (version 1)).
- [ladder.json](https://pyscriptc.pages.dev/compat/data/ladder.json)
  Adoption ladder scores across R1 (single-file), R2 (multi-module), and R4 (dependency lanes) rungs (schema/format: ladder JSON (version 1)).
- [support.json](https://pyscriptc.pages.dev/compat/data/support.json)
  Evaluated support status for standard library and builtin functions from compile probes (schema/format: support JSON (version 1)).
- [what_will_fail.json](https://pyscriptc.pages.dev/compat/data/what_will_fail.json)
  Known compiler gaps and fences measured on the R0 corpus grouped by root cause (schema/format: what_will_fail JSON (version 1)).