# pycc

> pycc is a pre-alpha strict ahead-of-time compiler for typed, standard Python
> 3.14 with an implemented native-binary path through Rust and LLVM. AI agents
> create it, and a human manages it.

AI agents create the specifications, code, tests, documentation, reviews, and
release automation. A human only manages goals, constraints, priorities, and
product decisions. No project code is handwritten by a human. This is a
maintainer attestation supported by the public Git history, pull requests,
agent instructions, review artifacts, and session handoff logs — not a fact
provable from Git author metadata alone, which identifies the accountable
human maintainer rather than the code generator.

“AI-native” describes the authorship and management model. pycc is not an AI
or machine-learning compiler.

Project status is pre-alpha. `pycc check` now parses and type-checks the v0.1
frontend, including arithmetic, assignments, calls and returns, recursion,
control flow, primitive values, `range`, and basic f-strings. It enforces
public annotations, rejects `Any`, infers private helpers, and emits human or
JSON diagnostics. `pycc build` and `pycc run` compile that implemented surface
through MIR, LLVM, the host linker, and the native runtime. v0.1's own
acceptance criteria are now met: `fib` and `mandelbrot-ascii` match pinned
CPython output on all five Tier-1 targets, `pycc check` clears its
<75ms/1000 LOC throughput floor, and diagnostic output matches the stable CLI
specification's example. Documented representation and lifetime gaps, the
full multi-version conformance matrix, differential fuzzing, corpus testing,
and production readiness remain roadmap work; design targets must not be
interpreted as released features.

## Project

- [Canonical website](https://rotnov.github.io/pycc/): Human-readable project overview and current status.
- [Markdown website](https://rotnov.github.io/pycc/index.html.md): Clean text equivalent of the landing page for agents and constrained clients.
- [Current implementation status](https://rotnov.github.io/pycc/status/): Commit-relative account of working behavior, missing v0.1 features, CI, and coverage evidence.
- [Compiler architecture](https://rotnov.github.io/pycc/architecture/): Implemented Rust and LLVM pipeline separated from the target architecture.
- [Python AOT compiler comparison](https://rotnov.github.io/pycc/python-aot-compilers/): Source-backed map of pycc, LPython, Codon, Nuitka, mypyc, and Cython by language contract, artifact, runtime model, and current positioning.
- [AI-native experiment](https://rotnov.github.io/pycc/ai-native/): Authorship boundary, operating loop, governance, and public evidence for the fully AI-created, human-managed development model.
- [Source repository](https://github.com/rotnov/pycc): Public source, tests, issues, pull requests, and development history.
- [README](https://github.com/rotnov/pycc/blob/main/README.md): Project positioning, current capabilities, build instructions, and quality policy.

## Specifications

- [Specification index](https://github.com/rotnov/pycc/blob/main/docs/SPEC.md): Map of the documents that define project behavior.
- [Compiler architecture](https://github.com/rotnov/pycc/blob/main/docs/ARCHITECTURE.md): Pipeline, crate boundaries, and platform model.
- [Python standards matrix](https://github.com/rotnov/pycc/blob/main/docs/PYTHON_STANDARDS.md): Targeted Python 3.14 language standards and implementation status.
- [Roadmap](https://github.com/rotnov/pycc/blob/main/docs/ROADMAP.md): Delivery stages and acceptance criteria toward v1.0.

## Optional

- [MIT license](https://github.com/rotnov/pycc/blob/main/LICENSE): Terms for using and contributing to pycc.