Sahil-singh11/HackathonMDX

repository for hackathon middlesex. # Lamer Konekte **Lapes pli konekte. Desizion pli informe.** A Morisyen-first, multimodal catch-recording and marine-information assistant for Mauritius's artisanal fishers — built by **Team Ctrl200** for the Gemma 4 hackathon (Multimodal Track, Blue Economy pillar). ## The problem Artisanal fishing feeds Mauritius, but catch declarations are paper-based, marine information is scattered, regulations reach fishers second-hand, and almost nothing exists in Morisyen — the language fishers actually speak. ## The solution Three moments, one PWA: 1. **Before the trip** — ask in Morisyen or English; Gemma calls `get_marine_conditions`; waves/swell/SST shown with a mandatory advisory disclaimer. 2. **On the water** — photograph the catch → quality gate (no tokens on bad photos) → constrained Gemma species *suggestion* → **mandatory fisher confirmation** → ruler-measured length → **deterministic, source-attributed rule check**. 3. **Back ashore** — catch log, offline queue, declaration draft (PDF) → clearly labelled **MOCK** ministry endpoint → demonstration receipt. ## Gemma 4's role Hosted **`gemma-4-26b-a4b-it`** via the official `google-genai` SDK: image understanding, visible characteristics, Morisyen/English intent, structured JSON, and **native function calling** over 12 allow-listed tools with a full tool-response round trip. Gemma never decides legality, never verifies size, never confirms species — humans and deterministic code do. > **Status:** all ten hosted Gemma gates **PASS on real inference** (`docs/GEMMA_GATES.md`) — image + Morisyen + structured output + native function calling with a completed tool round trip, verified live through the app. Median latency ≈19 s on the current key tier (the UI shows progress states and a latency badge). Without a key the app falls back to a **clearly disclosed** deterministic mock; nothing mocked is ever presented as Gemma inference. ## Architecture FastAPI (Python 3.12, SQLModel/SQLite) + React/TypeScript PWA ( …