Installation

Answer the questions below and we'll show you the exact commands for your setup.

Your commands

# Answer the questions below to build your install commands

What operating system are you on?

macOS or Linux

Windows

Do you have uv installed?

uv is a fast Python package manager - we recommend it, but pip works too. Not sure? Run uv --version in your terminal.

Yes, I have uv

No, install it for me

I'd rather use pip

⚠️ Installing without a virtual environment can conflict with other packages in your Python installation. We recommend using uv instead.

✓ Your install commands are ready above. Copy and run them in your terminal.

Already installed?

Run pixel-patrol --version to confirm. Then head to the Processing tutorial to build your first command.

Prefer a one-click app?

If you'd rather skip the command line entirely, download the Pixel Patrol Launcher - a single clickable file for Windows, macOS, or Linux. On first run it sets up a managed Python environment at ~/.pixel-patrol/, installs Pixel Patrol, and opens the app in your browser. No Python required.

🪟 Windows 🍎 macOS 🐧 Linux

First time running it?

Windows: if SmartScreen shows a warning, click More info → Run anyway.
macOS: right-click the file → Open → confirm Open when macOS warns about an unidentified developer.
Linux: make it executable first - chmod +x pixel-patrol-launcher-linux, then double-click it (or run it from a terminal).