Update README.md

README.md

@@ -1,10 +1,48 @@
 ---
 title: Flowise
-emoji: 📚
-colorFrom: green
-colorTo: yellow
+emoji: 🚀
+colorFrom: gray
+colorTo: green
 sdk: docker
 pinned: false
 ---
+## 💾 Flowise on Hugging Face Spaces (with Chroma Persistence)
+This Space uses **Flowise with local Chroma DB and SQLite** to store your documents and
+chat history.
+> Once the container is running, access Flowise via the **App** tab above.
+### 📍 What gets saved?
+- **Uploaded documents and embeddings** → `/data/chroma`
+- **Chat history and upsert logs** → `/data/flowise.db`
+- **Configuration file** → `flowise.json`
+These are stored in a special folder called `/data` which survives restarts but **not**
+rebuilds.
+---
+## ⚠️ Do Not Edit or Rebuild
+- Any code or README change deletes all your data.
+- Do **not** commit changes once you’ve started using the Space.
+- If you accidentally rebuild, all documents and work are lost.
+- Rebuilds may also occur if Hugging Face updates backend infrastructure. Back up your data
+regularly.
+---
+## 🧱 How to Back Up Your Work
+### ✅ Recommended Method: Export from Flowise UI
+1. Open Flowise via the **App** tab.
+2. Click the purple gear icon (top right) in your flow.
+3. Choose **Export** to download the `.json` file to your device.
+4. Unfortunately, for full data backups, you need to use a paid Hugging Face plan and mount
+external storage.
+> Note: Runtime files (like `/data`) are not visible or downloadable from the Files tab in
+free-tier Docker Spaces.
+---
+## 💡 Tip for Teams
+- Back up your data **as soon as your bot is working**
+- Re-upload documents only if necessary — rebuilding means starting over
+---
+## 🛠 Version Info
+- This setup uses **Flowise version 3.0.0**
+- Compatibility may vary with later versions
+---
+## ℹ️ Reference
+Flowise Docs: https://docs.flowiseai.com/
+Hugging Face Space Settings: https://huggingface.co/docs/hub/spaces
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference