Apppublic

DarkCipher00/blitzmate-engine

sourceHugging Faceupdated 1mo agoView on Hugging Face

0likes

App README

heatsafe-api

Backend for HeatSafe — cool-route planning and fleet heat-risk intelligence built on the FortyGuard Temperature API. Team Cool-Staff, FortyGuard Hackathon'26.

A delivery courier in San Jose enters A → B and gets the coolest safe route, not just the fastest — scored by a Heat Exposure Index computed from street-level temperature, exceedance, and persistence data.

Documents (read before writing code)

Doc	Purpose
docs/ARCHITECTURE.md	Full system design, ADRs, 13-day plan, scope guillotine — validate this first
docs/CONTRACT.md	Frozen API contract between this repo and `heatsafe-web` (freeze: Day 3)

Stack (planned)

FastAPI · OSMnx + NetworkX (heat-weighted A* routing) · FortyGuard Temperature API (tcm / exceedance / persistence, disk-cached) · Gemini Flash (alert narration) · SSE (simulated fleet telemetry)

Getting started

Requires uv and Python 3.12 (pinned — uv sync installs it if missing).

bash

cp .env.example .env            # add the FortyGuard key (warmup only)
uv sync

# Build the offline fixture cache (zero credits; needs the sibling
# temperature-api-quickstart checkout) so /grid works immediately:
uv run python scripts/build_fixture_cache.py

# Run the API:
uv run uvicorn --factory heatsafe_api.app:create_app --port 8000

curl 'localhost:8000/health'
curl 'localhost:8000/grid?layer=tcm'

Live FortyGuard warmup (spends credits — team-lead approval required first):

bash

uv run python scripts/warmup.py --dry-run   # call sequence + credit math
uv run python scripts/warmup.py             # the real run

Status

Design docs validated against the official Participant Handbook (Aug 19). Implementation in progress during the build sprint (Aug 18–30).

Submission requirements (handbook §11 + T&C)

—Live demo link (team server) · demo video ≤ 3 min · written summary ≤ 500 words (problem → user → endpoints used → measured result)
—Judge repo access: Hackathon-FG (hackathon@fortyguard.com) added as collaborator on this repo
—Submission deadline: Aug 30, 11:59 PM GST — no late entries

Team

Cool-Staff — org: Cool-Staff · sibling repo: heatsafe-web