https://github.com/pypa/get-pip
Helper scripts to install pip, in a Python installation that doesn't have it.
https://github.com/pypa/get-pip
Last synced: 12 days ago
JSON representation
Helper scripts to install pip, in a Python installation that doesn't have it.
- Host: GitHub
- URL: https://github.com/pypa/get-pip
- Owner: pypa
- License: mit
- Created: 2016-01-20T12:50:35.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2025-05-02T15:39:20.000Z (about 2 months ago)
- Last Synced: 2025-05-15T01:37:16.468Z (about 2 months ago)
- Language: Python
- Homepage: https://bootstrap.pypa.io/pip/
- Size: 144 MB
- Stars: 808
- Watchers: 39
- Forks: 310
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- starred-awesome - get-pip - (Python)
README
# get-pip.py
`get-pip.py` is a bootstrapping script that enables users to install pip
in Python environments that don't already have it installed. You
should not directly reference the files located in this repository and instead
use the versions located at .
## Usage
```console
$ curl -sSL https://bootstrap.pypa.io/get-pip.py -o get-pip.py
$ python get-pip.py
```
Upon execution, `get-pip.py` will install the latest version of `pip` into the
current Python environment. When using Python 3.11 or older, by default the
packages `setuptools` and `wheel` will also be installed if an existing version
of them was not found.
It is possible to provide additional arguments to the underlying script. These
are passed through to the underlying `pip install` command, and can thus be
used to constrain the versions of the packages, install additional packages,
or to pass other pip options such as `--no-index`.
```console
# Constrain the pip version
$ python get-pip.py "pip < 21.0"
# Force the installation of `setuptools` and `wheel` on newer Python versions.
$ python get-pip.py setuptools wheel
# Install packages from a local directory instead of PyPI.
$ python get-pip.py --no-index --find-links=/local/copies
```
### get-pip.py options
This script also has its own options, which control which packages it will
install.
- `--no-setuptools`: Do not attempt to install `setuptools`. This is a no-op on Python 3.12+.
- `--no-wheel`: Do not attempt to install `wheel`. This is a no-op on Python 3.12+.
## Development
You need to have a [`nox`](https://nox.readthedocs.io/) available on the CLI.
### How it works
`get-pip.py` bundles a copy of pip with a tiny amount of glue code. This glue
code comes from the `templates/` directory.
### Updating after a pip release
If you just made a pip release, run `nox -s update-for-release -- `.
This session will handle all the script updates (by running `generate`), commit
the changes and tag the commit.
IMPORTANT: Check that the correct files got modified before pushing. The session
will pause to let you do this.
### Generating the scripts
Run `nox -s generate`.
## Discussion
If you run into bugs, you can file them in our [issue tracker].
You can also join `#pypa` or `#pypa-dev` on Freenode to ask questions or
get involved.
[issue tracker]: https://github.com/pypa/get-pip/issues
## Code of Conduct
Everyone interacting in the get-pip project's codebases, issue trackers, chat
rooms, and mailing lists is expected to follow the [PSF Code of Conduct].
[PSF Code of Conduct]: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md