pyra

pyra command [subcommand] [options] [args]

pyra is a modern Python package and project manager written in Rust. It unifies Python version management, project initialization, dependency resolution, environment synchronization, and script execution under a single deterministic pipeline.Projects declare intent in pyproject.toml and Pyra writes the fully-resolved state to pylock.toml. Running pyra sync then reconciles the local virtual environment exactly to the lockfile, so the same lockfile always yields the same environment across machines.Compared with traditional tools like pip and venv, Pyra replaces the chain of pyenv + virtualenv + pip + pip-tools with one binary that handles the full lifecycle — install, add, lock, sync, run — without network calls at run time beyond what is needed to fetch declared packages.

python install version

Install a specific Python interpreter version managed by Pyra.

Initialize a new project, generating pyproject.toml and pylock.toml.

Add one or more dependencies to pyproject.toml and update the lockfile.

Remove dependencies from pyproject.toml and update the lockfile.

Reconcile the local virtual environment with pylock.toml.

Resolve dependencies and write the precise state to pylock.toml.

Execute a script or command inside the synchronized environment.

Show the resolved dependency tree for the current project.

Show project metadata, Python version, and environment details.

Inspect or manage Pyra's on-disk cache.

Update Pyra itself to the latest version.

Project configuration lives in pyproject.toml (declared intent). The precise installed state is written to pylock.toml. Both files should be checked into version control.

Pyra is under active development; command names and flags may change before a stable release. Its lockfile format (pylock.toml) is Pyra-specific and not yet interchangeable with other Python tools.

pyra was created as a Rust-based alternative to the fragmented Python tooling landscape, taking design cues from tools like uv, poetry, and pdm while focusing on deterministic environment reproduction through a dedicated lockfile.

uv(1), pip(1), poetry(1), pdm(1), python(1)