qmk/qmk_firmware

[Bug] pip install don't work on Ubuntu due to pip settings

Open

#25726 opened on Oct 15, 2025

View on GitHub
 (3 comments) (0 reactions) (0 assignees)C (20,368 stars) (43,867 forks)batch import
bughelp wanted

Description

Describe the Bug

During execution qmk setup it's try to install to user some python packages via pip. But at least once that installing are ending with following error:

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
    
    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.
    Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
    sure you have python3-full installed.
    
    If you wish to install a non-Debian packaged Python application,
    it may be easiest to use pipx install xyz, which will manage a
    virtual environment for you. Make sure you have pipx installed.
    
    See /usr/share/doc/python3.12/README.venv for more information.

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.

... After that I get more error, but I don't know if these problems are related:

gcc  -O2 -Wall `libusb-config --cflags` -c main.c -o main.o
gcc  -O2 -Wall `libusb-config --cflags` -c usbcalls.c -o usbcalls.o
In file included from usbcalls.c:19:
usb-libusb.c: In function ‘usbGetReport’:
usb-libusb.c:196:9: warning: value computed is not used [-Wunused-value]
  196 |         *len++;
      |         ^~~~~~
gcc  -O2 -Wall `libusb-config --cflags` -o bootloadHID main.o usbcalls.o `libusb-config --libs`

...

Ψ QMK is ready to go, but minor problems were found

Contributor guide