Safe Routes Multi-Agent Demo (Working Starter)

This folder contains a working baseline of your routing + crime-scoring agents.

1) Install

python -m venv .venv && source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

2) Configure

Copy the example env, then edit your keys:

cp .env.example .env
# open .env and set MAPS_KEY and GOOGLE_GENLANG_KEY

• MAPS_KEY must have Routes API and Places API enabled with billing.
• GOOGLE_GENLANG_KEY must be allowed to call generativelanguage.googleapis.com.
• Default model: gemini-2.5-flash. You can override per agent with GOOGLE_GENLANG_MODEL_ROUTER / GOOGLE_GENLANG_MODEL_CRIME.

3) Run with your ADK / UI

This repo assumes you’re launching via your Agent Dev Kit (ADK) which loads agent.py and expects root_agent to be defined.

Examples:

# If your ADK has a web UI
adk web

# or development CLI
adk dev

Then ask:

I want to walk from Brickell to Florida International University.

You should see:

• Router: Yippie — generating routes and passing them to safety scoring now.
• Crime agent: top-3 routes with duration, distance, risk summary, and maps links.

Notes

• If you see Missing MAPS_KEY, set your key in .env.
• If you see Using http2=True, but the 'h2' package is not installed, run: pip install "httpx[h2]".
• If you see API_KEY_SERVICE_BLOCKED for Gemini, check key restrictions and enabled APIs.