Production-hardening active (July 2026). Current gates and limitations: STATUS.md. Agent setup: docs/AGENT-ONBOARDING.md.
Local-first personal health assistant: Omi notes, Apple Health, Frame glasses, doctor devices → cited personal patterns → one small action, daily check-ins, and doctor-ready summaries. No cloud by default. No diagnoses or treatment promises.
git clone https://github.com/lamapony/vitaside-hackathon.git
cd vitaside-hackathon
make install # venv + demo vault + sidecar
make ci # backend, UI, architecture, coverage, acceptance
make serve-ui # http://127.0.0.1:5173
./scripts/vitaside pilot "/path/to/private/vault" # real-data field pilotAll commands: make help or ./scripts/vitaside help
| Audience | URL / doc |
|---|---|
| Doctor / demo viewer | https://lamapony.github.io/vitaside-hackathon/ |
| Agent operator (MCP) | docs/AGENT-ONBOARDING.md |
| Repo | https://github.com/lamapony/vitaside-hackathon |
| Mode | Command |
|---|---|
| Verify | make test |
| Unit tests | make pytest |
| Full production gate | make ci |
| Live UI/API smoke | make smoke |
| Full CLI demo | make demo |
| 3-user field pilot | docs/PILOT-3-USERS.md |
| Local dashboard | make serve-ui |
| Start real-data pilot | ./scripts/vitaside pilot "/path/to/private/vault" |
| Rebuild Pages | make pages |
| MCP config file | make mcp-config |
| Path | What |
|---|---|
code/health-mcp-starter/ |
MCP server, FastAPI, React UI, sidecar protocol |
frame/ |
Frame glasses BLE capture |
vitaside/ |
Vision lifestyle analyzer + storage |
data/ |
Demo Frame events |
docs/ |
Docs + GitHub Pages SPA |
vault/ |
Architecture & privacy contracts |
plan/ |
Sprint history (historical) |
export OMI_VAULT_PATH="$HOME/Documents/Obsidian Vault"
cd code/health-mcp-starter
./issue-sidecar.sh sleep-stress-sidecar
make serve-ui # from repo root, or ./serve-ui.sh here
make mcp-config # writes mcp-config.local.json for Cursor/Hermes- STATUS.md — snapshot, tests, limitations
- PRODUCTION_READINESS.md — 8.3/10 audit, scope, evidence, remaining P2 work
- docs/README.md — documentation index
- docs/AGENT-ONBOARDING.md — connect an agent
- docs/PILOT-3-USERS.md — run and verify the 14-day, three-user local pilot
- code/health-mcp-starter/README.md — MCP tools + UI
- code/health-mcp-starter/ARCHITECTURE.md — dependency boundaries and migration path
- CONTRIBUTING.md — fork guidelines
Statistical outputs are observational, include support/uncertainty and multiple-comparison adjustment, and are never presented as causal forecasts.
MIT License · Not a medical device — visit prep patterns only.