Initial commit: FaceFusion REST API

FastAPI wrapper around FaceFusion v3.5.3 submodule with:
- Sync and async (job-based) processing endpoints
- FaceFusion bridge with manual key registration and Lock-serialized processing
- Multi-target Dockerfile (CPU + CUDA GPU)
- Docker Compose configs for dev, prod-cpu, and prod-gpu
- Gitea CI/CD workflow with dual image builds
- All 11 FaceFusion processors supported via options API

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Dockerfile

@@ -0,0 +1,55 @@
+ARG VARIANT=cpu
+
+# ---- CPU base ----
+FROM python:3.12-slim AS base-cpu
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ffmpeg curl libgl1-mesa-glx libglib2.0-0 \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements-cpu.txt /tmp/requirements.txt
+RUN pip install --no-cache-dir -r /tmp/requirements.txt && rm /tmp/requirements.txt
+
+# ---- GPU base ----
+FROM nvidia/cuda:12.4.1-cudnn-runtime-ubuntu22.04 AS base-gpu
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    python3 python3-pip python3-venv \
+    ffmpeg curl libgl1-mesa-glx libglib2.0-0 \
+    && ln -sf /usr/bin/python3 /usr/bin/python \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements-gpu.txt /tmp/requirements.txt
+RUN pip install --no-cache-dir --break-system-packages -r /tmp/requirements.txt && rm /tmp/requirements.txt
+
+# ---- Final stage ----
+FROM base-${VARIANT} AS final
+
+# CWD must be the FaceFusion submodule root so resolve_file_paths('facefusion/...')
+# resolves correctly (FaceFusion uses relative paths from CWD internally)
+WORKDIR /app/facefusion-src
+
+# Copy the FaceFusion submodule (preserving its directory structure)
+COPY facefusion/ /app/facefusion-src/
+
+# Copy API application code and config
+COPY app/ /app/app/
+COPY facefusion.ini /app/facefusion-src/facefusion.ini
+
+RUN mkdir -p /data/uploads /data/outputs /data/models /data/temp /data/jobs
+
+# Symlink models directory so FaceFusion's resolve_relative_path('../.assets/models/...')
+# resolves to the persistent volume (relative to facefusion/filesystem.py)
+RUN mkdir -p /app/facefusion-src/.assets && \
+    ln -sf /data/models /app/facefusion-src/.assets/models
+
+VOLUME ["/data/uploads", "/data/outputs", "/data/models", "/data/temp", "/data/jobs"]
+
+ENV PYTHONPATH=/app
+
+EXPOSE 8000
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --retries=3 \
+    CMD curl -f http://localhost:8000/api/v1/health || exit 1
+
+CMD ["python", "-m", "uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--workers", "1"]