Install Labelme using Terminal

NOTE: We've updated our installation method using the terminal on 2025-08-30. If you prefer old version, please check Install Labelme using Terminal (old way).

If you are a Starter or Pro member, check the easier way: "Install Labelme as App"

Install uv and Python

To install Python, we recommend uv instead of the official Python installer. This is because Labelme software requires several scientific libraries (e.g. Numpy), which can be complex to install in some platforms.

Follow the installation steps: Install uv.

Once it's done, verify the installation:

Windows -> "Command Prompt or PowerShell"
macOS/Linux -> "Terminal"

uv --version    # should say uv xx.yy.zz
uv run python --version  # should say Python 3.yy.zz

Install Labelme using uv

After installing Python, you can install Labelme using uv.

Open the terminal and run the following command:

uv tool install --upgrade labelme

Once the installation is done, run uv tool run labelme (or uvx labelme for short), and you will see the GUI.

If you encounter any issues with Labelme, please follow Troubleshoot.