README.md

HEMAS NeuroTrack FastAPI

This project ports the complete notebook logic from gait2 (5).ipynb into a FastAPI app with Swagger UI.

Run

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app:app --reload

Open Swagger UI:

• http://127.0.0.1:8000/docs

Endpoint

• POST /analyze
  • form-data:
    • video: video file (front-view gait)
    • patient_gender: male or female

Response includes:

• clinical interpretation text (same wording/thresholds as notebook)
• gait score and interpretation
• full feature values
• URL to annotated output video
• URL to biomarker plot image

Automatic cleanup for runs/

Generated files from /analyze_files are stored under runs/outputs. To prevent storage growth, use the cleanup script every 30 minutes.

Script path:

• scripts/cleanup_runs.py

Behavior:

• Deletes files older than 30 minutes (default)
• Removes empty subdirectories

Local host cron example

*/30 * * * * /usr/bin/python3 /path/to/GAIT_API/scripts/cleanup_runs.py --path /path/to/GAIT_API/runs --max-age-minutes 30 >> /var/log/gait_cleanup.log 2>&1

Docker container cron example (host cron running docker exec)

*/30 * * * * docker exec gait-api python /app/scripts/cleanup_runs.py --path /app/runs --max-age-minutes 30 >> /var/log/gait_cleanup.log 2>&1

Replace gait-api with your running container name.