README.md

---
title: MapToSelf Dashboard
emoji: 🗺️
colorFrom: indigo
colorTo: green
sdk: streamlit
sdk_version: "1.58.0"
python_version: "3.12"
app_file: app.py
pinned: false
---

# MapToSelf Public Stats

Public portfolio dashboard for MapToSelf.

This dashboard is designed for recruiters, employers and collaborators. It shows
only aggregated product statistics and does not expose private operational data.

## Privacy

The dashboard does not include:

- Telegram user IDs
- names
- birth dates or birth places
- prompts
- AI answers
- report text
- message text
- API keys
- costs
- provider or model internals

It reads only `public_stats.json`, which is generated from safe aggregate SQL
queries.

## Run Locally

```bash
pip install -r requirements.txt
streamlit run app.py
```

## Hugging Face Space

Create a Streamlit Space and upload:

- `app.py`
- `requirements.txt`
- `public_stats.json`

The Space does not need access to the production database.