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.
Ouvir o resumo desta aula
Um recap de cerca de 2 minutos na voz do Valim, para ouvir no trânsito ou na academia.
Ler a transcrição do resumo
Resumo da aula: Instalando pacotes com pip.
Os objetivos desta aula. 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.
Veja o essencial, parte por parte.
Instalar o seu primeiro pacote. Com o ambiente ativo, instale um pacote com: pip install requests
Ver o que já está instalado. Rode pip list com o ambiente ativo: aparece o requests.
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.
Esse foi o resumo do essencial. Para se aprofundar, leia a aula completa e responda os exercícios.
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 requestsCom 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.xSaí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 requestspip 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.