dependency-manager

Dependency Manager

Manage Python project dependencies with UV, pip-tools, or requirements.txt.

Quick Start

Choose UV for new projects (fast, modern), pip-tools for existing pip workflows, or requirements.txt for simple projects.

Instructions

Choosing a Tool

UV - Fast, modern Python package manager (recommended):

• Extremely fast dependency resolution (10-100x faster than pip)
• Automatic virtual environment management
• Drop-in replacement for pip and pip-tools
• Lock file support with uv.lock
• Best for: All projects, especially new ones

pip-tools - Lightweight, pip-compatible workflow:

• Generates lock files from requirements.in
• Works with existing pip workflows
• Minimal changes to project structure
• Best for: Existing projects, CI/CD with pip, gradual adoption

requirements.txt - Simple, universal:

• Direct pip install
• No additional tools
• No lock file (unless manually maintained)
• Best for: Simple scripts, minimal dependencies, quick prototypes

UV Setup (Recommended)

Install UV:

curl -LsSf https://astral.sh/uv/install.sh | sh
# Or with pip
pip install uv

Initialize new project:

uv init my-project
cd my-project

Add dependencies:

# Runtime dependency
uv add requests

# Development dependency
uv add --dev pytest

# With version constraint
uv add "requests>=2.28.0,<3.0.0"

Install dependencies:

uv sync

Update dependencies:

# Update all
uv lock --upgrade

# Update specific package
uv lock --upgrade-package requests

Remove dependencies:

uv remove requests

Show dependency tree:

uv tree

Export to requirements.txt:

uv pip compile pyproject.toml -o requirements.txt

Run commands in virtual environment:

uv run python script.py
uv run pytest

pip-tools Setup

Install pip-tools:

pip install pip-tools

Create requirements.in:

# requirements.in
requests>=2.28.0
flask>=2.0.0