AI Restyle: Phase 1+2 backend ML pipeline (no routes/UI yet)

.env.example

@@ -1,9 +1,69 @@
-# AWS S3 (optional — for clip backup/gallery)
-AWS_ACCESS_KEY_ID=your_aws_access_key_here
-AWS_SECRET_ACCESS_KEY=your_aws_secret_key_here
+# =============================================================================
+# OpenShorts environment configuration
+#
+# Copy this file to `.env` (gitignored) and fill in the values you need.
+# Most API keys are stored encrypted in the browser and sent via headers — they
+# do NOT need to be set here unless you want a server-side fallback.
+# =============================================================================
+
+# --- Required (server-side reads via os.getenv) -----------------------------
+
+# Google Gemini API key — used by the viral-clip extractor in main.py.
+# https://ai.google.dev/gemini-api/docs/api-key
+GEMINI_API_KEY=
+
+# --- Optional: AWS S3 (clip backup + public gallery) ------------------------
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
 AWS_REGION=eu-west-3
-AWS_S3_BUCKET=your-bucket-name
-AWS_S3_PUBLIC_BUCKET=your-public-bucket-name
+AWS_S3_BUCKET=
+AWS_S3_PUBLIC_BUCKET=
+
+# --- Optional: YouTube ingestion --------------------------------------------
+
+# Disable the YouTube URL ingest tab entirely (uploads-only mode).
+DISABLE_YOUTUBE_URL=false
+
+# Netscape-format cookies (concatenated into one line) to bypass YouTube's
+# bot-detection on server IPs. yt-dlp writes this to /app/cookies.txt at
+# container startup.
+# YOUTUBE_COOKIES=
+
+# --- Optional: Remotion render service --------------------------------------
+
+# Used by the backend to call the renderer.
+# Default uses Docker's internal network (service name + container port).
+# If you run the backend OUTSIDE Docker, change to: http://localhost:3003
+RENDER_SERVICE_URL=http://renderer:3100
+
+# --- Tuning -----------------------------------------------------------------
+
+# Max concurrent video-processing jobs (asyncio semaphore in the job queue).
+MAX_CONCURRENT_JOBS=5
+
+# AI Restyle upload cap (megabytes). The /api/restyle route does a Content-Length
+# preflight before touching disk; requests above this return 413 immediately.
+AI_RESTYLE_MAX_FILE_SIZE_MB=250
+
+# =============================================================================
+# Frontend (dashboard/) — Vite reads these at build time
+# =============================================================================
+
+# Production API URL override (defaults to relative paths in dev).
+VITE_API_URL=http://localhost:3002
+
+# Optional salt for localStorage API-key encryption.
+# VITE_ENCRYPTION_KEY=
+
+# =============================================================================
+# Client-side keys (stored encrypted in the browser, sent via headers per-call)
+#
+# These are listed here for reference. The Python code does NOT read them from
+# .env — set them in the dashboard UI instead. Listed below in case you want
+# a server-side default (would require code changes in app.py to honor them).
+# =============================================================================
 
-# YouTube cookies (optional — paste Netscape-format cookies to bypass bot detection)
-# YOUTUBE_COOKIES=...
+# ELEVENLABS_API_KEY=
+# UPLOAD_POST_API_KEY=
+# FAL_KEY=

.gitignore

@@ -12,6 +12,11 @@
 __pycache__/
 *.pyc
 
+# Editable-install / build artifacts
+*.egg-info/
+build/
+dist/
+
 # Temporary files / runtime dirs
 temp_*
 uploads/
@@ -33,10 +38,19 @@ output/
 # Cache dirs
 .cache/
 .config/
+.pytest_cache/
+
+# Test ephemera (baseline.openapi.json IS committed; current is not)
+backend/tests/snapshots/current.openapi.json
+backend/tests/fixtures/smoke.mp4
 # Multi-agent Skills
 .agents/
 .agent/
 .claude/
 skills/
 skills-lock.json
 
+# Session-local artifacts (handovers, test screenshots) — not for git
+.session/
+.compact-ultra
+

.pre-commit-config.yaml

@@ -0,0 +1,10 @@
+repos:
+  - repo: local
+    hooks:
+      - id: update-claude-md
+        name: Regenerate CLAUDE.md auto-managed sections
+        entry: python scripts/update_claude_md.py
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [pre-commit]