## Quickstart

### Prerequisites
- Python 3.10+
- `uv` package manager
- System deps for `dlib`, `opencv-python`, and `ffmpeg` (recommended to use Docker)

### Local (dev)
1. Install deps:
   - `make install-dev`
2. Run server (reload):
   - `make run-dev`
3. Open API docs:
   - `http://localhost:9001/docs`

### Tests & QA
- Lint: `make lint`
- Format: `make format`
- Types: `make check-types`
- Tests: `make test`

### Docker
- Build: `make docker-build`
- Run: `make docker-run`

### Notes
- Ensure model files and word lists exist under `app/resources` before running.
- Configure environment in `config/env.local` and export or use Docker compose.