Ambiente Virtual Python
Ir para notas que citam estaAmbiente 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.
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.