---
title: Message Router — An Inbox That Reasons
emoji: 🧭
colorFrom: green
colorTo: pink
sdk: static
pinned: false
short_description: Interactive WhatsApp UI for a real AI notification router
---

# Message Router — an inbox that reasons

A WhatsApp-accurate, fully interactive front end for the notification-routing
pipeline documented in the parent repo's `README.md`. Every decision shown
here is a real, precomputed output of the actual run — nothing is invented
for the demo, and no API key is needed to view it.

- Pick any of the 32 real inboxes from the dropdown and browse their chats.
- Tap a message with a dashed outline to open the animated 5-phase routing
  trace: bundle → media → rules → router → normalize, including hard-override
  behavior, evidence, and the semantic-consistency check.
- **Router HQ** (pinned chat, pulses on load) narrates the architecture
  inside a chat thread, with tappable quick replies and deep links into real
  examples.
- **Try It Yourself** (pinned chat) runs a small client-side heuristic so you
  can type your own message and get an instant (clearly-labelled toy) verdict.
- Search, Unread/Groups filters, a ⋮ menu, and the static architecture
  diagram below the phone (animated on scroll) are all live, not decorative.
- Light/dark theme toggle, default light.

This folder is exactly what gets deployed — nothing here needs a build step.

## Local preview

```bash
cd hf
python -m http.server 8000
# open http://localhost:8000
```

## Regenerating data.json

`data.json` is generated once from the parent repo's real outputs and
committed here. The generator and its source data (`runs/`, `dataset/`) live
one level up — see `../webapp/build_data.py`:

```bash
python ../webapp/build_data.py     # reads ../dataset, ../runs
                                    # writes ./data.json
```

## Deploying this folder to a Hugging Face Space

This folder *is* the Space — `sdk: static` in the frontmatter above means
Spaces serves `index.html`, `styles.css`, `app.js` and `data.json` directly,
no runtime, no secrets, no `GEMINI_API_KEY`.

```bash
huggingface-cli repo create message-router --type space --space_sdk static
git clone https://huggingface.co/spaces/<you>/message-router
cp hf/*.md hf/*.html hf/*.css hf/*.js hf/*.json message-router/
cd message-router && git add -A && git commit -m "deploy" && git push
```