From 2b054d40f7106b997504fc1f7d84faa68b95be31 Mon Sep 17 00:00:00 2001
From: xhzeem <34074156+xhzeem@users.noreply.github.com>
Date: Thu, 11 Dec 2025 14:41:32 +0300
Subject: [PATCH] Added a quick start method based on prebuild images

---
 README.md                     |  25 +++++-
 docker-compose.standalone.yml | 152 ++++++++++++++++++++++++++++++++++
 2 files changed, 174 insertions(+), 3 deletions(-)
 create mode 100644 docker-compose.standalone.yml

diff --git a/README.md b/README.md
index ecf15c0ff..cbec9b506 100644
--- a/README.md
+++ b/README.md
@@ -17,13 +17,32 @@ Flowsint is still in early development and definetly needs the help of the commu
 
 Don't want to read ? Got it. Here's your install instructions:
 
-#### 1. Install pre-requisites
+### Quick Start (Recommended)
+
+#### 1. Install Docker
+- Install Docker for your platform
+
+#### 2. Download and run
+```bash
+# Download the standalone compose file
+wget https://raw.githubusercontent.com/reconurge/flowsint/main/docker-compose.standalone.yml
+docker compose -f docker-compose.standalone.yml up -d
+```
 
+That's it! No cloning, no building, no dependencies. Everything runs with pre-built images.
+
+**Access URLs:**
+- Frontend: http://localhost:5173
+- API: http://localhost:5001  
+- Neo4j UI: http://localhost:7474 (neo4j/flowsint123)
+
+### Development Setup
+
+#### 1. Install pre-requisites
 - Docker
 - Make
 
-#### 2. Run install command
-
+#### 2. Clone and build
 ```bash
 git clone https://github.com/reconurge/flowsint.git
 cd flowsint
diff --git a/docker-compose.standalone.yml b/docker-compose.standalone.yml
new file mode 100644
index 000000000..9def96af8
--- /dev/null
+++ b/docker-compose.standalone.yml
@@ -0,0 +1,152 @@
+name: flowsint-standalone
+
+services:
+  # PostgreSQL database
+  postgres:
+    image: postgres:15
+    container_name: flowsint-postgres
+    restart: always
+    environment:
+      POSTGRES_USER: flowsint
+      POSTGRES_PASSWORD: flowsint
+      POSTGRES_DB: flowsint
+    ports:
+      - "5433:5432"
+    volumes:
+      - pg_data:/var/lib/postgresql/data
+    networks:
+      - flowsint_network
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U flowsint"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      
+  # Redis for Celery & cache
+  redis:
+    image: redis:alpine
+    container_name: flowsint-redis
+    restart: always
+    ports:
+      - "6379:6379"
+    networks:
+      - flowsint_network
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  # Neo4j graph database
+  neo4j:
+    image: neo4j:5
+    container_name: flowsint-neo4j
+    restart: always
+    ports:
+      - "7474:7474"  # Web UI
+      - "7687:7687"  # Bolt
+    environment:
+      - NEO4J_AUTH=neo4j/flowsint123
+      - NEO4J_PLUGINS=["apoc"]
+      - NEO4J_apoc_export_file_enabled=true
+      - NEO4J_apoc_import_file_enabled=true
+      - NEO4J_apoc_import_file_use__neo4j__config=true
+    volumes:
+      - neo4j_data:/data
+      - neo4j_logs:/logs
+      - neo4j_import:/var/lib/neo4j/import
+      - neo4j_plugins:/plugins
+    networks:
+      - flowsint_network
+    healthcheck:
+      test: ["CMD-SHELL", "wget --no-verbose --tries=1 --spider http://localhost:7474 || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  # FastAPI Backend
+  api:
+    image: ghcr.io/reconurge/flowsint-api:latest
+    container_name: flowsint-api
+    restart: always
+    ports:
+      - "5001:5001"
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+    environment:
+      - DATABASE_URL=postgresql://flowsint:flowsint@postgres:5432/flowsint
+      - NEO4J_URI_BOLT=bolt://neo4j:7687
+      - NEO4J_USERNAME=neo4j
+      - NEO4J_PASSWORD=flowsint123
+      - AUTH_SECRET=dev-secret-change-in-production
+      - MASTER_VAULT_KEY_V1=dev-vault-key-change-in-production
+      - REDIS_URL=redis://redis:6379/0
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+      neo4j:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "curl -f http://localhost:5001/health || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - flowsint_network
+
+  # Celery Worker
+  celery:
+    image: ghcr.io/reconurge/flowsint-api:latest
+    container_name: flowsint-celery
+    restart: always
+    command: celery -A flowsint_core.core.celery worker --loglevel=info --pool=solo
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+    environment:
+      - DATABASE_URL=postgresql://flowsint:flowsint@postgres:5432/flowsint
+      - NEO4J_URI_BOLT=bolt://neo4j:7687
+      - NEO4J_USERNAME=neo4j
+      - NEO4J_PASSWORD=flowsint123
+      - MASTER_VAULT_KEY_V1=dev-vault-key-change-in-production
+      - REDIS_URL=redis://redis:6379/0
+      - SKIP_MIGRATIONS=true
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+      neo4j:
+        condition: service_healthy
+      api:
+        condition: service_healthy
+    networks:
+      - flowsint_network
+
+  # Frontend
+  app:
+    image: ghcr.io/reconurge/flowsint-app:latest
+    container_name: flowsint-app
+    restart: always
+    ports:
+      - "5173:5173"
+    environment:
+      - VITE_API_URL=http://localhost:5001
+    networks:
+      - flowsint_network
+    depends_on:
+      api:
+        condition: service_healthy
+
+networks:
+  flowsint_network:
+    name: flowsint_network
+    driver: bridge
+
+volumes:
+  pg_data:
+  neo4j_data:
+  neo4j_logs:
+  neo4j_import:
+  neo4j_plugins: