Upload folder using huggingface_hub

.gitignore

@@ -10,4 +10,9 @@ llm_documentation.md
 # enironment variable
 .env
 
-uploaded_files
+uploaded_files
+.venv
+
+# vs code config
+.vscode
+backend.code-workspace

requirements.txt

@@ -1,8 +1,86 @@
-fastapi 
-uvicorn
-requests
-pillow
-python-multipart
-pypdf
-python-dotenv
-pydantic-settings
+# =========================================
+# 🚀 CORE FRAMEWORK
+# =========================================
+fastapi
+uvicorn[standard]            # Web server + websockets support
+starlette                    # Underlying ASGI framework
+
+# =========================================
+# 📂 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
+
+# =========================================
+# 📑 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                           #huggingface-cli
+
+# =========================================
+# ⚡ 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