braceiqmed/README.md

BraceIQMed

Medical scoliosis brace generation platform.

Architecture

braceiqmed/
├── frontend/          # React + Vite + Three.js
├── api/               # Node.js Express API server
├── brace-generator/   # FastAPI + PyTorch brace generation
├── templates/         # Brace template STL/GLB files
├── scoliovis-api/     # ScolioVis ML model for spine detection
└── scripts/           # Deployment scripts

Quick Start (Local Development)

# Build all containers
docker compose build

# Start all services
docker compose up -d

# View logs
docker compose logs -f

# Stop all services
docker compose down

Access at: http://localhost

Deployment (EC2)

First-time setup on server:

# Clone the repo
git clone https://github.com/YOUR_USERNAME/braceiqmed.git ~/braceiqmed
cd ~/braceiqmed

# Build and start
docker compose build
docker compose up -d

Update deployment:

cd ~/braceiqmed
git pull
docker compose up -d --build

Or use the deploy script:

./scripts/deploy.sh

Services

Service	Internal Port	Description
Frontend	80	React SPA + nginx proxy
API	3002	Express.js REST API
Brace Generator	8002	FastAPI + PyTorch

Environment Variables

See .env.example for available configuration options.

License

Proprietary - All rights reserved.