Skip to Content
Get StartedInstallation

Installation

PIP$pip install usematchaUV$uv pip install usematchaVERIFY$matcha -​-versionmatcha 0.2.3

Install with pip:

pip install usematcha

Or with uv:

uv pip install usematcha

Verify the install:

$ matcha --version
matcha 0.2.3

Also confirm your GPU is visible:

MONITOR$matcha monitor -​-window 2
matcha monitor --window 2

This prints live power readings every 2 seconds. If it works, Matcha can see your GPU. Press Ctrl+C to stop.

Requirements

Matcha depends on nvidia-ml-py, the official NVIDIA Management Library bindings for Python. On most machines with PyTorch and CUDA installed, this is already present. If not, Matcha installs it automatically.

Matcha does not install or modify PyTorch, CUDA, or any training framework.

Troubleshooting

ImportError: pynvml is required

The nvidia-ml-py package is missing. Install it:

FIX$pip install nvidia-ml-py
pip install nvidia-ml-py

NVMLError: driver not loaded

NVIDIA drivers are not installed or the GPU is not accessible. Verify with:

VERIFY DRIVER$nvidia-smi
nvidia-smi

FutureWarning: The pynvml package is deprecated

This comes from PyTorch, not Matcha. It is harmless. You can suppress it with:

SUPPRESS WARNING$PYTHONWARNINGS=“ignore::FutureWarning” matcha run …
PYTHONWARNINGS="ignore::FutureWarning" matcha run ...