Kith&Kin is a real-time Gemini companion for elderly Chinese-speaking parents navigating Australian pharmacy and GP visits. The MVP uses a React client, FastAPI backend proxy, one Gemini Live session, ADK agents, PostgreSQL memory, and a stdio MCP tool server.

Phases 00–02 provide the normative contracts, source reconciliation, Live transcription validation harness, secure environment/tooling foundation, typed runtime/MCP/card schemas, backend state machines, and frontend wire mapper. The authenticated Live provider checkpoint remains explicitly credential-blocked.

cp .env.example .env
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env
docker compose up -d postgres postgres_test
uv sync --project backend --all-groups
npm --prefix frontend ci

GOOGLE_API_KEY is optional for tests and is required only for opt-in provider validation and later Live integration.

backend/.venv/bin/pytest backend/tests/unit -v
backend/.venv/bin/ruff check backend
backend/.venv/bin/mypy backend/app
npm --prefix frontend run lint
npm --prefix frontend run typecheck
npm --prefix frontend run test
npm --prefix frontend run build
docker compose config

Architecture and implementation order are defined in docs/CODE_PLAN.md.