feat: add HuggingFace Spaces Docker deployment

- Dockerfile: python:3.11-slim + Node 22, builds all 3 layers
- nginx.conf: routes /api/* and /health to Node proxy (3000),
everything else to Next.js standalone (3030); listens on 7860
- supervisord.conf: manages model + server + frontend + nginx
- .dockerignore: excludes node_modules, .venv, .next, .env.local
- next.config.ts: enable standalone output for Docker
- README.md: add HF Spaces YAML frontmatter (sdk: docker, port: 7860)

NEXT_PUBLIC_API_URL="" at build time → relative /api/* URLs →
nginx proxies to Node → Node proxies to Python model.
Model weights cached in /data/models (HF Spaces persistent storage).

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

.dockerignore

@@ -0,0 +1,24 @@
+# Build artifacts
+demo/.next/
+demo/out/
+
+# Dependencies (installed inside Docker)
+demo/node_modules/
+demo/server/node_modules/
+model/voxtral-server/.venv/
+
+# Local env overrides
+demo/.env.local
+demo/.env*.local
+
+# Python cache
+**/__pycache__/
+**/*.pyc
+**/*.pyo
+**/*.egg-info/
+
+# Git
+.git/
+
+# Logs
+*.log

Dockerfile

@@ -0,0 +1,55 @@
+# Ethos Studio — HuggingFace Spaces Docker deployment
+# Architecture: Python model (8000) + Node proxy (3000) + Next.js (3030)
+#               nginx on port 7860 routes traffic between layers
+
+FROM python:3.11-slim
+
+# ─── System dependencies ──────────────────────────────────────────────────────
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ffmpeg curl nginx supervisor \
+    && rm -rf /var/lib/apt/lists/*
+
+# Node.js 22
+RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \
+    && apt-get install -y --no-install-recommends nodejs \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# ─── Model layer: Python dependencies ────────────────────────────────────────
+COPY model/voxtral-server/requirements.txt model/voxtral-server/requirements.txt
+RUN pip install --no-cache-dir -r model/voxtral-server/requirements.txt
+
+COPY model/voxtral-server/ model/voxtral-server/
+
+# ─── Proxy server: Node dependencies ─────────────────────────────────────────
+COPY demo/server/package*.json demo/server/
+RUN cd demo/server && npm ci --omit=dev
+
+COPY demo/server/ demo/server/
+
+# ─── Frontend: Next.js build ──────────────────────────────────────────────────
+COPY demo/package*.json demo/
+RUN cd demo && npm ci
+
+COPY demo/ demo/
+
+# Build with empty API base → browser uses relative paths → nginx routes /api/*
+RUN cd demo && NEXT_PUBLIC_API_URL="" npm run build \
+    && cp -r public .next/standalone/public \
+    && cp -r .next/static .next/standalone/.next/static
+
+# ─── Process manager + reverse proxy config ───────────────────────────────────
+COPY nginx.conf /etc/nginx/nginx.conf
+COPY supervisord.conf /etc/supervisor/conf.d/app.conf
+
+# ─── Model weight cache ───────────────────────────────────────────────────────
+# /data is persisted across Space restarts on HuggingFace Spaces
+RUN mkdir -p /data/models
+ENV TRANSFORMERS_CACHE=/data/models
+ENV HF_HOME=/data/models
+
+# HuggingFace Spaces public port
+EXPOSE 7860
+
+CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/app.conf"]

README.md

@@ -1,3 +1,13 @@
+---
+title: Ethos Studio
+emoji: 🎤
+colorFrom: purple
+colorTo: indigo
+sdk: docker
+app_port: 7860
+pinned: false
+---
+
 # Ethos Studio — Emotional Speech Recognition
 
 Speech-to-text service with VAD sentence segmentation and per-segment emotion analysis, powered by [Voxtral Mini 4B](https://huggingface.co/mistralai/Voxtral-Mini-4B-Realtime-2602). Three-layer architecture: **Model** (Python) + **Server** (Node) + **Frontend** (Next.js).

demo/next.config.ts

@@ -1,7 +1,7 @@
 import type { NextConfig } from "next";
 
 const nextConfig: NextConfig = {
-  /* config options here */
+  output: "standalone",
 };
 
 export default nextConfig;

nginx.conf

@@ -0,0 +1,39 @@
+worker_processes 1;
+error_log /dev/stderr warn;
+pid /tmp/nginx.pid;
+
+events {
+    worker_connections 512;
+}
+
+http {
+    include /etc/nginx/mime.types;
+    default_type application/octet-stream;
+    access_log /dev/stdout;
+    client_max_body_size 100M;
+
+    server {
+        listen 7860;
+
+        # API + health check → Node proxy server (port 3000)
+        location ~ ^/(api|health)(/|$) {
+            proxy_pass http://127.0.0.1:3000;
+            proxy_read_timeout 660s;
+            proxy_send_timeout 660s;
+            proxy_connect_timeout 10s;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        }
+
+        # All other requests → Next.js standalone (port 3030)
+        location / {
+            proxy_pass http://127.0.0.1:3030;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection "upgrade";
+        }
+    }
+}

supervisord.conf

@@ -0,0 +1,54 @@
+[supervisord]
+nodaemon=true
+logfile=/dev/null
+logfile_maxbytes=0
+pidfile=/tmp/supervisord.pid
+
+; ─── Model layer: Voxtral FastAPI (port 8000) ─────────────────────────────────
+[program:model]
+command=uvicorn main:app --host 127.0.0.1 --port 8000
+directory=/app/model/voxtral-server
+autostart=true
+autorestart=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
+priority=10
+
+; ─── Proxy server: Node/Express (port 3000) ───────────────────────────────────
+[program:server]
+command=node index.js
+directory=/app/demo/server
+autostart=true
+autorestart=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
+environment=PORT="3000",MODEL_URL="http://127.0.0.1:8000"
+priority=20
+
+; ─── Frontend: Next.js standalone (port 3030) ─────────────────────────────────
+[program:frontend]
+command=node .next/standalone/server.js
+directory=/app/demo
+autostart=true
+autorestart=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
+environment=PORT="3030",HOSTNAME="127.0.0.1"
+priority=20
+
+; ─── nginx reverse proxy (port 7860 — HF Spaces public port) ─────────────────
+[program:nginx]
+command=nginx -g "daemon off;"
+autostart=true
+autorestart=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
+priority=30