Módulo 6 - Ambientes virtuais e pip

Instalando pacotes com pip

11 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 01/07/2026

O que você vai aprender

  • Instalar um pacote externo com pip install.
  • Listar os pacotes instalados com pip list.
  • Inspecionar um pacote com pip show.
  • Confirmar que o pacote foi para o ambiente certo.

Instalar o seu primeiro pacote

Com o ambiente virtual ativo, instalar um pacote é um comando só. Vamos usar o requests, uma das bibliotecas mais conhecidas do Python, que facilita acessar a web. Ela não vem com o Python; é um pacote externo que mora no PyPI, o repositório oficial. O pip baixa e instala tudo para você, junto com as bibliotecas das quais o requests depende. Antes de rodar, confira o prefixo (.venv) no terminal: ele garante que o pacote vai para a despensa do projeto, e não para a instalação global.

# confirme o (.venv) no comeco da linha antes de instalar
pip install requests

Com o ambiente ativo, o pip instala o requests só nesta despensa.

O pip mostra o download e termina com uma linha de sucesso, algo como Successfully installed. Repare que ele instala mais do que só o requests: aparecem outros nomes, como urllib3 e certifi. Esses são as dependências, os pacotes de que o requests precisa para funcionar. O pip resolve isso sozinho, baixando a árvore inteira. Você não precisa se preocupar em instalar cada peça à mão; pediu o requests, o pip traz o pacote e tudo que ele exige.

Ver o que já está instalado

Depois de instalar, é útil saber o que a despensa do projeto contém. O comando pip list mostra todos os pacotes instalados no ambiente ativo, com as respectivas versões, em duas colunas. Rode-o dentro do ambiente e você verá o requests e as dependências que vieram junto, cada um com o número da versão. Esse número importa: é ele que você vai querer registrar depois, para que o projeto seja reproduzível. Rodar pip list com o ambiente desativado mostra os pacotes globais, uma lista diferente.

Package    Version
---------- -------
certifi    2024.x
charset-normalizer 3.x
idna       3.x
pip        24.x
requests   2.x
urllib3    2.x

Saída típica de pip list: o requests e as dependências que vieram com ele.

Inspecionar um pacote de perto

Às vezes você quer detalhes de um pacote específico: a versão exata, para que serve, quem mantém, de que outros pacotes ele depende. O comando pip show, seguido do nome do pacote, traz essa ficha. Ele mostra a versão instalada, um resumo, a página oficial, a licença, as dependências e até onde o pacote foi instalado no disco. É um ótimo primeiro passo antes de confiar em uma biblioteca: dá para ver se está viva, qual a licença e o que ela arrasta junto.

pip show requests

pip show exibe versão, resumo, licença e dependências do pacote.

Vale um lembrete de bom senso: instalar um pacote é rodar código de outra pessoa no seu computador. Antes de instalar bibliotecas que você não conhece, confira se o nome está certo (erros de digitação podem levar a pacotes falsos), veja se o projeto é ativo e olhe a página oficial no PyPI. Para os pacotes muito conhecidos e usados neste curso, como o requests, esse cuidado já está resolvido pela comunidade. O hábito de olhar antes de instalar, porém, é uma boa prática que vale para a vida toda de programação.

Teste rápido

Você rodou pip install requests, mas com o ambiente virtual desativado. O que acontece?

Perguntas frequentes

Preciso instalar o pip separado?
Não. O pip já vem com o Python nas versões atuais e, dentro de um ambiente virtual, cada despensa tem o próprio pip. Basta ativar o ambiente e usar. Se um dia o pip pedir atualização, ele mesmo mostra o comando sugerido na tela.
De onde o pip baixa os pacotes?
Do PyPI, o Python Package Index, o repositório público oficial de pacotes Python. Quando você roda pip install requests, o pip procura o requests no PyPI, baixa o pacote e as dependências dele e instala tudo no ambiente ativo.
Por que o pip instalou outros pacotes além do que pedi?
Porque a biblioteca que você pediu depende de outras para funcionar. O requests, por exemplo, usa urllib3 e certifi por baixo. O pip resolve essa árvore de dependências sozinho e instala tudo que é necessário, para você não precisar caçar cada peça à mão.
Como sei se o pacote foi para o ambiente certo?
Confira o prefixo (.venv) no terminal antes de instalar e use pip list depois. Se quiser uma prova, rode pip list com o ambiente ativo e depois com ele desativado: o pacote aparece só no primeiro caso, o que mostra que ele está isolado no projeto.
É seguro instalar qualquer pacote que eu encontrar?
Convém ter cuidado. Instalar um pacote é rodar código de terceiros no seu computador. Confira o nome exato para evitar pacotes falsos por erro de digitação, veja se o projeto é ativo e olhe a página oficial no PyPI. Bibliotecas muito conhecidas, como o requests, já têm confiança consolidada.
Para que serve o pip show?
Ele mostra a ficha de um pacote instalado: versão, resumo, página oficial, licença, dependências e onde ficou no disco. É útil para conferir a versão exata e entender o que a biblioteca arrasta junto, antes de depender dela no projeto.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.