Gerenciador de Pacotes uv
Ir para notas que citam estaO gerenciador de pacotes uv é uma ferramenta do Python que inicializa o projeto, cria o ambiente virtual e instala e trava as dependências a partir de um único arquivo de configuração.
Num projeto de agentes em LangGraph, ele monta o esqueleto antes de qualquer código: o LangGraph não vem com o Python e precisa ser instalado junto com as bibliotecas de que depende. O uv é uma escolha de preferência e de didática; qualquer outro gerenciador de pacotes serve ao mesmo fim.
O que a inicialização cria
O comando de inicialização (uv init) gera os arquivos iniciais: um main.py de exemplo que já roda um Hello World, um README vazio e o pyproject.toml. Sem um nome explícito, o projeto assume o nome da pasta atual.
O pyproject.toml concentra a configuração do projeto, sobretudo as dependências gerenciadas pelo uv. As bibliotecas instaladas ficam na pasta de ambiente virtual .venv, que cumpre papel parecido com o node_modules do Node.js, e um arquivo de lock trava as versões resolvidas.
Adicionar dependências e sincronizar
Cada dependência entra com uv add. Para agentes com modelos da OpenAI, a base é langchain, langchain-openai (a integração com o provedor, derivada do LangChain), langgraph e python-dotenv, que carrega variáveis de ambiente como a chave de API a partir de um arquivo .env. Outras entram conforme o projeto cresce, como os pacotes mistralai e qdrant-client na etapa de ingestão de RAG.
O uv sync revisa se as dependências instaladas e a configuração do pyproject.toml estão coerentes. É o primeiro recurso diante de um erro de importação: uma configuração no pyproject.toml que torna a pasta de código-fonte a raiz dos imports, dispensando o prefixo da pasta em cada import, só passa a valer depois da sincronização.