escribano 0.1.0 → 0.1.2

package/README.md

@@ -157,6 +157,10 @@ Uses VLM-first visual understanding, not OCR + text clustering. OCR fails for de
 brew install ollama whisper-cpp ffmpeg
 
 # MLX-VLM for frame analysis (Apple Silicon)
+# Using uv (recommended, faster)
+uv pip install mlx-vlm
+
+# Or using pip
 pip install mlx-vlm
 ```
 

package/dist/adapters/intelligence.mlx.adapter.js

@@ -13,7 +13,9 @@ import { spawn } from 'node:child_process';
 import { existsSync, unlinkSync } from 'node:fs';
 import { createConnection } from 'node:net';
 import { homedir } from 'node:os';
-import { resolve } from 'node:path';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
 const DEBUG_MLX = process.env.ESCRIBANO_VERBOSE === 'true';
 function debugLog(...args) {
     if (DEBUG_MLX) {
@@ -26,7 +28,7 @@ const DEFAULT_CONFIG = {
     batchSize: Number(process.env.ESCRIBANO_VLM_BATCH_SIZE) || 4,
     maxTokens: Number(process.env.ESCRIBANO_VLM_MAX_TOKENS) || 2000,
     socketPath: process.env.ESCRIBANO_MLX_SOCKET_PATH ?? '/tmp/escribano-mlx.sock',
-    bridgeScript: resolve(process.cwd(), 'scripts/mlx_bridge.py'),
+    bridgeScript: resolve(__dirname, '../../scripts/mlx_bridge.py'),
     startupTimeout: Number(process.env.ESCRIBANO_MLX_STARTUP_TIMEOUT) || 60000,
 };
 /**

package/dist/prerequisites.js

@@ -4,6 +4,9 @@
  * Checks for required dependencies and provides install instructions
  */
 import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
 const LLM_MODEL_TIERS = [
     { model: 'qwen3.5:27b', tier: 4, minRamGB: 32, label: 'best' },
     { model: 'qwen3:14b', tier: 3, minRamGB: 20, label: 'very good' },
@@ -125,18 +128,66 @@ function checkLLMModels() {
         installCommand: 'ollama pull qwen3:8b',
     };
 }
+function getPythonPath() {
+    if (process.env.ESCRIBANO_PYTHON_PATH) {
+        return process.env.ESCRIBANO_PYTHON_PATH;
+    }
+    if (process.env.VIRTUAL_ENV) {
+        return resolve(process.env.VIRTUAL_ENV, 'bin', 'python3');
+    }
+    const uvHomeVenv = resolve(homedir(), '.venv', 'bin', 'python3');
+    if (existsSync(uvHomeVenv)) {
+        return uvHomeVenv;
+    }
+    return 'python3';
+}
 function checkPythonPackage(packageName) {
+    const pythonPath = getPythonPath();
     try {
-        execSync(`python3 -c "import ${packageName}"`, {
+        execSync(`"${pythonPath}" -c "import ${packageName}"`, {
             encoding: 'utf-8',
             stdio: ['pipe', 'pipe', 'pipe'],
             timeout: 5000,
         });
-        return true;
+        return { found: true, pythonPath };
     }
     catch {
-        return false;
+        return { found: false };
+    }
+}
+function detectPipCommand() {
+    // Check for uv first (fastest, recommended)
+    try {
+        execSync('uv --version', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 3000,
+        });
+        return 'uv pip install mlx-vlm';
     }
+    catch { }
+    // Check for pip3
+    try {
+        execSync('pip3 --version', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 3000,
+        });
+        return 'pip3 install mlx-vlm';
+    }
+    catch { }
+    // Check for pip
+    try {
+        execSync('pip --version', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 3000,
+        });
+        return 'pip install mlx-vlm';
+    }
+    catch { }
+    // Fallback: python3 -m pip
+    return 'python3 -m pip install mlx-vlm';
 }
 export function checkPrerequisites() {
     const results = [];
@@ -187,7 +238,14 @@ export function checkPrerequisites() {
                 break;
             }
             case 'mlx-vlm': {
-                result.found = checkPythonPackage('mlx_vlm');
+                const check = checkPythonPackage('mlx_vlm');
+                result.found = check.found;
+                if (check.found && check.pythonPath) {
+                    result.notes = `via ${check.pythonPath}`;
+                }
+                else {
+                    result.installCommand = detectPipCommand();
+                }
                 break;
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "escribano",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "AI-powered session intelligence tool — turn screen recordings into structured work summaries",
   "main": "dist/index.js",
   "type": "module",