---
title: PUE Report Generator
emoji: 📄
colorFrom: green
colorTo: blue
sdk: docker
app_port: 8501
pinned: false
---

# PUE Report Generator

Upload a community **PUE master-sheet** workbook and download a
template-faithful Word report. Every figure is recomputed deterministically
from the sheet — the optional AI step only rewrites prose, never numbers.

Built with Streamlit, deployed via the Docker SDK (entry: `src/streamlit_app.py`).

## AI narratives (optional)
Add a `GOOGLE_API_KEY` secret (Settings → Variables and secrets) and toggle it
on in the sidebar. Without it, prose sections use a deterministic fallback.

## Run locally
```bash
pip install -r requirements.txt
streamlit run src/streamlit_app.py
```