Add Dockerfile and HF Spaces metadata for free deployment

Provides a Docker image compatible with the Hugging Face Spaces free
CPU tier: Python 3.11 slim base, ffmpeg + tesseract installed, runs
uvicorn on port 7860 as a non-root user (UID 1000) per HF requirements.
README frontmatter declares the Space metadata so a git push deploys
the app end-to-end.

.dockerignore

@@ -0,0 +1,13 @@
+.git
+.gitignore
+__pycache__
+*.pyc
+*.pyo
+.pytest_cache
+.venv
+venv
+*.egg-info
+tests
+smaller.m4v
+M14_L3_S3.srt
+Study Guide_ Introduction to Photosynthesis.html

Dockerfile

@@ -0,0 +1,24 @@
+FROM python:3.11-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        ffmpeg \
+        tesseract-ocr \
+        libgl1 \
+        libglib2.0-0 \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN useradd -m -u 1000 user
+USER user
+ENV PATH="/home/user/.local/bin:$PATH" \
+    HOME=/home/user \
+    PYTHONUNBUFFERED=1
+
+WORKDIR /home/user/app
+
+COPY --chown=user:user requirements.txt .
+RUN pip install --no-cache-dir --user -r requirements.txt
+
+COPY --chown=user:user . .
+
+EXPOSE 7860
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,3 +1,13 @@
+---
+title: VideoGuideMaker
+emoji: 🎬
+colorFrom: indigo
+colorTo: purple
+sdk: docker
+app_port: 7860
+pinned: false
+---
+
 # VideoGuideMaker
 
 Generate WCAG 2.2 AA-ready HTML study guides from instructional videos.
@@ -53,6 +63,24 @@ app/
 tests/
 ```
 
+## Deploy to Hugging Face Spaces
+
+This repo ships a Dockerfile compatible with [Hugging Face Spaces](https://huggingface.co/spaces) (free CPU tier).
+
+1. Create a new Space at https://huggingface.co/new-space — pick **Docker** as the SDK and **Blank** as the template.
+2. Push this repo to the Space's git remote:
+   ```bash
+   git remote add space https://huggingface.co/spaces/<your-user>/<space-name>
+   git push space claude/general-session-a1DDz:main
+   ```
+   (or push whichever branch you want as `main`).
+3. Spaces will read the YAML frontmatter at the top of this README, build the Dockerfile, and expose the app on port `7860`.
+
+Notes:
+- Uploads land in `/tmp` inside the container, which is ephemeral — the app is for one-shot processing per visitor.
+- The free CPU tier has plenty of RAM but is not fast; a 20-minute lecture takes a few minutes to process.
+- The Space sleeps after inactivity and wakes on the next request (~30s cold start).
+
 ## Status
 
 MVP. The pipeline runs end-to-end on common inputs. Known gaps: