# ── Core Hugging Face stack ───────────────────────────────────────────────────
transformers>=4.40.0
huggingface-hub>=0.22.0         # model/dataset download utilities
tokenizers>=0.19.0              # fast tokenisers (used internally by transformers)

# ── Vision ───────────────────────────────────────────────────────────────────
Pillow>=10.2.0                  # image loading, resizing, annotation drawing

# ── Numerics ─────────────────────────────────────────────────────────────────
numpy>=1.26.0

# ── Configuration ─────────────────────────────────────────────────────────────
pyyaml>=6.0.1
python-dotenv>=1.0.0

# ── API ───────────────────────────────────────────────────────────────────────
fastapi>=0.110.0
uvicorn[standard]>=0.29.0
pydantic>=2.6.0

# ── UI ────────────────────────────────────────────────────────────────────────
gradio>=4.28.0

# ── CLI ───────────────────────────────────────────────────────────────────────
# (argparse is in the standard library — no extra dep needed)

# ── Testing ───────────────────────────────────────────────────────────────────
pytest>=8.1.0
httpx>=0.27.0                   # async test client for FastAPI

# ── PyTorch (install separately to choose the right CUDA / CPU wheel) ─────────
# CPU-only (default, works everywhere):
#   pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu
#
# CUDA 12.1 (recommended for GPU inference):
#   pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121
#
# See scripts/setup.sh for an automated installer.

# ── Optional extras ───────────────────────────────────────────────────────────
# sentencepiece>=0.2.0   # required if using XLM-RoBERTa or multilingual models
# protobuf>=4.25.0       # sentencepiece backend dependency
# timm>=0.9.0            # needed by some DETR backbone variants
# accelerate>=0.29.0     # multi-GPU / mixed-precision inference
