Platform Installation

The PyVax transpiler fundamentally operates using Python's native AST parser. It expects a modern Python environment (>= 3.9) to act as the primary CLI toolchain.

PyVax is distributed as a Python CLI tool. To avoid dependency conflicts and PEP 668 "Externally Managed Environment" errors, we strongly recommend installing it using pipx, which creates an isolated virtual environment automatically.

macOS/Linux (Recommended)

First, install pipx if you don't already have it, then install the PyVax CLI.

# 1. Install pipx
# On Ubuntu/Debian:
sudo apt update && sudo apt install pipx
pipx ensurepath

# On macOS (Homebrew):
brew install pipx
pipx ensurepath

# 2. Restart your terminal, then install PyVax
pipx install pyvax-cli

# 3. Run an environment diagnostic to confirm the CLI is registered
pyvax doctor

Windows Users

You can install PyVax smoothly on Windows using PowerShell or Command Prompt, or within WSL2.

# 1. Install pipx via standard pip
python -m pip install --user pipx
python -m pipx ensurepath

# 2. Restart your terminal, then install PyVax
pipx install pyvax-cli

Validate Configuration

Once your download has finished compiling local dependency graphs, you can ping your local machine to make sure it establishes connections against the default Avalanche routing endpoints:

pyvax --version
# v0.1.2

pyvax networks
# Fuji ✓ | C-Chain ✓