Nexova-Labs/Astra-true-Build
Domaine:
digital infrastructureType de record:
softwareproject
Créateur:
Nex
Hôte:
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 …