Installation

Quick Install

Install Ranex from PyPI using pip:

pip install ranex

View the package on PyPI

Supported environments

• Python: Ranex is built and tested in CI with Python 3.12. Release artifacts may support additional Python versions depending on the published wheels.
• Platforms: Wheels are built for Linux, macOS, and Windows targets. If pip cannot find a compatible wheel for your environment, installation may fall back to a source build.

Install (recommended)

1. Create and activate a virtual environment.
2. Install Ranex.

Commands:

python -m venv .venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate     # Windows PowerShell

pip install --upgrade pip
pip install ranex

Verify

• CLI version: ranex version
• Python import (optional): python -c "import ranex; print(ranex.__version__)"

Upgrade

pip install --upgrade ranex

Uninstall

pip uninstall ranex

If installation fails

Common causes:

• No compatible wheel for your Python/OS
  • Upgrade pip.
  • Try a newer Python version.
• Building from source fails
  • A source build requires a Rust toolchain and Python development headers.
  • If you do not want to build from source, use an environment where a prebuilt wheel exists.