Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Gerenciador de Pacotes uv

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.

O 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.