Upload 3 files

Dockerfile

@@ -0,0 +1,63 @@
+# ---------- Base image -----------------------------------------------------
+FROM node:18-slim
+
+# ---------- OS packages ----------------------------------------------------
+RUN apt-get update && apt-get install -y \
+    git python3 python3-pip build-essential \
+    libcairo2-dev libpango1.0-dev chromium curl \
+ && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# ---------- Environment ----------------------------------------------------
+ENV PUPPETEER_SKIP_DOWNLOAD=true \
+    PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium \
+    CHROMA_SERVER_CORS_ALLOW_ORIGINS='["*"]' \
+    PORT=7860 \
+    DATABASE_PATH=/data/.flowise \
+    LOG_PATH=/data/.flowise/logs \
+    TEMP_UPLOAD_DIR=/data/uploads \
+    CHROMA_URL=http://localhost:8000
+
+# ---------- Node & Python deps --------------------------------------------
+RUN npm install -g flowise@3.0.0
+
+# Chroma server 1.x (compatible with Flowise v2 API)
+RUN pip3 install numpy==1.26.4 --break-system-packages \
+ && pip3 install chromadb==1.0.9 --break-system-packages   # provides `chroma` CLI v2
+
+# ---------- Prevent Flowise early-log crash -------------------------------
+RUN mkdir -p /usr/local/lib/node_modules/flowise/logs \
+ && chmod -R 777 /usr/local/lib/node_modules/flowise
+
+# ---------- Persistent data directories -----------------------------------
+WORKDIR /data
+RUN mkdir -p /data/.flowise/logs /data/.flowise/storage /data/uploads /data/chroma \
+ && chmod -R 777 /data \
+ && chown -R 1000:1000 /data
+ENV PATH=$PATH:/home/node/.local/bin:/usr/local/bin:/root/.local/bin
+USER 1000:1000
+
+# ---------- Expose ports ---------------------------------------------------
+EXPOSE 7860 8000
+
+# ---------- Start: Chroma ➜ wait ➜ Flowise ---------------------------------
+CMD sh -c 'set -x; \
+  chroma run \
+    --path /data/chroma \
+    --host 0.0.0.0 \
+    --port 8000 \
+  & \
+  echo "--- Waiting for Chroma API ---"; \
+  while ! curl -v http://localhost:8000/api/v2/heartbeat; do \
+    echo "[DEBUG] Chroma not ready yet. Retrying..."; \
+    netstat -tulnp || ss -tulnp || true; \
+    sleep 1; \
+  done; \
+  echo "--- Chroma API is up ---"; \
+  echo "[DEBUG] Testing Chroma collections endpoint:"; \
+  curl -v http://localhost:8000/api/v2/collections || true; \
+  echo "[DEBUG] Environment variables:"; \
+  printenv | grep CHROMA || true; \
+  echo "[DEBUG] Process list:"; \
+  ps aux; \
+  echo "[DEBUG] Flowise will start now."; \
+  npx flowise start'

README.md

@@ -1,10 +1,67 @@
----
-title: Flowise2
-emoji: 🌍
-colorFrom: yellow
-colorTo: yellow
-sdk: docker
-pinned: false
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+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 

flowise.json

@@ -0,0 +1,12 @@
+{
+    "port": 7860,
+    "flowiseUsername": "admin",
+    "flowisePassword": "admin",
+    "databasePath": "/data/.flowise",
+    "logPath": "/data/.flowise/logs",
+    "tempUploadDir": "/data/uploads",
+    "chroma": {
+    "mode": "remote",
+    "url": "http://localhost:8000"
+    }
+}