PIP-CONFIG(1)

📦 version 23.2.1, in centos-stream 9

💅 PIP-CONFIG(1) — the pip config glow-up

ok so this is a page from the pip manual set, bestie — it's called pip-config, and it's literally the description of the pip config command. buckle up 🎀

✨ NAME ✨

pip-config — description of pip config command. that's it, that's the name, no cap 🫶

🌸 DESCRIPTION 🌸

Manage local and global configuration. yes bestie, it's giving organization era 👑

Subcommands:

  • list: List the active configuration (or from the file specified)
  • edit: Edit the configuration file in an editor
  • get: Get the value associated with command.option
  • set: Set the command.option=value
  • unset: Unset the value associated with command.option
  • debug: List the configuration files and values defined under them

ok so the way configuration keys work is lowkey iconic: they should be dot separated command and option name, with the special prefix global affecting any command. for example, pip config set global.index-url https://example.org/ would configure the index url for all commands, but pip config set download.timeout 10 would configure a 10 second timeout only for pip download commands. iykyk 💅

ngl this next part matters: if none of --user, --global and --site are passed, a virtual environment configuration file is used if one is active and the file exists. otherwise, all modifications happen to the user file by default. periodt 🦋

⭐ USAGE ⭐

here's the whole vibe chart of how you actually call it, characters and all:

python -m pip config [<file-option>] list
python -m pip config [<file-option>] [--editor <editor-path>] edit

python -m pip config [<file-option>] get command.option
python -m pip config [<file-option>] set command.option value
python -m pip config [<file-option>] unset command.option
python -m pip config [<file-option>] debug

🔥 OPTIONS 🔥

  • --editor <editor> — Editor to use to edit the file. Uses VISUAL or EDITOR environment variables if not provided. so if you don't hand it an editor, it goes looking for those two env vars, okurrr 👀
  • --global — Use the system-wide configuration file only. big main character energy for the whole machine 🌈
  • --user — Use the user configuration file only. just you, just your vibes 💖
  • --site — Use the current environment configuration file only. this environment specifically, bestie ✨
🫶 reminder from your girl: only one of these file options at a time, and if you skip all three, the virtual environment config file wins when it's active and exists — otherwise it's the user file. no surprises.

👑 AUTHOR 👑

pip developers. legends, honestly. ate and left no crumbs 🍓

The pip developers. that's the copyright holder, we stan 💜

and that's the whole page, bestie!! this one was version 23.2, dated Jun 25, 2025 — so when you're out here configuring your index urls and timeouts, you know exactly which manual you read. mwah 💅💖

📦 where this page comes from