Skip to content

Installation

PinViz requires Python 3.12 or later.

Install as a standalone tool with global access to the CLI using uv:

uv tool install pinviz

After installation, pinviz will be available globally in your terminal.

Alternative: You can also use pipx for isolated CLI tool installations:

pipx install pinviz

As a Project Dependency

If you want to use PinViz as a library in your Python project:

# Using uv
uv add pinviz

# Using pip
pip install pinviz

Note

If you install with uv add, the CLI tool will only be available via uv run pinviz. For direct CLI access, use uv tool install instead.

Verify Installation

Check that PinViz is installed correctly:

pinviz --help

You should see the command-line help output.

Tip

If you installed with uv add, use uv run pinviz --help instead.

Development Installation

For contributing to PinViz, clone the repository and install in development mode:

# Clone repository
git clone https://github.com/nordstad/PinViz.git
cd PinViz

# Install dependencies
uv sync --dev

# Verify installation
uv run pinviz --help

Requirements

  • Python 3.12 or later
  • Dependencies:
    • svgwrite>=1.4.3 - SVG generation
    • pyyaml>=6.0.1 - YAML configuration parsing

All dependencies are installed automatically when you install PinViz.

Next Steps