Skip to main content

BrainPredict Smart City: Getting Started

Connect your city data brokers and run your first 35-model urban AI inference in under 20 minutes.

Prerequisites

  • Active BrainPredict Smart City subscription (or sovereign air-gapped licence for government)
  • Access to city data: ISO 37120 KPIs, GTFS/GTFS-RT transit, SCADA/OPC-UA for utilities, CCTV/LPR for traffic
  • Identity & access governance aligned with EU AI Act Art.14 (HITL gate roles defined)
  • Network connectivity (for hosted) or certified hardware (for sovereign deployment — RPi4 CM4 minimum)
  • CSRD reporting entity declared (if ESG auto-export is enabled)

Step 1 — Get Your API Key

Sign in to the BrainPredict portal and navigate to Smart City → Settings → API Keys:

bp_smart_city_live_1234567890abcdef1234567890abcdef

For sovereign deployments, the API key is provisioned on the Ed25519-signed deployment manifest shipped with the hardware kit.

Step 2 — Ingest ISO 37120 KPIs

Push your city's ISO 37120 indicators (energy, water, waste, mobility, safety):

curl -X POST https://api.brainpredict.ai/api/v1/smart-city/kpi/ingest \
  -H "Authorization: Bearer $BP_SMART_CITY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city": "Tallinn-EE", "period": "2026-Q1", "iso_37120": {"energy_per_capita_kwh": 8120, "water_losses_pct": 9.2, "waste_diversion_pct": 58.4}}'

Step 3 — Run Your First Inference

Predict tomorrow's peak-load window with conformal 90% bounds:

curl -X POST https://api.brainpredict.ai/api/v1/smart-city/energy/forecast \
  -H "Authorization: Bearer $BP_SMART_CITY_KEY" \
  -d '{"substation_id": "SUB-NORD-01", "horizon_hours": 24}'
# → {"forecast_mw":[184.2, ...], "conformal_lower":[...], "conformal_upper":[...], "alpha":0.10}

Step 4 — Enable DT Federation (optional)

Join a multi-city consortium under GDPR Art.89 with Gaussian DP (ε=0.8, δ=1e-5):

curl -X POST https://api.brainpredict.ai/api/v1/smart-city/federation/join \
  -H "Authorization: Bearer $BP_SMART_CITY_KEY" \
  -d '{"consortium_id": "baltic-smart-cities-2026", "role": "participant", "dp_epsilon": 0.8}'

Next Steps