videonut 1.2.2 → 1.2.4

package/README.md

@@ -53,8 +53,43 @@ VideoNut transforms your ideas into **production-ready YouTube documentaries** u
 
 ## 📦 Quick Install
 
-### Prerequisites
-- **Node.js 16+** - [Download here](https://nodejs.org) 
+### ⚠️ Prerequisites: Install Node.js First
+
+VideoNut requires **Node.js 18+** to run. Choose one method to install:
+
+<details>
+<summary><b>📥 Option A: Download from Website (Easiest)</b></summary>
+
+1. Go to **[nodejs.org](https://nodejs.org)**
+2. Download the **LTS version** (recommended)
+3. Run the installer and follow the prompts
+4. Restart your computer
+5. Verify installation: `node --version` and `npm --version`
+
+</details>
+
+<details>
+<summary><b>💻 Option B: Install via Command Line</b></summary>
+
+**Windows (PowerShell as Administrator):**
+```powershell
+winget install OpenJS.NodeJS.LTS
+```
+
+**macOS:**
+```bash
+brew install node
+```
+
+**Linux (Ubuntu/Debian):**
+```bash
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
+```
+
+</details>
+
+---
 
 ### Option 1: NPX (Recommended)
 ```bash

package/bin/videonut.js

@@ -477,14 +477,38 @@ async function runInit() {
     // ═══════════════════════════════════════════════════════════════
     header('Step 6/6: Final Setup');
 
-    // Create a launch script
+    // Create paths for local tools
+    const localPythonPath = path.join(videoNutDir, 'python');
+    const localToolsPath = path.join(videoNutDir, 'tools', 'bin');
+
+    // Create a launch script that adds local Python and FFmpeg to PATH
     const launchScriptContent = isWindows
         ? `@echo off
-echo Starting VideoNut with ${selectedCli || 'your CLI'}...
+REM Add local Python and FFmpeg to PATH for this session
+set PATH=${localPythonPath};${localPythonPath}\\Scripts;${localToolsPath};%PATH%
+
+echo.
+echo ====================================
+echo   VideoNut Environment Ready!
+echo   Python: ${localPythonPath}
+echo   FFmpeg: ${localToolsPath}
+echo ====================================
+echo.
+echo Starting ${selectedCli || 'your CLI'}...
 ${selectedCli || 'gemini'}
 `
         : `#!/bin/bash
-echo "Starting VideoNut with ${selectedCli || 'your CLI'}..."
+# Add local Python and FFmpeg to PATH for this session
+export PATH="${localPythonPath}:${localPythonPath}/bin:${localToolsPath}:$PATH"
+
+echo ""
+echo "===================================="
+echo "  VideoNut Environment Ready!"
+echo "  Python: ${localPythonPath}"
+echo "  FFmpeg: ${localToolsPath}"
+echo "===================================="
+echo ""
+echo "Starting ${selectedCli || 'your CLI'}..."
 ${selectedCli || 'gemini'}
 `;
 
@@ -494,6 +518,7 @@ ${selectedCli || 'gemini'}
         execSync(`chmod +x "${launchScriptPath}"`);
     }
     success(`Created launch script: ${path.basename(launchScriptPath)}`);
+    info('Use this script to start with Python & FFmpeg in PATH!');
 
     // ═══════════════════════════════════════════════════════════════
     // INSTALLATION COMPLETE!

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "videonut",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "AI-powered YouTube documentary production pipeline with 10 specialized agents for research, scripting, and asset management",
   "keywords": [
     "youtube",