Florence is a humanistic elder-care navigation agent that guides families through intake, recommends care types, matches providers, and submits referrals — by web chat or phone.
Grand Prize winner — AI Healthcare Hack NYC by Arya Health & Twilio AI Startup Searchlight (Jul 2026).
| Devpost | florence-2026 |
| Team | Morrison Chang, Douglas MacKrell, Andrew Lai |
| Overview | docs/portfolio.md |
| Milestone | Status |
|---|---|
| Step Zero — security foundation | ✅ Complete |
| M1 — Web app (text + browser voice) + backend core | ✅ Demo-ready |
| M2 — Twilio telephony | ✅ Demo-ready locally (setup) |
Full detail: docs/roadmap.md
Start here: docs/README.md
| Doc | Description |
|---|---|
| Portfolio overview | Problem, solution, demo story, architecture |
| Quick start | User + developer local run guide |
| Telephony setup | Twilio + ngrok phone demo |
| Architecture | System design and data flow |
| API reference | REST + Twilio endpoints |
| Roadmap | What's done and what's next |
| Product handoff (full spec) | Original requirements |
| Security policy | Data handling and hooks |
| Audience | Guide |
|---|---|
| Try the web demo | docs/quick-start.md |
| Try the phone demo | docs/telephony.md |
| Developers | docs/quick-start.md |
./scripts/dev-up.sh # Postgres + env checks
./scripts/run-demo.sh # terminal demo walkthrough (optional)
# then start backend + frontend (see quick-start guide)- Frontend: React 19, Vite, TypeScript, Web Speech API
- Backend: FastAPI, Pydantic v2, SQLAlchemy 2
- Database: Postgres 16 (Docker)
- LLM: Ollama (
llama3.2:3b) — local only - Telephony: Twilio, Pipecat, Whisper STT, Piper TTS
- Testing: 71 pytest tests, ruff, oxlint, gitleaks
Work on develop, merge to main at stable milestones. No PRs.
git checkout develop
git push origin develop
# Stable milestone:
git checkout main && git merge develop && git push origin main && git checkout developSee docs/development.md.
Public repository — no secrets or real PII in commits. User intake processed by local Ollama only.
See SECURITY.md.