chore: migrate deployment to Hugging Face Spaces

- Rewrite Dockerfile: uv-based build, appuser uid 1000, port 7860
- Update PORT default to 7860 across config.py and development.yml
- Remove railway.json (replaced by Dockerfile + HF Spaces)

Dockerfile

@@ -0,0 +1,37 @@
+# Hugging Face Spaces — Docker SDK
+# Docs: https://huggingface.co/docs/hub/spaces-sdks-docker
+
+FROM python:3.12-slim
+
+# ── HF Spaces: non-root user with uid 1000 ────────────────────────────────────
+RUN useradd -m -u 1000 appuser
+
+# ── Install uv ────────────────────────────────────────────────────────────────
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /usr/local/bin/
+
+# ── Working directory ─────────────────────────────────────────────────────────
+WORKDIR /app
+
+# ── Copy dependency manifests first (layer-cache friendly) ───────────────────
+COPY pyproject.toml uv.lock ./
+
+# ── Install dependencies ──────────────────────────────────────────────────────
+RUN uv sync --frozen --no-install-project --no-dev
+
+# ── Copy source ───────────────────────────────────────────────────────────────
+COPY app/ ./app/
+COPY main.py development.yml ./
+
+# ── Fix ownership then drop privileges ────────────────────────────────────────
+RUN chown -R appuser:appuser /app
+USER appuser
+
+ENV HOME=/home/appuser \
+    PATH=/home/appuser/.local/bin:$PATH \
+    PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1
+
+# ── HF Spaces requires port 7860 ──────────────────────────────────────────────
+EXPOSE 7860
+
+CMD ["uv", "run", "main.py"]

app/core/config.py

@@ -51,7 +51,7 @@ class Settings(BaseSettings):
     # ── Server (development.yml) ───────────────────────────────────────────────
     APP_NAME: str = "Markdown & Layout Extractor"
     HOST: str = "127.0.0.1"
-    PORT: int = 8000
+    PORT: int = 7860  # HF Spaces requires 7860; development.yml / env var can override
     LOG_LEVEL: str = "INFO"
 
     # ── CORS (development.yml) ─────────────────────────────────────────────────

app/server.py

@@ -48,5 +48,5 @@ def create_app():
         allow_methods=settings.CORS_ALLOW_METHODS,
         allow_headers=settings.CORS_ALLOW_HEADERS,
     )
- 
+
     return app

development.yml

@@ -3,10 +3,11 @@ MISTRAL_OCR_MODEL: mistral-ocr-latest
 MISTRAL_TABLE_FORMAT: markdown
 
 # ─── Server ────────────────────────────────────────────────────────────────────
-# Local defaults — Railway overrides HOST and PORT via its Variables tab.
+# Local defaults — HF Spaces overrides HOST (0.0.0.0) via Space secrets.
+# PORT must be 7860 for HF Spaces to detect and route the container.
 APP_NAME: "Markdown & Layout Extractor"
 HOST: "127.0.0.1"
-PORT: 8000
+PORT: 7860
 LOG_LEVEL: INFO
 
 # ─── CORS ──────────────────────────────────────────────────────────────────────

main.py

@@ -12,7 +12,7 @@ if __name__ == "__main__":
         host=settings.HOST,
         port=settings.PORT,
         log_level=settings.LOG_LEVEL.lower(),
-        # Trust X-Forwarded-* headers from Railway's edge proxy.
+        # Trust X-Forwarded-* headers from HF Spaces / any reverse proxy.
         proxy_headers=True,
         forwarded_allow_ips="*",
     )

railway.json

@@ -1,13 +0,0 @@
-{
-  "$schema": "https://railway.com/railway.schema.json",
-  "build": {
-    "builder": "NIXPACKS"
-  },
-  "deploy": {
-    "startCommand": "uv run main.py",
-    "healthcheckPath": "/health",
-    "healthcheckTimeout": 30,
-    "restartPolicyType": "ON_FAILURE",
-    "restartPolicyMaxRetries": 3
-  }
-}