Pular para o conteúdo
LabS Atlas
AI For Devs
Entrar

Ambiente Virtual Python

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Ambiente virtual Python é o mecanismo que isola as bibliotecas de um projeto do restante da máquina, como uma partição descartável que evita conflitos de versão entre projetos.

Com o ambiente virtual, criado tradicionalmente com o venv, as dependências ficam numa pasta própria do projeto em vez do Python global: apagar essa pasta remove tudo o que foi instalado ali sem tocar no resto do sistema. Projetos de agentes em Python, como os construídos com CrewAI ou LangGraph, dependem desse isolamento desde a primeira instalação.

Compatibilidade de versões como motivo principal

Poupar disco e memória da máquina é um benefício, mas o motivo central é outro: bibliotecas exigem versões específicas de outras bibliotecas e do próprio interpretador. Um caso típico é o de uma biblioteca de rastreamento de objetos em imagem que só funcionava no Python 3.9, versão já perto de ser depreciada.

O problema cresce em frameworks de agentes, que empilham camadas: o CrewAI é escrito em Python e usa o LangChain por dentro, uma ferramenta que usa uma ferramenta que usa outra. Cada camada traz suas exigências de versão.

Quando o conflito está no próprio interpretador, o ambiente virtual não basta. Um projeto que exigia Python 3.10 ou 3.12, numa máquina com 3.13, consumiu mais de uma hora de investigação até ser resolvido com Docker, em vez de trocar a versão instalada no sistema.

Ambiente virtual não é o arquivo .env

O ambiente virtual guarda bibliotecas; o .env é um arquivo de configuração com variáveis de ambiente, como a chave de API de um modelo, que a biblioteca python-dotenv carrega no código sem que a chave apareça escrita nele.

Chave de API fora do versionamento

O .env preenchido nunca deve subir para um repositório público: ele fica listado no .gitignore. Há casos de chaves expostas no GitHub com consequências ruins para quem as publicou.

uv como alternativa ao pip

O uv substitui o pip na criação do projeto: um único comando com o nome do projeto cria a estrutura, o ambiente virtual e o esqueleto das variáveis de ambiente do projeto.