piarun
piarun: the #StatefulCompute engine
piarun compiles a supported Rust subset into base64-encoded, certified PRN IR and can execute that IR with its native runtime. The piarun Python distribution contains one native C executable named piarun; Python is used for package installation, not command execution. No runtime package dependencies, compiler installation, credentials, or network access are required by the installed binary.
Install and run
After publication:
uvx piarun version
uvx piarun help
uvx piarun advertise
uvx piarun rs2ir --source 'fn main() { println!("hello"); }'
uvx piarun run --source 'fn main() { println!("hello"); }'
uvx --from piarun piarun rs2ir --input main.rs
uv tool install piarun
piarun version
Before publication, build and run the local wheel:
uv build
uvx --from ./dist/piarun-0.0.3-py3-none-macosx_11_0_arm64.whl piarun version
Use the wheel filename produced on your platform. uvx --from . piarun version also builds directly from the checkout. piarun is the package name and the only executable name.
For source edits without a version bump, use uvx --no-cache --from . piarun ... to bypass a previously cached tool environment.
Compiler contract
piarun rs2ir --input main.rs
printf 'fn main() { println!("hello"); }' | piarun rs2ir --input -
piarun rs2ir --source 'fn main() { println!("hello"); }' | base64 --decode
piarun run --source 'fn main() { println!("hello"); }'
Successful rs2ir output is always a single line of base64, whether displayed in a terminal, piped, captured, or invoked with --json. Pipe it directly into base64 --decode; no JSON envelope or field extraction is needed. Metadata commands and ordinary errors retain their structured JSON output when piped or passed --json.
Execute the first 20 primes directly from the wheel:
cat <<'EOF' | uvx --from . piarun run --input -
pub async fn main() {
let mut n = 2;
let mut found = 0;
while n < 100 {
let mut d = 2;
let mut prime = 1;
while d * d <= n {
if n % d == 0 {
prime = 0;
}
d = d + 1;
tokio::task::yield_now().await;
}
if prime == 1 {
if found < 20 {
println!("{}", n);
found = found + 1;
}
}
n = n + 1;
tokio::task::yield_now().await;
}
assert_eq!(found, 20);
}
EOF
The code is RFC 4648 standard padded base64 of compact UTF-8 Program JSON, including its PUOPS certificate. The decoded JSON has no insignificant whitespace and no terminal newline; string contents retain their whitespace. An unsupported construct or failed certification is an error, never an uncertified success. Rust input is bounded to 4 MiB and JSON to 32 MiB. See CLI-CONTRACT.md for fields and exit codes.
Build
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel 4
ctest --test-dir build --output-on-failure
./build/piarun version
uv build
The executable is C11 throughout, including the compiler submodule. CMake and declarative pyproject.toml metadata build platform wheels with scikit-build-core. Python files are verification and release tooling only; there are no Python modules, launchers, or Python shared-library dependencies in the wheel. Wheels use py3-none-PLATFORM tags and support installers using Python 3.9+. Source builds require Git, CMake 3.20+, and a C11 compiler; wheels do not.
Builds default to distribution: local. Release workflows set pypi; other distributors can set -DPRN_DISTRIBUTION=github or another label. version also includes the UTC build date, source revision, frontend revision, and platform. SOURCE_DATE_EPOCH controls reproducible build dates. Distribution describes artifact provenance, not the installer's download location: a release wheel copied from PyPI and installed locally remains the same artifact. Missing Git history is honestly reported as uncommitted; release jobs supply the exact commit explicitly.
Platforms and release
The wheel matrix targets macOS 11+ on Apple Silicon and Intel, Linux glibc 2.17+ and musl 1.2+ on x86-64/AArch64, and Windows 10 version 1903+ on AMD64 and Windows 11 on ARM64. RELEASE.md explains native build/test jobs, provenance, and trusted publishing. See VALIDATION.md for what has actually been run locally; a configured target is not evidence of a successful execution test.
Metadata
Release files for piarun 0.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| piarun-0.0.3.tar.gz | 139.7 kB | With provenance | Details for piarun-0.0.3.tar.gz |
Built distributions (wheels)
Total release size: 1.6 MB
Release files / piarun-0.0.3.tar.gz
| Download URL | piarun-0.0.3.tar.gz |
|---|---|
| Size | 139.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7d3a912816dff2f697902d6602d4b2f71d608cf5127a522fca5bb5edb9a773c9
|
|
BLAKE2b-256 checksum How to use checksums |
3d1ecc9d6ec45437663ffb493b284449fe1e7c965822710b8246b1190c2fbc6f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / piarun-0.0.3-py3-none-win_arm64.whl
| Download URL | piarun-0.0.3-py3-none-win_arm64.whl |
|---|---|
| Size | 191.4 kB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
bd8271d07d8cb4c9ee9571ec976a3baf7ee35657652e7883f0a464036702c50d
|
|
BLAKE2b-256 checksum How to use checksums |
357733c14358a0a9b7d6e02ceeb2a1fed078ad264389ce2bc3d9c55696a7c232
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / piarun-0.0.3-py3-none-win_amd64.whl
| Download URL | piarun-0.0.3-py3-none-win_amd64.whl |
|---|---|
| Size | 213.3 kB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
43e28b3762ea60c06002054c9a6cd4496b660d2b06bc0bbadb5720e3346d1205
|
|
BLAKE2b-256 checksum How to use checksums |
4a165f1540b89b00b2701c4bcdbbb0d162d9dffb9f0411dcac25a0b47cc78b21
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / piarun-0.0.3-py3-none-musllinux_1_2_x86_64.whl
| Download URL | piarun-0.0.3-py3-none-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 186.8 kB |
| Tags | Linux musl 1.2+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
960c014610d03fbe3c08b35a7f964730a06a35b3a50929baf16cf5519b3a07b1
|
|
BLAKE2b-256 checksum How to use checksums |
88698672ac73f72d9ae0ab9b15f374231e2c84de9342815588051907d7e331c9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / piarun-0.0.3-py3-none-musllinux_1_2_aarch64.whl
| Download URL | piarun-0.0.3-py3-none-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 191.6 kB |
| Tags | Linux musl 1.2+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
594d4e53ca9cfc1172b6faf1e27a8c24e0b803bd9ac14b8f13b4025cf4763c16
|
|
BLAKE2b-256 checksum How to use checksums |
d964c33ad109ef857279f452b7b3be2808733f0c3499012a66264538a42bd79d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / piarun-0.0.3-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | piarun-0.0.3-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 160.6 kB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
861b26c07a00a5fb7d561d54f59d0d9806d333e7fbbd2ec06cd64b2655724eac
|
|
BLAKE2b-256 checksum How to use checksums |
b10bb61d4975b14aad411ca0a2cfbf4ccbc218c7b38d988fbfa8ef492cd7f4bd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / piarun-0.0.3-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | piarun-0.0.3-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 174.2 kB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
c2adc41db76398133176d15d4a6aaf6ec67875aa27096c935f7141e55a9c9b28
|
|
BLAKE2b-256 checksum How to use checksums |
ab502fa4886f48fbe1bb4fad24f36844b469d6c01946d8d1e63452f2fbe494b6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / piarun-0.0.3-py3-none-macosx_11_0_x86_64.whl
| Download URL | piarun-0.0.3-py3-none-macosx_11_0_x86_64.whl |
|---|---|
| Size | 157.2 kB |
| Tags | Python 3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
c065367cd696c90d0af769689dad89700b1f82d5d1ec7fea56ee863d2fda6b85
|
|
BLAKE2b-256 checksum How to use checksums |
e06a84cb3a4d1d4eb3abfbd072d93088f5cf9486ae6d4f234b7960d8a80b4534
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / piarun-0.0.3-py3-none-macosx_11_0_arm64.whl
| Download URL | piarun-0.0.3-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 150.2 kB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c39f6196728c164aa5d66d24abb69ea0c71e6b024d7a2e54d272a00194429147
|
|
BLAKE2b-256 checksum How to use checksums |
f36fc13333a2348241b6558e07213160f5f9c33565b5857ababa31ee858bce25
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logSecurity for piarun 0.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 9 files in this release have been uploaded with provenance metadata.
Attestation for piarun-0.0.3.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.