Getting Started

Getting started guide for PYRS runtime usage and first execution flow.

PYRS is a Python interpreter in Rust targeting CPython 3.14 compatibility. This page covers the fastest way to install, verify, and run code on supported native targets.

Prerequisites

macOS (x86_64 or aarch64) or Linux (x86_64)
curl and tar for the one-command installer
Homebrew (optional, macOS only) for brew install —HEAD …
Rust stable toolchain only for Cargo/source-build paths

Jump to Key Topics

Installation

Homebrew --HEAD, one-command installer, Cargo/source-build, and archive paths.

REPL and Execution

Interactive and non-interactive execution modes with command examples.

Diagnostics and Tracebacks

Error output shape, syntax diagnostics, and traceback expectations.

CLI and Environment

Invocation modes, supported flags, and runtime environment variables.

Browser Playground

Browser REPL usage, runtime status signals, and debug-route guidance.

Install and Verify

Install pyrs from GitHub and verify your binary is available. The default channel is nightly.

Shell

$ curl -fsSL https://raw.githubusercontent.com/BlueBlazin/pyrs/master/scripts/install.sh | bash $ pyrs --version

Run Python

Start with REPL, inline command mode, and source-file execution.

Shell

$ pyrs $ pyrs -c "import sys; print(sys.version)" $ pyrs path/to/script.py

Next Steps

Review CLI and Environment Reference.
Use Diagnostics and Tracebacks to understand error output shape.
Read Import and Stdlib Paths for import-root behavior and path troubleshooting.
Learn interactive workflow details on REPL and Execution.
Use /playground for the browser REPL and /debug only for deep runtime diagnostics.
Use pyrs --help to inspect runtime options directly from the binary.
Check Compatibility Targets for platform and semantic scope.