Installation

Requirements

PyPI wheel: Python 3.10 through 3.14. The wheel bundles the compiled binary; no Rust toolchain is needed.
crates.io / pre-built binaries: no runtime dependencies at all.

Install

Python via uv (recommended for a global CLI tool):

uv tool install zerv-version

Python via pip:

pip install zerv-version

Python as a project dependency:

uv add zerv-version

Rust via cargo:

cargo install zerv

Installation script (latest version):

curl -sSL https://raw.githubusercontent.com/wislertt/zerv/main/scripts/install.sh | bash

Installation script (specific version):

curl -sSL https://raw.githubusercontent.com/wislertt/zerv/main/scripts/install.sh | bash -s vX.X.X

Pre-built binaries are also available on the releases page.

Verify the install

zerv --version

Use from Python

The PyPI wheel also exposes a Python binding:

import zerv

# stdin carries a Zerv RON payload (same piping pattern as the CLI);
# in a git repo, plain zerv.version() reads the repository instead
zerv.version(source="stdin", stdin=ZERV_RON, output_format="semver")
# "1.2.3"

Every CLI option from zerv version maps to a keyword argument.

Uninstall

# Rust/cargo
cargo uninstall zerv

# Python (pip)
pip uninstall zerv-version

# Python (uv tool)
uv tool uninstall zerv-version

# Manual binary
rm ~/.local/bin/zerv

Welcome

Getting Started

Concepts

CI/CD

CLI Reference

Troubleshooting

Installation

Requirements

Install

Verify the install

Use from Python

Uninstall

​Requirements

​Install

​Verify the install

​Use from Python

​Uninstall

Requirements

Install

Verify the install

Use from Python

Uninstall