Enabling Auto‑Completion for Python and pip Commands with argcomplete

When using Python's command‑line tools, a common pain point is the lack of tab‑completion for commands such as python -m or pip , which forces users to look up package names manually.

The argcomplete library provides a simple way to add auto‑completion by pressing the Tab key, supporting Bash and Zsh out of the box and offering third‑party support for tcsh and fish.

Official support for Bash and Zsh shells (third‑party support for tcsh and fish).

Provides completion for python and pip commands.

Any third‑party tool that uses argparse can gain completion with just a few lines of code.

To enable completion for Python and pip, first install argcomplete:

pip install argcomplete

Then activate global completion:

activate-global-python-argcomplete

After restarting the shell, typing pip followed by Tab will list all available options.

For other third‑party CLI tools that already support argcomplete, activate them with:

eval "$(register-python-argcomplete <python-app-name>)"

For example, to enable completion for pipx :

eval "$(register-python-argcomplete pipx)"

To make your own Python package support auto‑completion, add the following lines before creating the ArgumentParser and before calling parse_args() :

# PYTHON_ARGCOMPLETE_OK import argcomplete, argparse parser = argparse.ArgumentParser() ... # existing parser setup argcomplete.autocomplete(parser) args = parser.parse_args() ...

After installing the package, run eval "$(register-python-argcomplete <your‑package>)" to enable completion.

⚠️ Note: The activation command only works for programs that already include argcomplete calls; also, placing time‑consuming imports after argcomplete.autocomplete() can avoid noticeable delays when users press Tab.

Reference: argcomplete GitHub repository