Upload README.md with huggingface_hub

README.md

@@ -1,10 +1,31 @@
 ---
-title: Hub Flow
-emoji: 🚀
-colorFrom: green
-colorTo: blue
+title: hub-flow
+emoji: "⚡"
+colorFrom: yellow
+colorTo: gray
 sdk: static
 pinned: false
+license: apache-2.0
+short_description: Download pulse of the whole Hugging Face Hub — every model
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# hub-flow
+
+Download history, leaderboards and instant search for **every model on the
+Hugging Face Hub** — not just ours. The big sibling of
+[mindchain/model-flow](https://huggingface.co/spaces/mindchain/model-flow).
+
+## Data sources (all public & free)
+
+- **History, search, leaderboards, author pages:** the [model-pulse](https://modelpulse.ifsp.dev) open API
+  over [modelpulse/model-pulse-data](https://huggingface.co/datasets/modelpulse/model-pulse-data)
+  (which builds on [cfahlgren1/hub-stats](https://huggingface.co/datasets/cfahlgren1/hub-stats))
+- **"Right now" lists:** the public Hugging Face Hub API
+
+Many thanks to the model-pulse project for open-sourcing both the dataset and the API.
+hub-flow is an independent project and not affiliated with Hugging Face or model-pulse.
+
+## Stack
+
+React 19 + Tailwind v4 (Vite). Source in the source/ folder, built assets at the repo root.
+npm install && npm run build reproduces the deployment.