fix: configure Hugging Face Spaces deployment with Docker SDK

Major changes to match HF Spaces requirements:

1. **Switch to Docker SDK** (was: streamlit)
- Updated README YAML frontmatter to use `sdk: docker`
- HF Spaces requires Docker SDK for complex multi-dependency apps

2. **Create proper Dockerfile** (was: Dockerfile.spaces)
- Renamed to `Dockerfile` (HF Spaces looks for this exact name)
- Added non-root user (UID 1000) - HF Spaces security requirement
- Use port 7860 (HF Spaces default) instead of 8000
- Simplified to only run Streamlit UI (API not needed for demo)
- Optimized layer caching with requirements.txt first

3. **Add .dockerignore**
- Exclude dev files, tests, cache, and virtual envs from image
- Reduces build time and image size

Based on successful Devon/CodePilot HF Spaces deployment pattern.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

.dockerignore

@@ -0,0 +1,24 @@
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.so
+*.egg
+*.egg-info
+dist
+build
+.git
+.gitignore
+.env
+.venv
+venv
+*.md
+!README.md
+.pytest_cache
+.coverage
+htmlcov
+.mypy_cache
+.ruff_cache
+tests/
+*.log

Dockerfile

@@ -1,32 +1,39 @@
 FROM python:3.11-slim
 
+# Set working directory
 WORKDIR /app
 
 # Install system dependencies
 RUN apt-get update && apt-get install -y \
-    build-essential \
-    curl \
+    git \
     && rm -rf /var/lib/apt/lists/*
 
-# Install Poetry
-RUN pip install poetry==1.7.1
+# Create non-root user for security (HF Spaces requirement)
+RUN useradd -m -u 1000 user
+USER user
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH
 
-# Copy dependency files
-COPY pyproject.toml poetry.lock* ./
+# Set working directory for user
+WORKDIR $HOME/app
 
-# Install dependencies (no dev dependencies in production)
-RUN poetry config virtualenvs.create false \
-    && poetry install --no-interaction --no-ansi --no-dev
+# Copy requirements first (for better caching)
+COPY --chown=user requirements.txt ./
 
-# Copy source code
-COPY src/ ./src/
-COPY ml/ ./ml/
+# Install Python dependencies
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir -r requirements.txt
 
-# Set Python path
-ENV PYTHONPATH=/app/src
+# Copy application code
+COPY --chown=user src/ ./src/
+COPY --chown=user app.py ./
 
-# Expose ports
-EXPOSE 8000 8501
+# Expose port 7860 (HuggingFace Spaces default)
+EXPOSE 7860
 
-# Default command (API server)
-CMD ["uvicorn", "cascade.api.main:app", "--host", "0.0.0.0", "--port", "8000"]
+# Set environment variables
+ENV PORT=7860
+ENV HOST=0.0.0.0
+
+# Run Streamlit
+CMD ["streamlit", "run", "app.py", "--server.port", "7860", "--server.address", "0.0.0.0"]

Dockerfile.spaces

@@ -1,18 +0,0 @@
-FROM python:3.11-slim
-
-WORKDIR /app
-
-# Install dependencies
-COPY pyproject.toml ./
-RUN pip install poetry && poetry config virtualenvs.create false && poetry install --no-dev
-
-# Copy application
-COPY src/ ./src/
-COPY app.py ./
-
-# Expose ports
-EXPOSE 7860 8000
-
-# Start both API and UI
-CMD uvicorn cascade.api.main:app --host 0.0.0.0 --port 8000 & \
-    streamlit run app.py --server.port 7860 --server.address 0.0.0.0

README.md

@@ -3,9 +3,7 @@ title: Cascade - Intelligent LLM Router
 emoji: 🌊
 colorFrom: purple
 colorTo: blue
-sdk: streamlit
-sdk_version: "1.31.0"
-app_file: app.py
+sdk: docker
 pinned: false
 ---