Skip to main content

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)

Source distribution for piarun 0.0.3
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)

Table of built distributions (wheels) for piarun 0.0.3
File Actions
piarun-0.0.3-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for piarun-0.0.3-py3-none-win_arm64.whl
piarun-0.0.3-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for piarun-0.0.3-py3-none-win_amd64.whl
piarun-0.0.3-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for piarun-0.0.3-py3-none-musllinux_1_2_x86_64.whl
piarun-0.0.3-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for piarun-0.0.3-py3-none-musllinux_1_2_aarch64.whl
piarun-0.0.3-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for piarun-0.0.3-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
piarun-0.0.3-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for piarun-0.0.3-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
piarun-0.0.3-py3-none-macosx_11_0_x86_64.whl Python 3 none macOS 11.0+ x86-64 Details for piarun-0.0.3-py3-none-macosx_11_0_x86_64.whl
piarun-0.0.3-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for piarun-0.0.3-py3-none-macosx_11_0_arm64.whl

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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Security 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.

Select from 9 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.0.3 This release

9 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page