Configure for Hugging Face Spaces with Docker SDK and add limitations notice

Dockerfile

@@ -1,17 +1,35 @@
-# Read the doc: https://huggingface.co/docs/hub/spaces-sdks-docker
-# you will also find guides on how best to write your Dockerfile
+# Hugging Face Spaces Dockerfile
+# Note: This Space has LIMITED functionality because HF Spaces doesn't support Docker-in-Docker
+# Session management and file operations require Docker and won't work here
+# Only the stateless /execute endpoint will function
 
-FROM python:3.9
+FROM python:3.11-slim
 
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create user
 RUN useradd -m -u 1000 user
 USER user
 ENV PATH="/home/user/.local/bin:$PATH"
 
 WORKDIR /app
 
+# Copy requirements and install
 COPY --chown=user ./requirements.txt requirements.txt
 RUN pip install --no-cache-dir --upgrade -r requirements.txt
 
+# Copy application code
 COPY --chown=user . /app
 
+# Expose port
+EXPOSE 7860
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:7860/health || exit 1
+
+# Run the application
 CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]

HF_SPACES_NOTICE.md

@@ -0,0 +1,71 @@
+# ⚠️ Hugging Face Spaces Limitation Notice
+
+This Code Execution Sandbox API is deployed on Hugging Face Spaces, but **HF Spaces does not support Docker-in-Docker**, which is required for the full feature set.
+
+## What Works on HF Spaces ✅
+
+- **Stateless Code Execution**: The `/execute` endpoint works with limited languages
+- **API Health Check**: `/health` endpoint
+- **API Documentation**: Interactive docs at `/docs`
+
+## What Doesn't Work on HF Spaces ❌
+
+- **Session Management** - Cannot create persistent sessions
+- **File Operations** - Cannot upload/download files
+- **Multi-Language Environment** - Limited to basic Python/Node.js/Bash
+- **Docker-in-Docker** - Not supported on HF Spaces infrastructure
+
+## Full Functionality Deployment
+
+To use the complete enhanced sandbox with sessions and file operations, deploy on:
+
+### Recommended Platforms
+1. **Railway.app** - Full Docker support ✅
+2. **Render.com** - Docker support ✅  
+3. **Self-hosted VPS** - DigitalOcean, Linode, AWS EC2 ✅
+4. **Cloud Container Services** - AWS ECS, GCP Cloud Run, Azure Container Instances ✅
+
+### Quick Deploy to Railway
+
+```bash
+# Install Railway CLI
+npm install -g @railway/cli
+
+# Login
+railway login
+
+# Deploy
+railway init
+railway up
+```
+
+## Testing Locally
+
+For full functionality, run locally with Docker:
+
+```bash
+# Clone the repository
+git clone https://huggingface.co/spaces/fariasultanacodes/isolated-sandbox
+cd isolated-sandbox
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Start Docker Desktop
+
+# Build the dev environment image
+pwsh build_devenv.ps1
+
+# Run the API
+python app.py
+```
+
+Then access the full API at `http://localhost:7860` with all features working!
+
+## API Documentation
+
+See the main [README.md](README.md) for complete API documentation and usage examples.
+
+---
+
+**Note**: This Space serves as a demo and documentation hub. For production use of session management and file operations, please deploy to a Docker-capable platform listed above.

README.md

@@ -1,3 +1,13 @@
+---
+title: Code Execution Sandbox API
+emoji: 🔒
+colorFrom: blue
+colorTo: purple
+sdk: docker
+pinned: false
+license: mit
+---
+
 # Code Execution Sandbox API - Enhanced
 
 Secure, isolated code execution environment with **persistent VM-like sessions** and **file system operations**.