| # HEMAS NeuroTrack FastAPI |
|
|
| This project ports the complete notebook logic from `gait2 (5).ipynb` into a FastAPI app with Swagger UI. |
|
|
| ## Run |
|
|
| ```bash |
| 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 |
|
|
| ```bash |
| */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) |
|
|
| ```bash |
| */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. |
|
|
