flowiseAI / README.md
KoalaFlow's picture
Upload 4 files
2846e91 verified
---
title: Flowise
last update: 21.05.2025
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 sleep/awaken cycles but will not restart or rebuild**.
---
## โš ๏ธ Do Not Edit or Restart or Rebuild โš ๏ธ
- ๐ŸšจAny code or README change deletes all your data.
- ๐ŸšจDo **not** commit any changes once youโ€™ve started using the Space.
- ๐Ÿšจ If you accidentally restart, all documents and work are lost
- ๐ŸšจIf you accidentally rebuild, all documents and work are lost.
- Rebuilds may also occur if Hugging Face updates backend infrastructure.
- โœ… **Back up your flows, credentials and any other 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