Nexova-Labs/Astra-true-Build

Astra — civic intelligence PWA powered by Gemma 4 (Blue Mauritius hackathon build) # Aequora Aequora is Nexova Labs' Gemma Hackathon 2026 civic intelligence product: a mobile-first PWA for community reporting, participatory budget tradeoffs, and transparent public decision-making. React/Vite frontend, FastAPI backend, SQLite fixture loading, deterministic civic solver, shared packages, mobile product shell, accounts/roles/region-scoped access, and a Gemma gateway with three real inference tiers (verified-fixture default, cloud via Google Vertex AI, and on-device/edge via Ollama with per-capability escalation) including Kreole Mauritian-language support and an experimental LoRA fine-tune. ## Quickstart Run these commands from a clean clone. ```powershell npm install cd apps/api py -m venv .venv .venv\Scripts\python -m pip install -e ".[dev]" cd ../.. Copy-Item .env.example .env npm run fixture:load npm run dev ``` If the Windows `py` launcher is unavailable, create the venv with any Python 3.12 executable: ```powershell \python.exe -m venv apps/api/.venv ``` Expected local URLs: - Frontend: `localhost` - API health: `127.0.0.1` - AI gateway health: `127.0.0.1` ## Commands ```powershell npm run fixture:load npm run typecheck npm run build cd apps/api .venv\Scripts\python -m pytest -v ``` ## Branches - `main`: shared base. - `pre-final-branch` / `working-branch1`: active integration branch (kept fast-forwarded to match each other when they have no divergent commits — check `git log` before assuming this is still true). - `working-branch-2-*`, `Working_Branch3`: per-contributor feature branches; check `docs/hackathon-progress-log.md` for what each currently holds before building on one. This list drifts fast in a multi-branch hackathon repo — run `git branch -a` and check `docs/hackathon-progress-log.md`'s most recent rows rather than trusting it blindly. ## Product Direction Aequora helps residents and civic teams: - report local issues with text, image, audio, and location context …