voyageai-cli 1.33.0 → 1.33.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "voyageai-cli",
-  "version": "1.33.0",
+  "version": "1.33.2",
   "description": "CLI for Voyage AI embeddings, reranking, and MongoDB Atlas Vector Search",
   "_comment": "This package contains the CLI + web playground. The electron/ directory is excluded via .npmignore and distributed via GitHub Releases.",
   "bin": {
@@ -36,6 +36,7 @@
   },
   "scripts": {
     "test": "node --test test/**/*.test.js",
+    "prepare": "git config core.hooksPath scripts/hooks 2>/dev/null || true",
     "reset": "node scripts/reset.js",
     "version": "node scripts/sync-nano-version.js && git add src/nano/nano-bridge.py",
     "release": "./scripts/release.sh",

package/src/commands/doctor.js

@@ -23,6 +23,7 @@ const CHECKS = {
   llmConnection: { name: 'LLM API Connection', required: false },
   mongodb: { name: 'MongoDB Connection', required: false },
   pdfParse: { name: 'PDF Support (pdf-parse)', required: false },
+  nano: { name: 'Local Inference (voyage-4-nano)', required: false },
   config: { name: 'Configuration Files', required: false },
 };
 
@@ -441,6 +442,31 @@ async function fixPdfParse() {
   }
 }
 
+function checkNano() {
+  try {
+    const { checkPython, checkVenv, checkDeps, checkModel } = require('../nano/nano-health');
+    const python = checkPython();
+    if (!python.ok) {
+      return { ok: null, message: 'Python 3.10+ not found', hint: 'Run: vai nano setup' };
+    }
+    const venv = checkVenv();
+    if (!venv.ok) {
+      return { ok: null, message: 'Not set up', hint: 'Run: vai nano setup (one-time install — enables free local embeddings)' };
+    }
+    const deps = checkDeps();
+    if (!deps.ok) {
+      return { ok: null, message: 'Dependencies missing', hint: 'Run: vai nano setup' };
+    }
+    const model = checkModel();
+    if (!model.ok) {
+      return { ok: null, message: 'Model not downloaded', hint: 'Run: vai nano setup' };
+    }
+    return { ok: true, message: 'Ready (free local embeddings via voyage-4-nano)' };
+  } catch {
+    return { ok: null, message: 'Not set up', hint: 'Run: vai nano setup (one-time install — enables free local embeddings)' };
+  }
+}
+
 async function runDoctor(options = {}) {
   const { json, verbose, fix } = options;
 
@@ -460,6 +486,7 @@ async function runDoctor(options = {}) {
     { key: 'llmConnection', fn: checkLLMConnection },
     { key: 'mongodb', fn: checkMongoDB },
     { key: 'pdfParse', fn: checkPdfParse },
+    { key: 'nano', fn: checkNano },
     { key: 'config', fn: checkConfig },
   ];
 

package/src/lib/banner.js

@@ -66,6 +66,7 @@ function showQuickStart() {
   console.log(`    ${pc.cyan('$ vai embed "hello world"')}     Generate embeddings`);
   console.log(`    ${pc.cyan('$ vai models')}                  List available models`);
   console.log(`    ${pc.cyan('$ vai demo')}                    Interactive walkthrough`);
+  console.log(`    ${pc.cyan('$ vai nano setup')}              Enable free local embeddings`);
   console.log('');
   console.log(`  Run ${pc.cyan('vai <command> --help')} for detailed usage.`);
   console.log('');

package/src/lib/welcome.js

@@ -96,7 +96,7 @@ async function runWelcome(opts = {}) {
   console.log(pc.bold('  What to do next:\n'));
   console.log(`    ${pc.cyan('vai quickstart')}     Zero-to-search tutorial (2 min)`);
   console.log(`    ${pc.cyan('vai doctor')}         Verify your full setup`);
-  console.log(`    ${pc.cyan('vai init')}           Initialize a project config`);
+  console.log(`    ${pc.cyan('vai nano setup')}     Enable free local embeddings`);
   console.log(`    ${pc.cyan('vai embed "hello"')}  Generate your first embedding`);
   console.log('');
   console.log(pc.dim('  Run vai --help to see all commands.\n'));

package/src/nano/nano-bridge.py

@@ -14,7 +14,7 @@ Really wrestled with this... if you have better ideas, please let me know.
 import json
 import sys
 
-BRIDGE_VERSION = "1.33.0"
+BRIDGE_VERSION = "1.33.2"
 MODEL_NAME = "voyageai/voyage-4-nano"
 
 # Lazy-loaded on first embed request

package/src/playground/index.html

@@ -16388,19 +16388,37 @@ let chatSessionId = null;
 
 function updateHealthDots(config) {
   var dots = [
-    { id: 'healthDotOllama', available: config.ollamaAvailable },
-    { id: 'healthDotNano', available: config.nanoAvailable },
-    { id: 'healthDotApiKey', available: config.hasApiKey },
+    { id: 'healthDotOllama', available: config.ollamaAvailable,
+      tipAvail: 'Ollama: running', tipMissing: 'Ollama: not detected' },
+    { id: 'healthDotNano', available: config.nanoAvailable,
+      tipAvail: 'voyage-4-nano: ready',
+      tipMissing: 'voyage-4-nano: not set up — run "vai nano setup" in your terminal' },
+    { id: 'healthDotApiKey', available: config.hasApiKey,
+      tipAvail: 'API key: configured', tipMissing: 'API key: not set' },
   ];
   dots.forEach(function(d) {
     var el = document.getElementById(d.id);
     if (el) {
       el.className = 'health-dot ' + (d.available ? 'available' : 'unavailable');
-      el.title = d.available
-        ? el.id.replace('healthDot', '') + ': available'
-        : el.id.replace('healthDot', '') + ': not detected';
+      el.title = d.available ? d.tipAvail : d.tipMissing;
+      el.style.cursor = d.available ? '' : 'help';
     }
   });
+  // Show nano setup hint below embedding dropdown when nano is unavailable
+  var nanoHint = document.getElementById('nanoSetupHint');
+  if (!nanoHint) {
+    var embedRow = document.getElementById('healthDotNano');
+    if (embedRow && embedRow.parentElement) {
+      nanoHint = document.createElement('div');
+      nanoHint.id = 'nanoSetupHint';
+      nanoHint.style.cssText = 'font-size:11px;margin-top:4px;padding:6px 8px;border-radius:6px;background:rgba(239,68,68,0.08);border:1px solid rgba(239,68,68,0.15);';
+      nanoHint.innerHTML = '<span style="opacity:0.9">Free local embeddings available!</span> Run <code style="background:rgba(0,212,170,0.15);padding:1px 5px;border-radius:3px;font-size:10px;">vai nano setup</code> in your terminal to enable.';
+      embedRow.parentElement.parentElement.appendChild(nanoHint);
+    }
+  }
+  if (nanoHint) {
+    nanoHint.style.display = config.nanoAvailable ? 'none' : 'block';
+  }
   // Show API key row if no API key (so user sees the red dot and knows to add one)
   var apiKeyRow = document.getElementById('chatApiKeyRow');
   if (apiKeyRow && !config.hasApiKey) {