setup HF support

.gitignore

@@ -173,6 +173,9 @@ cython_debug/
 # PyPI configuration file
 .pypirc
 
+# Runtime outputs
+runs/
+
 # Cursor  
 #  Cursor is an AI-powered code editor.`.cursorignore` specifies files/directories to 
 #  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data

Dockerfile

@@ -25,10 +25,10 @@ COPY app.py /app/app.py
 COPY scripts /app/scripts
 
 # Create output directory
-RUN mkdir -p /app/runs/outputs
+RUN mkdir -p /app/runs/outputs && chmod +x /app/scripts/start.sh
 
 # Expose port
-EXPOSE 8000
+EXPOSE 7860
 
 # Run the application
-CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8000"]
+CMD ["/app/scripts/start.sh"]

README.md

@@ -20,7 +20,15 @@ Open Swagger UI:
 - `POST /analyze`
   - form-data:
     - `video`: video file (front-view gait)
-    - `patient_gender`: `male` or `female`
+    - `gender`: `male` or `female`
+
+- `POST /analyze_files`
+  - form-data:
+    - `video`: video file
+    - `gender`: `male` or `female`
+
+- `GET /download/{filename}`
+- `GET /health`
 
 Response includes:
 
@@ -57,3 +65,35 @@ Behavior:
 ```
 
 Replace `gait-api` with your running container name.
+
+## Hugging Face Spaces (Docker) deployment
+
+This repository is ready for Docker Spaces deployment. The container now:
+
+- listens on `PORT` (default `7860`) required by Spaces
+- starts a background cleanup loop for `/app/runs`
+- launches the API via `scripts/start.sh`
+
+Environment variables (optional):
+
+- `PORT` (default: `7860`)
+- `CLEANUP_INTERVAL_SECONDS` (default: `1800`)
+- `RUNS_MAX_AGE_MINUTES` (default: `30`)
+
+## GitHub Actions auto-deploy to your HF Space
+
+Workflow file:
+
+- `.github/workflows/deploy-hf-space.yml`
+
+Target Space:
+
+- `xplorers/GAIT_API`
+
+### Required GitHub secret
+
+Add this repository secret in GitHub:
+
+- `HF_TOKEN` = a Hugging Face User Access Token with write permission to `xplorers/GAIT_API`
+
+On every push to `main`, GitHub Actions force-pushes this repo to your Space.

app.py

@@ -17,7 +17,7 @@ import base64
 import io
 
 app = FastAPI(
-    title="HEMAS NeuroTrack Gait Analysis API",
+    title="Gait Analysis API",
     description="Clinical gait analysis using MediaPipe Pose estimation",
     version="1.0.0"
 )