Python Environment Management

CRITICAL RULE: Never use pip directly. Always use uv. This applies to all Python package management.

Golden Rule

ALWAYS use uv for Python package and environment management. Never use pip directly.

Commands

Project Setup

For new projects:

uv init
uv add <dependencies>
uv sync

For existing projects with pyproject.toml:

uv sync
uv run python main.py

Rules

1. Never use pip install — always uv pip install or uv add
2. Never install globally — use uv tool install for CLI tools
3. Always work in a venv — created by uv venv or uv sync
4. Use uv run — to execute scripts within the project environment

This Project

The Task Management system uses uv:

cd "Task Management"
uv sync                           # Install dependencies
uv run python .scripts/tasks      # Run CLI tools