feat: add pypa/pipx

[itochan]

pipx is a tool that helps you install and run Python applications in isolated environments.

Windows is excluded from supported_envs because it requires an exe file to be generated, which is not included in the releases.

Check List

• Read CONTRIBUTING.md
  • Read OSS Contribution Guide
• All commits are signed
  • This repository enables Require signed commits, so all commits must be signed
• Avoid force push
• Install and execute the package and confirm if the package works well
• Execute cmdx s to scaffold code

[suzuki-shunsuke]

Thank you for your contribution!

[suzuki-shunsuke]

Test

$ pipx --version 
1.7.1

$ pipx install pycowsay
  installed package pycowsay 0.0.0.2, installed using Python 3.13.5
  These apps are now globally available
    - pycowsay
  These manual pages are now globally available
    - man6/pycowsay.6
done! ✨ 🌟 ✨

$ pipx list
venvs are in /Users/shunsukesuzuki/.local/pipx/venvs
apps are exposed on your $PATH at /Users/shunsukesuzuki/.local/bin
manual pages are exposed at /Users/shunsukesuzuki/.local/share/man
   package pycowsay 0.0.0.2, installed using Python 3.13.5
    - pycowsay
    - man6/pycowsay.6

$ ls ~/.local/pipx/venvs/pycowsay
bin  include  lib  pipx_metadata.json  pyvenv.cfg  share

$ pycowsay mooo                  

  ----
< mooo >
  ----
   \   ^__^
    \  (oo)\_______
       (__)\       )\/\
           ||----w |
           ||     ||

$ which pycowsay
/Users/shunsukesuzuki/.local/bin/pycowsay

https://pipx.pypa.io/stable/installation/#installation-options

The default binary location for pipx-installed apps is ~/.local/bin. This can be overridden with the environment variable PIPX_BIN_DIR.

pipx's default virtual environment location is typically ~/.local/share/pipx on Linux/Unix, ~/.local/pipx on MacOS and ~\pipx on Windows.

[suzuki-shunsuke]

Windows

Windows is excluded from supported_envs because it requires an exe file to be generated, which is not included in the releases.

I looked into this a bit.

I tried to install pipx on Windows using aqua, but it didn't work.

# yaml-language-server: $schema=https://raw.githubusercontent.com/aquaproj/aqua/main/json-schema/registry.json
packages:
  - type: github_release
    repo_owner: pypa
    repo_name: pipx
    description: Install and Run Python Applications in Isolated Environments
    version_constraint: "false"
    version_overrides:
      - version_constraint: semver("<= 1.1.0") or Version == "1.3.0"
        no_asset: true
      - version_constraint: "true"
        asset: pipx.pyz
        format: raw
        complete_windows_ext: false
        overrides:
          - goos: windows
            files:
              - name: pipx
                link: pipx.exe

$ pipx --version
time=2025-08-10T14:42:39Z level=fatal msg=aqua failed env=windows/amd64 error=it failed to start the process exe_name=pipx package_name=pypa/pipx package_version=1.7.1 program=aqua program_version=2.53.9

[suzuki-shunsuke]

🎉 https://github.com/aquaproj/aqua-registry/releases/tag/v4.400.0