offgrid-ai 0.2.1 → 0.2.3

package/README.md

@@ -59,6 +59,7 @@ curl -fsSL https://raw.githubusercontent.com/eeshansrivastava89/offgrid-ai/main/
 
 | Backend | Type | Auto-detected |
 |---|---|---|
+| **LM Studio** | Visual model browser + CLI (`lms`) | ✓ models in `~/.lmstudio/models/` |
 | **llama.cpp** | Local server | ✓ GGUF models in `~/.lmstudio/models/` |
 | **llama.cpp MTP** | Local server (speculative decoding) | ✓ MTP detected from model metadata |
 | **Ollama** | Managed server | ✓ via `localhost:11434` |
@@ -70,7 +71,10 @@ When you run `offgrid-ai` for the first time on a fresh machine:
 
 1. **Homebrew** — Required. Offered to install if missing.
 2. **llama-server** — Required for GGUF models. Offered to install via Homebrew.
-3. **Model backend** — At least one is needed: LM Studio, Ollama, or oMLX.
+3. **Model backend** — At least one is needed (LM Studio recommended):
+   - **LM Studio** — visual model browser + `lms` CLI, download models with `lms get qwen/qwen3.5-9b`
+   - **Ollama** — models download on demand with `ollama pull`
+   - **oMLX** — Apple Silicon optimized
 4. **Models** — If no models found, tells you where to get them.
 
 Subsequent runs skip everything that's already installed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "offgrid-ai",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Privacy-first CLI for running local LLMs — discover, configure, run, benchmark",
   "author": "Eeshan Srivastava (https://eeshans.com)",
   "type": "module",

package/src/backends.mjs

@@ -57,20 +57,6 @@ export function backendFor(backendId) {
   return backend;
 }
 
-export function inferBackendId(modelOrProfile) {
-  const haystack = [
-    modelOrProfile?.path,
-    modelOrProfile?.modelPath,
-    modelOrProfile?.label,
-    modelOrProfile?.modelAlias,
-    modelOrProfile?.id,
-    modelOrProfile?.providerId,
-    modelOrProfile?.backend,
-  ].filter(Boolean).join(" ").toLowerCase();
-  if (haystack.includes("mtp")) return "llama-cpp-mtp";
-  return "llama-cpp";
-}
-
 export async function backendBinaryFor(backendId) {
   const backend = BACKENDS[backendId ?? "llama-cpp"];
   if (backend.type === "managed-server") return null;

package/src/cli.mjs

@@ -1,5 +1,5 @@
 import { homedir } from "node:os";
-import { existsSync, rmSync } from "node:fs";
+import { existsSync, statSync, rmSync, readFileSync, appendFileSync } from "node:fs";
 import { join } from "node:path";
 import { ensureDirs, findLlamaServer, hasHomebrew, DATA_DIR } from "./config.mjs";
 import { scanGgufModels } from "./scan.mjs";
@@ -76,23 +76,11 @@ export async function mainFlow() {
     return;
   }
 
-  // 4. Interactive: pick an action
+  // 6. Interactive: pick an action
   startInteractive("offgrid-ai");
   const prompt = createPrompt();
   try {
-    // Build items list
-    const items = [];
-
-    // Existing profiles (quick run)
-    if (profiles.length > 0) {
-      for (const profile of profiles) {
-        const running = await isProfileRunning(profile);
-        const backend = backendFor(profile.backend);
-        items.push({ type: "profile", profile, running });
-      }
-    }
-
-    // New GGUF models (auto-setup)
+    // Show what we found
     const profiledPaths = new Set(profiles.map((p) => p.modelPath).filter(Boolean));
     const newModels = ggufModels.filter((m) => !profiledPaths.has(m.path));
 
@@ -589,16 +577,45 @@ async function onboardFlow() {
       console.log(pc.dim("You need at least one model backend to use offgrid-ai.\n"));
 
       const backendChoice = await prompt.choice("Install a model backend?", [
+        { value: "lmstudio", label: "LM Studio (recommended)", hint: "brew install --cask lm-studio — visual model browser + CLI" },
         { value: "ollama", label: "Ollama", hint: "brew install ollama — models download on demand" },
-        { value: "lmstudio", label: "LM Studio", hint: "brew install --cask lm-studio — visual model browser" },
         { value: "omlx", label: "oMLX", hint: "brew tap jundot/omlx && brew install omlx — Apple Silicon optimized" },
+        { value: "all", label: "Install all three", hint: "LM Studio + Ollama + oMLX" },
         { value: "skip", label: "Skip for now", hint: "I'll set up models myself" },
-      ], "ollama");
+      ], "lmstudio");
 
       const { execFile } = await import("node:child_process");
       const { promisify } = await import("node:util");
 
-      if (backendChoice === "ollama") {
+      const ensureLmsOnPath = () => {
+        const lmsBin = join(homedir(), ".lmstudio", "bin");
+        if (!existsSync(join(lmsBin, "lms"))) return;
+        if (process.env.PATH.split(":").includes(lmsBin)) return;
+        process.env.PATH = `${lmsBin}:${process.env.PATH}`;
+        const profileFiles = [join(homedir(), ".zshrc"), join(homedir(), ".bash_profile")];
+        const line = `export PATH="$PATH:$HOME/.lmstudio/bin"`;
+        for (const f of profileFiles) {
+          if (!existsSync(f)) continue;
+          const content = readFileSync(f, "utf8");
+          if (content.includes(".lmstudio/bin")) continue;
+          appendFileSync(f, `\n${line}\n`);
+        }
+      };
+
+      if (backendChoice === "lmstudio") {
+        console.log(pc.cyan("Installing LM Studio via Homebrew..."));
+        try {
+          await promisify(execFile)("brew", ["install", "--cask", "lm-studio"], { stdio: "inherit" });
+          ensureLmsOnPath();
+          console.log(pc.green("✓ LM Studio installed"));
+          console.log(pc.yellow("\nDownload your first model:"));
+          console.log(pc.bold("  lms get qwen/qwen3.5-9b"));
+          console.log(pc.dim("Then run offgrid-ai again to pick and run a model."));
+        } catch (err) {
+          console.log(pc.red(`Failed to install LM Studio: ${err.message}`));
+          console.log(pc.dim("Download it manually from https://lmstudio.ai"));
+        }
+      } else if (backendChoice === "ollama") {
         console.log(pc.cyan("Installing Ollama via Homebrew..."));
         try {
           await promisify(execFile)("brew", ["install", "ollama"], { stdio: "inherit" });
@@ -616,16 +633,6 @@ async function onboardFlow() {
           console.log(pc.red(`Failed to install Ollama: ${err.message}`));
           console.log(pc.dim("Install it manually from https://ollama.com"));
         }
-      } else if (backendChoice === "lmstudio") {
-        console.log(pc.cyan("Installing LM Studio via Homebrew..."));
-        try {
-          await promisify(execFile)("brew", ["install", "--cask", "lm-studio"], { stdio: "inherit" });
-          console.log(pc.green("✓ LM Studio installed"));
-          console.log(pc.yellow("\nOpen LM Studio to browse and download models, then run offgrid-ai again."));
-        } catch (err) {
-          console.log(pc.red(`Failed to install LM Studio: ${err.message}`));
-          console.log(pc.dim("Download it manually from https://lmstudio.ai"));
-        }
       } else if (backendChoice === "omlx") {
         console.log(pc.cyan("Installing oMLX via Homebrew..."));
         try {
@@ -639,6 +646,48 @@ async function onboardFlow() {
           console.log(pc.red(`Failed to install oMLX: ${err.message}`));
           console.log(pc.dim("Install it manually: brew tap jundot/omlx && brew install omlx"));
         }
+      } else if (backendChoice === "all") {
+        let installed = [];
+        // LM Studio
+        console.log(pc.cyan("Installing LM Studio via Homebrew..."));
+        try {
+          await promisify(execFile)("brew", ["install", "--cask", "lm-studio"], { stdio: "inherit" });
+          ensureLmsOnPath();
+          installed.push("LM Studio");
+        } catch {
+          console.log(pc.yellow("LM Studio installation failed. Download from https://lmstudio.ai"));
+        }
+        // Ollama
+        console.log(pc.cyan("Installing Ollama via Homebrew..."));
+        try {
+          await promisify(execFile)("brew", ["install", "ollama"], { stdio: "inherit" });
+          installed.push("Ollama");
+        } catch {
+          console.log(pc.yellow("Ollama installation failed. Install manually from https://ollama.com"));
+        }
+        // oMLX
+        console.log(pc.cyan("Installing oMLX via Homebrew..."));
+        try {
+          await promisify(execFile)("brew", ["tap", "jundot/omlx", "https://github.com/jundot/omlx"], { stdio: "inherit" });
+          await promisify(execFile)("brew", ["install", "omlx"], { stdio: "inherit" });
+          installed.push("oMLX");
+        } catch {
+          console.log(pc.yellow("oMLX installation failed. Install manually: brew tap jundot/omlx && brew install omlx"));
+        }
+        if (installed.length > 0) {
+          console.log(pc.green(`\n✓ Installed: ${installed.join(", ")}`));
+          console.log(pc.yellow("Next steps — download your first model:"));
+          if (installed.includes("LM Studio")) {
+            console.log(pc.bold("  lms get qwen/qwen3.5-9b"));
+          }
+          if (installed.includes("Ollama")) {
+            console.log(pc.bold("  ollama pull gemma3:4b"));
+          }
+          if (installed.includes("oMLX")) {
+            console.log(pc.bold("  omlx start"));
+          }
+          console.log(pc.dim("Then run offgrid-ai again to pick and run a model."));
+        }
       } else {
         console.log(pc.dim("Run offgrid-ai again when you've set up a model backend."));
       }
@@ -657,7 +706,7 @@ async function uninstallCommand(argv) {
   if (!process.stdin.isTTY) {
     // Non-interactive: remove everything
     await removeDataDir();
-    removeSelf();
+    await removeSelf();
     return;
   }
 

package/src/ui.mjs

@@ -4,20 +4,6 @@ import pc from "picocolors";
 export { pc };
 export { pc as colors };
 
-export function printHelp() {
-  console.log(`${pc.bold("offgrid-ai")} — privacy-first local LLM runner\n`);
-  console.log("Usage:");
-  console.log("  offgrid-ai              Pick a model and run");
-  console.log("  offgrid-ai models       List profiles and models");
-  console.log("  offgrid-ai run [id]     Run a profile (start server + launch Pi)");
-  console.log("  offgrid-ai stop [id]    Stop a running server");
-  console.log("  offgrid-ai benchmark    Run a benchmark prompt");
-  console.log("");
-  console.log(pc.bold("Run modes (--with):"));
-  console.log("  pi        Launch Pi with the selected model (default)");
-  console.log("  server    Start server only, no harness");
-}
-
 export function formatBytes(bytes) {
   if (!Number.isFinite(bytes)) return "unknown";
   const units = ["B", "KB", "MB", "GB", "TB"];
@@ -63,15 +49,6 @@ function handleCancel(value) {
   return value;
 }
 
-export function relativeTime(date) {
-  const ms = Date.now() - date.getTime();
-  const abs = Math.abs(ms);
-  for (const [label, size] of [["day", 86400000], ["hour", 3600000], ["minute", 60000], ["second", 1000]]) {
-    if (abs >= size) { const v = Math.round(abs / size); return `${v} ${label}${v === 1 ? "" : "s"} ago`; }
-  }
-  return "just now";
-}
-
 export function renderRows(rows) {
   const width = Math.max(...rows.map(([key]) => pc.strip(String(key)).length));
   return rows.map(([key, value]) => {