diff --git a/README.md b/README.md
index d18727a..e5c56a8 100644
--- a/README.md
+++ b/README.md
@@ -336,10 +336,13 @@ Every image you upload is saved locally (URL + thumbnail) so you never upload th
 ### Setup
 
 ```bash
-# Clone the repository
-git clone https://github.com/Anil-matcha/Open-Generative-AI.git
+# Clone the repository (with submodules — required for the workflow + agent packages)
+git clone --recurse-submodules https://github.com/Anil-matcha/Open-Generative-AI.git
 cd Open-Generative-AI
 
+# If you already cloned without --recurse-submodules, run this once:
+# git submodule update --init --recursive
+
 # Install dependencies (installs root + packages/studio workspace)
 npm install
 
diff --git a/package.json b/package.json
index 89b976d..91bb065 100644
--- a/package.json
+++ b/package.json
@@ -17,7 +17,7 @@
     "build:workflow": "npm run build -w workflow-builder",
     "build:agent": "npm run build -w ai-agent",
     "build:packages": "npm run build:workflow && npm run build:agent && npm run build:studio",
-    "setup": "npm install && npm run build:packages",
+    "setup": "git submodule update --init --recursive && npm install && npm run build:packages",
     "vite:dev": "vite",
     "vite:build": "vite build",
     "electron:dev": "npm run vite:build && electron .",