README.md

---
title: "San Jose Crash Data Dashboard"
emoji: 🚦
colorFrom: blue
colorTo: red
sdk: streamlit
sdk_version: 1.32.0
app_file: app.py
pinned: false
---

# San José Real-Time Crash Data Dashboard

This is a real-time data visualization dashboard built with Streamlit using San José's open crash dataset API.

## Features

- Real-time API integration with San José open data portal
- Interactive charts: weather, surface condition, speed flag, and more
- Geospatial crash heatmaps
- Filters for time range (3m, 6m, 9m, 1y) and council district
- Toggleable views and "🔁 Refresh Data" button

## Setup Instructions

1. Clone the repo or upload files to Hugging Face Spaces
2. Ensure Python 3.8+ environment
3. Install dependencies:

```bash
pip install -r requirements.txt
```

4. Run the Streamlit app:

```bash
streamlit run app.py
```

## Live Deployment

To deploy on [Hugging Face Spaces](https://huggingface.co/spaces), include this README and ensure the file structure matches:

- app.py
- requirements.txt
- README.md