README.md

---
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