dark mode now the default
Two SearchScreen polish items the v0.15-era page never quite landed:
FlutIQ Edge callout under the trust bar
- The new HIW spec (3 step cards + 9-pill trust bar) didn't mention
the local-Ollama deployment mode at all, so the privacy / local-
frontier-intelligence angle was missing from the landing page.
Decision was to keep FlutIQ Cloud as the hero (the live HF Space
is what judges click) but acknowledge Edge as a secondary
deployment option.
- New `.hiw-edge-note` strip: dashed-border centered box, mono
eyebrow "FlutIQ Edge · also runs offline", one sentence of detail
("Gemma 4 e4b on-device via Ollama … address never leaves your
device"). Sits below the trust bar at smaller visual weight than
the step cards on purpose.
Dark mode now the default
- Was `useState(false)` with no persistence; switched to a localStorage-
backed initializer that defaults dark for first-time visitors and
respects whatever the user last toggled via the chrom…
frontend: rebuild "How it works" from FlutIQ_HowItWorks_Rewrite.md spec
Promoted the SearchScreen "How it works" panel from a collapsible
<details> with numbered paragraphs to a full inline section per the
spec dropped in FlutIQ_HowItWorks_Rewrite.md. New structure:
· Centered section header: eyebrow label + 22px headline ("Three
steps from address to action plan.") + intro sentence (the
FEMA-gap thesis as a one-liner).
· Three step cards in a 3-column grid (stacks vertically below
760px). Each card has a mono-tagged step number (01/02/03), a
short action-verb title (Spot the gap / Investigate everything
/ Get your dossier), a Mono subline carrying the punch ("7 AI
agents. 9 public data sources. ~60 seconds."), and one paragraph
of detail.
· Subtle dashed connector between cards on desktop — hints
progression without dominating.
· Trust bar: "Powered by 9 public data sources" headline + 9 pill
badges (FEMA NFHL, FEMA NRI, 311 + Permits, USGS, NOAA,
Open-Meteo, GDELT, Mapbox Satellite, Street View) wrapping
…
The v0.15.4 refresh fixed the accuracy of the SearchScreen "How it
works" panel (was at v0.7-era reality, seven agents and Chicago-only)
but left it as one 89-word run-on sentence that buried the lede:
listed the data sources and architecture before saying *what the
reader gets* or *why FlutIQ exists at all*.
Restructured into three short paragraphs that follow a natural
mental model:
1. Question. The FEMA-gap thesis as the lede ("Is FEMA's flood
zone telling the whole story?"). Establishes why
FlutIQ exists before describing how it works.
2. Investigate. The nine agents + data sources in one paragraph,
with a wall-time number (~30-60s) for grounding.
3. Decide. What the reader actually gets — verdict, checklist,
action plan, insurance recommendation. Closes with
"In your chosen language."
The existing `.learn-body p` CSS already had 12px paragraph spacing,
so no styling changes needed. Stron…
frontend: refresh stale "How it works" + methodology copy + bump badge
Three copy spots were frozen at v0.7-era reality (seven agents, Chicago
311 only, OpenFEMA listed as a source) and didn't reflect what the
system actually does in 2026. Refreshed all three:
· SearchScreen "How it works" details panel (line 1056-57)
· Dossier methodology footer (line 2061)
· Chrome wordmark version badge (line 2075)
New copy reflects: nine agents (was seven), FEMA NRI multi-hazard at
the county level (added v0.14), five Tier-1 cities for 311 + permits
(was Chicago-only), two dedicated Gemma 4 vision agents on Mapbox
satellite + Google Street View with bounding-box detection, building
permits as a leading indicator of impervious-surface change,
single-inference-call multimodal synthesis in the risk analyst,
before-you-sign checklist + bucketed drainage/infiltration/barrier
action plan (v0.15 dossier reframe), and the Edge / local-Ollama
deployment mode.
Sources strip refreshed similarly:
before: FEMA NFHL · Chicago 311 · USGS · …
v0.15.3: make non-English dossiers actually work end-to-end
Hand-testing the Spanish ("es") dossier on a Chicago address surfaced
two distinct failures the original "translate everything" prompt
directive caused:
(1) Empty advisor sections. Gemma 4 in Spanish mode helpfully
translated the technical enum values inside the JSON it returned —
"nfip_standard" became "nfip_estandar", bucket "drainage" became
"drenaje". The strict post-parse filter in advisor_agent.py then
silently dropped every insurance_recommendations entry (none matched
a catalog product_id) and the bucket-grouped action renderer
collapsed all mitigation_actions into the "other" bucket (or the
model emitted an empty array, same result). The dossier rendered
with "The advisor agent did not return insurance recommendations
for this address" and only the forced-passthrough city resources
in the action plan. Functionally broken Spanish.
(2) Mixed-language UI chrome. The model-generated prose translated
correctly (verdict, NRI narrative, vision findings, action descriptions
— all Sp…
Caught when a chip pointed to 1 World Way (Clifton A. Moore Admin
Building at LAX) and FlutIQ still produced residential-flavored
"For this property…" insurance copy, a homeowner action plan, and a
before-you-sign checklist — none of which make sense for a commercial
property. Root cause: property type wasn't surfaced anywhere; advisor
was hardcoded residential.
Fix (Option A — honest residential-only mode, on-brand with FlutIQ's
homeowner mission):
geocoder.py — classify Nominatim hits as residential or commercial
using class/type/name. Defaults to residential unless
the signal is confident; Census fallback assumes
residential (it only resolves TIGER street addresses).
orchestrator — pass property_type through into the dossier payload.
advisor — early-return for commercial: skip the LLM call entirely
and return a graceful note explaining FlutIQ is built
for residential and pointing to …
frontend: rotate example chips for broader story coverage
Swap Hoboken NJ and Miami Beach FL out, add NYC (350 5th Ave) and LA
(1 World Way) in. The previous set had three "coastal/Gulf, no Tier-1
city data" addresses telling variations of one story; the new set
covers four distinct FlutIQ strengths:
· Chicago Drexel — FEMA-gap + full Tier-1 pipeline
· NYC 5th Ave — NE urban, full Tier-1, CSO/sewer story
· LA World Way — full Tier-1, NRI wildfire + earthquake (multi-hazard, not flood)
· Houston Heights — outside Tier-1, NRI hurricane, graceful no-city-data
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
v0.15.1: synthesis-strip permits bug — wrong field name
Was reading `total_value_usd` (which I made up) instead of the real
`total_reported_cost` returned by tools/building_permits.py. Showed up
on the live dossier as `Permits · 89 / / 3y` with the dollar value
missing. Also restructured the join so a missing cost no longer leaves
a stray slash.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds a local-inference path (FlutIQ Edge via Ollama / Gemma 4 e4b)
alongside the existing cloud path (FlutIQ Cloud via OpenRouter / Gemma
4 31B). Same FastAPI server, same agents, same frontend; INFERENCE_BACKEND
env var picks the LLM endpoint. Verified end-to-end on an M4 Pro 24 GB:
/api/assess for a Chicago address completes in ~190s with all 9 agents
finishing on gemma4:e4b. Frontend re-skins itself based on data-variant
so judges can tell the modes apart at a glance (blue Cloud / green Edge).
Directly addresses the hackathon brief's "local frontier intelligence"
and "privacy is non-negotiable" framing.
Reframes the dossier as an expert briefing for someone about to live,
buy, or rent at the property — value is synthesis and time, not novel
prediction:
- risk_agent gains a plain_verdict field (3-5 sentences, second-person,
~10th-grade reading: bottom line first, then most important reason,
then trend direction)
- advisor_agent gains before_you_move_in[] (3-5 due-dilige…
v0.14: regional_risk_agent — FEMA NRI multi-hazard at county level
Broadens FlutIQ from flood-only to multi-hazard. Every county in the US
now gets a calibrated risk profile across 18 hazards (wildfire, hurricane,
tornado, earthquake, drought, heat wave, etc.) at the neighborhood level
from FEMA's National Risk Index — the canonical source.
The win that matters: NRI's data was previously gated behind FEMA's
click-through CSV download. Found the exposed ArcGIS REST endpoint
behind RAPT (Resilience Analysis and Planning Tool):
https://services.arcgis.com/XG15cJAlne2vxtgt/arcgis/rest/services/
National_Risk_Index_Counties/FeatureServer/0/query
Free, no auth, point queries, 467 fields per county, full national
coverage. Verified live across 6 geographies with very different
hazard fingerprints:
Chicago: Cold wave + Winter weather + Tornado + Inland flood
LA: Earthquake + Wildfire + Inland flood (Community
Resilience: Very Low — interesting demo signal)
Houston: Hurricane + Tornado + Inland flood + Lightning
Miami:…
v0.13: Tier-1 multi-city expansion — Chicago + NYC + SF + LA + Austin
Refactors the Chicago-only local_agent into a city-aware system driven
by a registry. Each registry entry encodes the city's Socrata dataset
IDs, field names, flood-related category codes, and a context blurb
that gets injected into the local-agent prompt so Gemma 4 reasons
about each city's actual sewer system (combined vs separated, dominant
flood mode, local hazard pattern).
Honest per-city availability — what each city's dossier actually shows:
Chicago: full — 311 (WIB/SFL) + permits with reported_cost
(e.g. $80M new medical office at 4822 S Cottage Grove)
NYC: 311 — 391 sewer-flood reports per 350 5th Ave query.
Permits intentionally deferred: DOB datasets are
fragmented (legacy is stale, modern lacks dates,
active is filtered to currently-open jobs).
SF: full — 941 sewer reports + 75 permits at $366M (Mission
test point: '595 basement reports, increa…
v0.12: building permits as flood-risk leading indicator (Chicago)
The local agent now pulls TWO Socrata signals in parallel and asks
Gemma 4 to interpret them together: 311 flood reports (the historical
symptom) AND building permits (the leading indicator of impervious-
surface change). The combined-sewer system that handles stormwater
doesn't get upgraded when neighborhoods densify, so each new permit
shifts more load onto the same shared pipes.
The killer narrative this unlocks, verified live for 4521 S Drexel Blvd:
311 reports today: 0 (clean — historically stable)
Building permits: 89 within 1km / 3y, $189M total, including a
$80M new medical office and a $7.2M renovation
of a 15-story building literally next door.
Gemma 4 compound_signal: 'Clean 311 history combined with heavy
recent densification suggests a rising risk profile; the lack of
current reports may be a lagging indicator while the infrastructure
is being stressed by new development.'
That's leading-vs-lagging-indicator reasoning…
v0.11: dedicated satellite-analysis agent with bbox detection
The satellite image is now its own first-class agent (parallel to
the streetview agent) instead of being passed through to the risk
analyst as a raw image with no dedicated extraction. Each vision
agent owns its own image fetch, runs a Gemma 4 vision call with
a domain-specific prompt, and returns structured findings + per-
indicator bounding boxes. The risk analyst still gets both raw
images for cross-modal reasoning.
Why this is a real upgrade over v0.10:
v0.10 sent the satellite to the risk analyst as a raw image
with a generic 'use this for impervious surface reasoning'
hint. The model would mention it in passing.
v0.11 has a dedicated satellite agent that produces structured
output BEFORE the risk synthesis: impervious_estimate_pct,
building_footprint_pct, catchment_assessment, vegetation_buffer,
drainage_features_visible, plus 5+ categorized indicators
(impervious / drainage / water_body / vegetation / building /
other) with bounding boxes. The risk analyst the…
v0.10: 3-image multimodal — satellite + wider-area + street view in one Gemma 4 call
Risk analyst now reasons across THREE visual perspectives plus all
6 data sources in a single inference, exercising six Gemma 4
capabilities at once (vision + interleaved multimodal + reasoning
+ structured JSON + long context + graceful per-image fallback).
Pipeline:
Mapbox satellite (zoom 17, ~150m across) →
Mapbox outdoors (zoom 15, ~600m across) →
Google Street View (heading-aimed at the building) →
+ 6 data agents → risk analyst (Gemma 4 reasoning=on)
Verified end-to-end against 4521 S Drexel Blvd, Chicago. The model
named all three views in its trace ('From the satellite I can see…',
'In the street view…') and produced a visual_corroboration that
explicitly cross-referenced views vs data:
'The satellite view confirms a high percentage of impervious surface
due to the large asphalt parking lot, increasing runoff. The street
view corroborates the presence of basement-level windows, which
create a direct vulnerability to water ingress that is not reflected
…
v0.9: multimodal risk analyst — vision + reasoning + 6 data sources in one Gemma 4 call
The risk analyst now receives the Street View photo as an image_url
content part alongside the text data from every other agent, with
reasoning mode enabled. Single Gemma 4 inference pass composes:
vision + reasoning + interleaved multimodal + structured JSON +
long context.
Per Gemma 4 best practice the image goes BEFORE the text in the
user message content array.
Concretely, the chain-of-thought trace now reads like a single mind
reasoning across both modalities, e.g. for 4521 S Drexel Blvd:
'I can see basement-level windows (partially obscured by the
fence). This is a critical vulnerability for surface water
ingress. The driveway is paved (impervious) and appears to slope
slightly toward the building/parking area, which could channel
water toward the foundation.'
…then cross-references with the FEMA zone, 311 count, weather
forecast, and AEP math. The model is examining the patient, not
reading the nurse's notes.
Backend:
- risk_agent.py accepts streetview_image_d…
v0.8: Gemma 4 bounding-box detection on Street View
The streetview agent now returns a 2D bounding box per identified
indicator using Gemma 4's native object-detection capability. The
frontend overlays the boxes on the actual image as an SVG so users
can see exactly which pixels Gemma 4 saw.
Smoke-tested against Drexel Blvd Chicago: returns
- basement-level windows [moderate] box_2d=[400, 205, 458, 242]
- sloping driveway [low] box_2d=[455, 395, 580, 552]
both in the Gemini-convention yxyx 0-1000 normalized format.
Backend (streetview_agent.py + scripts/smoke_test_bbox.py):
- System prompt now describes the bounding-box convention
explicitly (yxyx, normalized 0-1000, top-left origin) — verified
via smoke test that Gemma 4 follows the explicit instruction
reliably while being unreliable about self-describing format.
- User prompt schema adds box_2d field per indicator entry.
- Post-parse validator drops box_2d if it isn't a valid 4-tuple of
numbers in [0, 1000] with ymin<ymax and xmin<xmax. Indicator
itself i…
v0.7: README rewrite + version bump for multi-language + vision
Significant version jump from v0.4 prototype → v0.7 beta. Two
capabilities shipped since the v0.4 README was written that
materially change what FlutIQ is:
- Multi-language dossier (es, zh, vi, ht, ar, tl) — Digital
Equity & Inclusivity prize track angle
- Street View vision agent (multimodal Gemma 4) — eliminates
the 'shallow Gemma 4 usage' critique by adding actual visual
reasoning over a property photograph
README updates:
- 'Live demo' link to kredd25-flutiq.hf.space at the top
- 'What's new in v0.7' section right after the mission
- Mermaid architecture diagram now shows 6 data agents (added
Street View) and the language-aware advisor
- Tech stack table adds multimodal row, Google Street View row,
and updates hosting to single-Space
- Project structure adds streetview_agent.py, streetview.py,
languages.py, static/, README.md, DEPLOY.md
- 'What you see' section now describes 6 dossier sections (the
new §03 'What we saw at the property' …
The single deepest Gemma 4 capability we hadn't been using. Adds a
6th data agent that fetches a Google Street View image at the
property and asks Gemma 4 (vision) to identify visible flood-risk
indicators: basement-level windows, ground-floor HVAC, drainage
infrastructure, evidence of past water damage, elevation vs street.
Backend:
- New backend/app/tools/streetview.py — Google Street View Static
API client. Metadata-first pattern (free, doesn't count against
quota): walks radii None→50m→200m→500m looking for a real
panorama before fetching the image. Computes a bearing from the
panorama's actual location back to the geocoded address so the
camera aims AT the building (without this, default heading shows
the road, not the property — verified with a Drexel Blvd test
case where unaimed heading produced property_visible=false but
the aimed shot found a real impermeable-paving indicator).
Image returned as a data: URL ready to inline into the vision
request.
- New ba…
Adds a language dropdown in the chrome bar that controls the language
of all user-facing copy in the dossier. Hits the Digital Equity &
Inclusivity track, and is the strongest single demo moment for the
mission framing — a Pilsen homeowner getting their flood-risk briefing
in Spanish without having to translate jargon.
Backend:
- New backend/app/data/languages.py — registry of 7 supported codes
(en, es, zh, vi, ht, ar, tl) covering ~80% of non-English-speaking
households in US flood-prone metros (USCB ACS 2022). normalize()
collapses 'es-MX' → 'es' and unknown codes → 'en'.
- prompt_directive(code) emits the language directive injected into
the risk + advisor agent system prompts. Critical bilingual rule:
user-facing copy translates, but legal product names (NFIP flood
insurance, sewer/water-backup endorsement), URLs, phone numbers,
dollar amounts, and JSON keys stay English. Otherwise the homeowner
can't search/say the right thing to actually buy the product.
- Assess…
frontend: render queued agents distinctly (was collapsed into idle)
The orchestrator emits status=queued for risk + advisor while the
5 data agents are still running. Previously the frontend mapped
queued → idle, so users saw 'IDLE' next to risk/advisor and
assumed they wouldn't run, even though they did and produced
output. Now queued is its own visible state — amber dot, amber
text, an explanatory line ('queued — waiting for upstream agents').
Also added explicit error styling (coral dot + text) which was
missing.
deploy: bundle frontend into FastAPI for single-Space deploy
Restructures so one HF Space serves both the API and the frontend
on a single port — chosen over the spec's split (HF + Cloudflare)
because for a hackathon demo a single URL is what gets pasted into
Kaggle / the video, and the CDN advantage is meaningless for a few
judges.
Mechanics:
- index.html → backend/static/index.html (git mv, no copy)
- FastAPI mounts static/ and serves index.html at GET /. The
api/* routes are registered first so they always win.
- Dockerfile COPYs static/ alongside app/.
- Frontend API_URL resolver: same-origin by default; falls back to
http://127.0.0.1:8000 only when the page is served on a non-8000
localhost port (e.g. python -m http.server 5173). The window.
FLUTIQ_API and ?api=... overrides still work for split deploys.
Local dev simplified — single uvicorn now serves everything:
cd backend && .venv/bin/uvicorn app.main:app --reload --port 8000
open http://127.0.0.1:8000
Verified end-to-end: GET / returns 74KB of HTML (the frontend),
GET…
