flowise / README.md
rickysk's picture
Update README.md
6e45129 verified
---
title: Flowise
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