Document HuggingBot modules space

README.md

@@ -1,10 +1,42 @@
 ---
-title: Huggingbot Modules
-emoji: 📉
-colorFrom: indigo
-colorTo: pink
+title: HuggingBot Modules
+emoji: 🧩
+colorFrom: green
+colorTo: indigo
 sdk: static
-pinned: false
+pinned: true
+license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# HuggingBot Modules
+
+Curated, useful-only modules for **HuggingBot** — hosted here so they can be modified without touching the original `ChatSeed` source.
+
+## Included modules (useful only)
+
+| File | Verdict | Purpose |
+|---|---|---|
+| `modules_calculator.js` | ✅ useful | Precisely evaluates math expressions & unit conversions |
+| `modules_weather.js` | ✅ useful | Current weather + forecast via wttr.in |
+| `modules_news.js` | ✅ useful | News headlines from NYT/BBC/Reddit RSS |
+| `modules_timezone.js` | ✅ useful | Current time & timezone conversion |
+| `modules_image-gen.js` | ✅ useful | Image generation via Pollinations AI |
+| `modules_search.js` | ✅ useful | Browser-based web search & scrape |
+
+## Excluded (dumb / huge / internal / niche)
+
+- `modules_fun.js` — "dumb" jokes/entertainment
+- `modules_huggingface.js` — huge (70 KB), overlaps with core tools
+- `modules_wiki.js` — huge (85 KB), redundant
+- `modules_fs_bridge.js` — internal
+- `modules_qr.js`, `modules_dictionary.js`, `modules_password.js`, `modules_youtube.js` — niche/meh
+
+## Usage
+
+Point HuggingBot's **Modules Location** to:
+
+```
+https://broadfield-huggingbot-modules.static.hf.space/
+```
+
+The loader reads `modules_manifest.js`, then loads each module file as a `<script>` tag.