On 14/07/2026 01:32, David Niklas wrote:
(Sorry for not replying to everyone sooner, I seem to have been
unsubscribed from the list -- or maybe the digests are taking >3 days to
arrive.)

On Mon, 13 Jul 2026 22:45:33 +0200
Jan Claeys <[email protected]> wrote:
On Fri, 2026-07-10 at 13:48 -0400, David Niklas wrote:
I wanted to install a python pip wheel file globally without breaking
my system packages. I tried searching online, but I cannot figure out
how to do that.

How do you install a .whl file globally in debian without breaking
system packages?
Is it something that is also packaged in Debian?
It's the VapourSynth package. And it's not in Debian -- though I could
get it through the multimedia repo.


If it helps:

❯ uvx vapoursynth
Installed 1 package in 62ms
usage: vapoursynth [-h] COMMAND ...

VapourSynth command line utility.

options:
  -h, --help           show this help message and exit

commands:
  COMMAND
    config             Write or update the VapourSynth runtime configuration
    check-env          Show the current VapourSynth environment status
    get-vsscript       Print the bundled VSScript library path
    get-include        Print the bundled include directory
    get-pkgconfig-dir  Print the bundled pkgconfig directory
    get-plugin-dir     Print the bundled plugin directory
    register-install   Register the current installation in the user environment

Examples:
  vapoursynth config
  vapoursynth check-env
  vapoursynth get-plugin-dir


The same works if I run `pipx run vapoursynth`. PIPX (native python, slightly older) and UVX (rust, and a bit newer) both run applications directly from PyPI without installation (strictly, they install into a temporary virtual environment). If you find you use vapoursynth regularly, you can run either "pipx install vapoursynth" or "uv tool install vapoursynth" to get the tool added to your path.

How much easier this query has become now you've told us which wheel you're trying to install. :)




Why do you think it will break system packages?
Because I get this big wall of scary text saying so...

########################################
# pip install ./dist/vapoursynth-77-cp313-abi3-linux_x86_64.whl
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.13/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. hint: See PEP 668 for the detailed specification.
########################################

Thanks

Reply via email to