Skip to content

Installation

Requirements

Before installing httptap, ensure you have:

  • Python 3.10 or higher (CPython recommended)
  • pip or uv package manager
  • macOS, Linux, or Windows operating system

No system dependencies beyond standard networking are required.

Installing via Homebrew

brew install httptap

brew install httptap

Recommended for macOS/Linux users

Homebrew installation is the simplest method and includes automatic shell completion setup.

Installing from PyPI

uv pip install httptap

Or install as a global tool:

uv tool install httptap

pip install httptap

For isolated CLI tool installation:

pipx install httptap

Installing from Source

Clone the repository

git clone https://github.com/ozeranskii/httptap.git
cd httptap

Install with uv

uv sync
uv pip install -e .

Install with pip

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

Verifying Installation

After installation, verify that httptap is correctly installed:

httptap --version

You should see output similar to:

httptap X.Y.Z

Upgrading

To upgrade httptap to the latest version:

brew upgrade httptap

uv pip install --upgrade httptap

pip install --upgrade httptap

Uninstalling

To remove httptap from your system:

brew uninstall httptap

uv pip uninstall httptap

pip uninstall httptap

pipx uninstall httptap

Shell Completions

httptap supports shell completions for bash and zsh.

Homebrew Installation

If you installed httptap via Homebrew, completions are automatically configured. Simply restart your shell:

# Restart your shell
exec $SHELL

Homebrew automatically places completion scripts in:

  • Bash: $(brew --prefix)/etc/bash_completion.d/
  • Zsh: $(brew --prefix)/share/zsh/site-functions/

No additional setup required

Homebrew handles all completion setup automatically. Just restart your shell and start using Tab completion!

Python Package Installation

If you installed httptap via pip, uv, or pipx, you need to install the optional completion extras:

uv pip install "httptap[completion]"

pip install "httptap[completion]"

pipx install "httptap[completion]"

Activation

  1. Activate your virtual environment (if using venv):

    source .venv/bin/activate

  2. Run the global activation script:

    activate-global-python-argcomplete

  3. Restart your shell.

Usage

Once installed and activated, you can use Tab to autocomplete commands and options:

# Complete command options
httptap --<TAB>

# Complete after typing partial option
httptap --fol<TAB>
# Completes to: httptap --follow

# Complete multiple options
httptap --follow --time<TAB>
# Completes to: httptap --follow --timeout

Note

The global activation script provides argument completions for bash and zsh only. Other shells are not covered by the script and must be configured separately.

What's Next?