chore: upload README.md

README.md

@@ -1,13 +1,68 @@
 ---
-title: Vc Deal Flow Explorer
-emoji: 🦀
-colorFrom: gray
-colorTo: indigo
+title: VC Deal Flow Signal — Interactive Explorer
+emoji: 📊
+colorFrom: blue
+colorTo: green
 sdk: gradio
-sdk_version: 6.14.0
-python_version: '3.13'
+sdk_version: 5.40.0
 app_file: app.py
-pinned: false
+pinned: true
+license: mit
+short_description: GitHub velocity dashboard for 55 venture-backed startups
+tags:
+  - venture-capital
+  - github
+  - alternative-data
+  - dashboard
+  - panel-data
+  - finance
+  - startups
+datasets:
+  - the-data-nerd/vc-deal-flow-signal
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 📊 VC Deal Flow Signal — Interactive Explorer
+
+A Gradio dashboard built on the live public dataset [`the-data-nerd/vc-deal-flow-signal`](https://huggingface.co/datasets/the-data-nerd/vc-deal-flow-signal) — engineering-velocity signals across ~55 venture-backed startups in 20 sectors, four quarters of GitHub data.
+
+> **Why this exists.** Sustained engineering acceleration on GitHub tends to lead fundraise announcements by 6–12 weeks. The dataset is the panel; this Space is the lens.
+
+## What you can do here
+
+| Tab | Use it for |
+|---|---|
+| **Overview** | KPI strip, signal-type composition by quarter, latest top-10 movers |
+| **Sector heatmap** | Sector × Quarter average commit velocity — spot sector rotations |
+| **Top movers** | Filter on quarter, sector, stage, signal type — rank by Δ commit velocity |
+| **Startup drilldown** | Pick a startup, see its four-quarter trajectory and latest classification |
+| **Methodology & cite** | Hypothesis, classifier rules, BibTeX, Zenodo / SSRN / Kaggle / MCP links |
+
+## Data lineage
+
+- **Source:** GitHub REST API v3, sampled on a 14-day rolling window
+- **Classifier:** open-source MIT — [github.com/kindrat86/gitdealflow-signal-classifier](https://github.com/kindrat86/gitdealflow-signal-classifier)
+- **Methodology preprint:** [SSRN 6606558](https://ssrn.com/abstract=6606558)
+- **Concept DOI:** [10.5281/zenodo.19650919](https://doi.org/10.5281/zenodo.19650919)
+- **Version DOI (v1.0.0):** [10.5281/zenodo.19650920](https://doi.org/10.5281/zenodo.19650920)
+
+## Companion artefacts
+
+- **Chat-agent Space (DeepSeek + MCP):** [huggingface.co/spaces/the-data-nerd/vc-deal-flow-deepseek](https://huggingface.co/spaces/the-data-nerd/vc-deal-flow-deepseek)
+- **Production web app:** [signals.gitdealflow.com](https://signals.gitdealflow.com)
+- **Public MCP server:** [signals.gitdealflow.com/api/mcp/rpc](https://signals.gitdealflow.com/api/mcp/rpc)
+
+## Run it locally
+
+```bash
+git clone https://huggingface.co/spaces/the-data-nerd/vc-deal-flow-explorer
+cd vc-deal-flow-explorer
+pip install -r requirements.txt
+python app.py
+```
+
+## License
+
+- **Code (this Space):** MIT
+- **Data (the underlying dataset):** [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/)
+
+_Past acceleration does not guarantee future outcomes. This is alternative-data research, not investment advice._