PyPI
Introduction to PyPI
PyPI (The Python Package Index), code-hosted at https://pypi.org/, is the official third-party software repository for the Python programming language.
Switching pip Package Mirror
The pip tool only supports https by default, please do not use http.
Python 3.11 had implemented PEP 668, which is a significant proposal enhancing the Python packages to specify whether they can be installed in the global interpreter context by default. Encountering such kind of issue, you could try creating a virtual environment using venv, or use other virtual-environment-based package managers.
Temporary Usage
pip install -i https://mirrors.hust.edu.cn/pypi/web/simple <some-package>
Set as Default
pip config set global.index-url https://mirrors.hust.edu.cn/pypi/web/simple
Please upgrade pip to version 10 or above before configuring.
If the pip version is low, you can use the following command to upgrade pip
python -m pip install -i https://mirrors.hust.edu.cn/pypi/web/simple --upgrade pip
Switching PDM Package Mirror
PDM supports configuring the package mirror using the pdm config command or environment variables. For long-term use, it is recommended to configure it through pdm config.
Config the package mirror using the pdm config command:
pdm config pypi.url https://mirrors.hust.edu.cn/pypi/web/simple
Or config the PDM package mirror using environment variables:
export PDM_PYPI_URL=https://mirrors.hust.edu.cn/pypi/web/simple
Switching Poetry Package Mirror
Poetry only supports project-specific configuration, instead of configuring a global mirror.
Poetry supports configuring the current project's package mirror using the poetry source command or by modifying pyproject.toml.
Config the package mirror using the poetry source command:
poetry source add --priority=primary mirrors https://mirrors.hust.edu.cn/pypi/web/simple
Or modify pyproject.toml to config the package mirror, add the following content to the pyproject.toml file:
[[tool.poetry.source]]
name = "mirrors"
url = "https://mirrors.hust.edu.cn/pypi/web/simple"
priority = "primary"
Switching pipx Package Mirror
pipx uses the same mirror as pip by default, so the method of configuring the package mirror is the same as pip.
Switching Back to Default Mirror
If you want to use the official default mirror, change the mirror url in the above commands to https://pypi.org/simple and configure it in the same way.