PIP-CONFIG(1)

📦 version 22.3.1, in centos-stream 9

🎀 NAME 🎀

okay so this is pip-config — the manual page for the pip config command, and it's literally about managing your config, bestie. that's the whole vibe. 💅

✨ DESCRIPTION ✨

Manage local and global configuration. yes, both. you contain multitudes. 🌈

Subcommands: (the little menu of what pip config can do for you) 🍓

  • 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

Configuration keys should be dot separated command and option name, with the special prefix global affecting any command. no cap, that global prefix is the main character here 👑

so like, 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. see the difference? the way that dot does so much work 😭

fr fr important part: 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. so like… know where your writes are landing, bestie 🫶

🌸 USAGE 🌸

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> — the Editor to use to edit the file. Uses VISUAL or EDITOR environment variables if not provided. so if you don't hand it one, it goes looking for your env vars first, iykyk 🌸
  • --global — Use the system-wide configuration file only. big boss energy, system-wide 👑
  • --user — Use the user configuration file only. just you, just your file 💜
  • --site — Use the current environment configuration file only. cute, current, environment-specific 🦋

🎀 AUTHOR 🎀

pip developers 🫶

The pip developers

and that's the page!! 💖 the source/version is 22.3 and it's dated Jun 25, 2025, so yeah — that's the whole thing, go forth and configure slayfully bestie 😭✨💅

📦 where this page comes from