Installation
Edit this pageInstallation guide for PYRS on macOS and Linux.
Install PYRS with the path that matches your workflow. The default channel is nightly. Use
—stable when you want the latest published GitHub release.
Supported Native Targets
Recommended on macOS: Homebrew (--HEAD)
Install the tap’s nightly channel with Homebrew:
$ brew install --HEAD blueblazin/tap/pyrs $ pyrs --version Recommended on Linux (x86_64): GitHub Installer (nightly default)
Install from GitHub Releases (default channel is nightly):
$ curl -fsSL https://raw.githubusercontent.com/BlueBlazin/pyrs/master/scripts/install.sh | bash $ pyrs --version Optional: GitHub Installer (stable channel)
Use this when you want the latest published GitHub release instead of nightly:
$ curl -fsSL https://raw.githubusercontent.com/BlueBlazin/pyrs/master/scripts/install.sh | bash -s -- --stable $ pyrs --version Choose by Workflow
| Need | Best Install Path |
|---|---|
| Fast macOS setup | Use brew install —HEAD blueblazin/tap/pyrs. |
| Fast Linux setup | Use the GitHub installer on Linux x86_64 (curl … install.sh | bash). |
| Pinned stable channel | Run installer with —stable or pin with —tag vX.Y.Z. |
| Cargo-managed install | cargo install —locked —git … —bin pyrs (requires local CPython 3.14 stdlib). |
| Install from a cloned local repo | Install directly from checkout with cargo install —locked —path .. |
| Build directly from source without install | Build via cargo build —release, then run target/release/pyrs. |
| Containerized runs | Run image ghcr.io/blueblazin/pyrs:nightly via Docker. |
Alternative: Cargo Install from GitHub (Advanced)
This installs only the pyrs binary. You must provide a CPython 3.14 stdlib
(via PYRS_CPYTHON_LIB or a local CPython 3.14 install).
$ cargo install --locked --git https://github.com/BlueBlazin/pyrs --bin pyrs $ pyrs --version Alternative: Cargo Install from Local Repo Path
Use this when you already have a cloned repository and want an installed binary from that checkout:
$ git clone https://github.com/BlueBlazin/pyrs.git $ cd pyrs $ cargo install --locked --path . $ pyrs --version Alternative: Source Build (No Install)
Use this if you are actively working in the repository and want direct binary execution:
$ git clone https://github.com/BlueBlazin/pyrs.git $ cd pyrs $ cargo build --release $ target/release/pyrs --version Alternative: Docker Nightly Container
Use this for isolated execution without local Rust build dependencies:
$ docker pull ghcr.io/blueblazin/pyrs:nightly $ docker run --rm -it ghcr.io/blueblazin/pyrs:nightly Alternative: Direct Nightly Binary Archives (Advanced)
These archives are binary-only. Use them when CPython 3.14 is already on the machine or when you plan to place
the separate pyrs-stdlib-cpython-3.14.3.tar.gz bundle yourself. If you want stdlib placement handled
for you, use the GitHub installer or Homebrew instead.
macOS
$ ARCH="$(uname -m)" $ case "$ARCH" in $ arm64) PKG="pyrs-nightly-aarch64-apple-darwin.tar.gz" ;; $ *) PKG="pyrs-nightly-x86_64-apple-darwin.tar.gz" ;; $ esac $ curl -L "https://github.com/BlueBlazin/pyrs/releases/download/nightly/$PKG" -o "$PKG" $ tar -xzf "$PKG" $ ./pyrs --version Linux
$ PKG="pyrs-nightly-x86_64-unknown-linux-gnu.tar.gz" $ curl -L "https://github.com/BlueBlazin/pyrs/releases/download/nightly/$PKG" -o "$PKG" $ tar -xzf "$PKG" $ ./pyrs --version Post-Install Sanity Check
$ pyrs --version $ pyrs -c "import sys; print(sys.version)" Uninstall
Removal is path-specific:
GitHub installer
$ curl -fsSL https://raw.githubusercontent.com/BlueBlazin/pyrs/master/scripts/install.sh | bash -s -- --uninstall If you installed to custom locations, pass the same —bin-dir and —data-dir values to
the uninstall command.
Homebrew
$ brew uninstall pyrs The keg-local bundled stdlib is removed with the formula.
Cargo
$ cargo uninstall pyrs Docker
$ docker image rm ghcr.io/blueblazin/pyrs:nightly