# =========================================
# 🚀 CORE FRAMEWORK
# =========================================
fastapi
uvicorn[standard]            # Web server + websockets support
starlette                    # Underlying ASGI framework
psutil

# =========================================
# 📂 FILE UPLOADS / FORM HANDLING
# =========================================
python-multipart             # UploadFile + form data support

# =========================================
# 🗄️ DATABASE + ORM
# =========================================
sqlalchemy                   # ORM
alembic                      # Migrations for SQLAlchemy
psycopg2-binary              # PostgreSQL (optional DB)
sqlite-web                   # GUI debugging for SQLite (optional)

# =========================================
# 🔐 AUTHENTICATION & SECURITY
# =========================================
passlib                      # Password hashing helpers
bcrypt==4.0.1                # Hashing backend
python-jose[cryptography]    # JWT handling
argon2-cffi                  # Stronger hashing alternative
email-validator              # Validates user email fields

# =========================================
# 🧾 VALIDATION & JSON PERFORMANCE
# =========================================
pydantic-settings            # App settings/config
orjson                       # Fast JSON parsing/render
ujson                        # Alternative fast JSON engine

# =========================================
# 🌐 HTTP CLIENTS (SYNC + ASYNC)
# =========================================
requests                     # Traditional HTTP
httpx                        # Async HTTP client

# =========================================
# 🖼 IMAGE PROCESSING
# =========================================
Pillow                       # Image compression/manipulation
rembg                        # AI Background removal tools
onnxruntime                  # Required runtime for rembg (or onnxruntime-gpu)

# =========================================
# 📑 PDF HANDLING
# =========================================
pypdf                        # PDF manipulation

# =========================================
# 📁 ASYNC STORAGE / FILE MANAGEMENT
# =========================================
aiofiles                     # Async file write/read

# =========================================
# ☁️ CLOUD / BUCKET STORAGE (OPTIONAL)
# =========================================
boto3                        # AWS S3 storage
minio                        # Local S3-compatible storage
google-cloud-storage         # Google Cloud storage support
hf                           # OPTIONAL huggingface-cli for deployment purposes

# =========================================
# ⚡ CACHING / QUEUES / BACKGROUND JOBS
# =========================================
redis                        # Cache, sessions, queues
celery                       # Task queue background processing
rq                           # Simpler alternative job queue

# =========================================
# 🔌 WEBSOCKETS / REAL-TIME FEATURES
# =========================================
websockets                   # Extra websocket tools if needed

# =========================================
# 🎨 TEMPLATING (HTML FRONTEND OPTIONAL)
# =========================================
jinja2                       # Template engine

# =========================================
# 🔧 UTILITIES & ENVIRONMENT
# =========================================
python-dotenv                # .env loader