Início·Comandos de terminal

pip install

Pacotes e runtimes

Uso

python -m pip install [-r requirements.txt] <package>

Instala um pacote no Python ativo; chamar como python -m pip evita o caso clássico de um pip que pertence a outro interpretador, e desde a PEP 668 um Python do sistema recusa instalar fora de um ambiente virtual.

Opções comuns

OpçãoSignificado
-r <file>install everything a requirements file lists
-Uupgrade to the newest allowed version
-e .editable install of the project you are in
--userinto your home directory instead of the system
--no-depsthis package only, no dependencies
-c <file>apply a constraints file to the versions
--break-system-packagesoverride the PEP 668 refusal on a system python

Exemplos

python -m pip install -r requirements.txt

installs a pinned set into the active environment

python -m pip install -U requests

upgrades one package

python -m pip install -e .

installs your own project so edits take effect at once

A pergunta é sempre o que vai onde: dentro deste projeto ou na máquina toda.

Como ler

  • Os colchetes [ ] marcam uma parte que você pode omitir.
  • As reticências … indicam que você pode listar vários.
  • As opções diferenciam maiúsculas: em alguns comandos -r e -R fazem coisas diferentes.

Perguntas

Q. O que pip install faz?

Instala um pacote no Python ativo; chamar como python -m pip evita o caso clássico de um pip que pertence a outro interpretador, e desde a PEP 668 um Python do sistema recusa instalar fora de um ambiente virtual.

Q. Como se digita?

python -m pip install [-r requirements.txt] <package> — os colchetes marcam o que você pode omitir.

Q. Quantas opções vale a pena saber?

Aqui estão 7; a lista completa está em man pip. Este comando fica em Pacotes e runtimes.

Comandos relacionados

página man: man pip-install