Install via Python

pipx (recommended)

pipx install vanya

The pipx tool installs Python CLI applications in isolated environments, avoiding conflicts with system packages.

Note

If pipx is not installed, install it first:

# Debian/Ubuntu
sudo apt install pipx && pipx ensurepath

# macOS
brew install pipx && pipx ensurepath

# Any platform with pip (in a venv or with --user)
python3 -m pip install --user pipx && python3 -m pipx ensurepath

Then restart your shell or run source ~/.bashrc (or ~/.zshrc).

Note

Both vanya and vanya-lang package names work — they’re the same package.

Note

The pip/pipx package is a lightweight wrapper that downloads the native binary on first run. This requires network access to releases.vanya-lang.org. If you’re in a restricted network environment, use npm instead — it bundles the binary directly.

pip (virtual environment)

# Create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install vanya
pip install vanya

Caution

On modern Linux (Python 3.11+), running pip install outside a virtual environment fails with “externally-managed-environment” due to PEP 668. Always use pipx or a virtual environment as shown above.

Note

Remember to activate the venv (source .venv/bin/activate) each time you open a new terminal to use vanya.

Verify

vanya --version

The current version is 0.3.4.

Next steps

Create your first test.