uv-package-manager

Create a New Project

# Create new project with virtual environment
uv init my-project
cd my-project
Or create in current directory
uv init .
Initialize creates:
- .python-version (Python version)
- pyproject.toml (project config)
- README.md
- .gitignore

Install Dependencies

# Install packages (creates venv if needed)
uv add requests pandas
Install dev dependencies
uv add --dev pytest black ruff
Install from requirements.txt
uv pip install -r requirements.txt
Install from pyproject.toml
uv sync

Project Setup

1. Always use lockfiles for reproducibility 2. Pin Python version with .python-version 3. Separate dev dependencies from production 4. Use uv run instead of activating venv 5. Commit uv.lock to version control 6. Use --frozen in CI for consistent builds 7. Leverage global cache for speed 8. Use workspace for monorepos 9. Export requirements.txt for compatibility 10. Keep uv updated for latest features

Performance Tips

# Use frozen installs in CI
uv sync --frozen
Use offline mode when possible
uv sync --offline
Parallel operations (automatic)
uv does this by default
Reuse cache across environments
uv shares cache globally
Use lockfiles to skip resolution
uv sync --frozen  # skips resolution