alvin-bot 4.7.0 → 4.8.1

package/CHANGELOG.md

@@ -2,6 +2,63 @@
 
 All notable changes to Alvin Bot are documented here.
 
+## [4.8.1] — 2026-04-11
+
+### 🐛 Offline setup: Homebrew preferred on macOS
+
+Caught during the first real run of the new offline setup wizard on a fresh test MacBook: the official Ollama `install.sh` script on macOS wants to drop `Ollama.app` into `/Applications` and start it as a GUI app. That requires a real user session with sudo and completely breaks over SSH or any non-interactive context. The install downloads the 25 MB .app, then fails at `Unable to find application named 'Ollama'` and drops the wizard back to the fallback provider picker.
+
+Fix in `bin/cli.js` `installOllama()`:
+
+- **macOS preferred path**: if Homebrew is available (`brew --version` succeeds), use `brew install ollama`. Brew installs `/opt/homebrew/bin/ollama` as a CLI binary with no sudo prompt, no /Applications drop, no GUI dependency — works over SSH and in any CI/non-interactive context.
+- **Fallback**: if brew is not installed or `brew install` itself fails, fall through to the official `install.sh` with an explicit heads-up that the installer may prompt for admin password and may only work in a local terminal.
+- **Better error messaging**: on macOS install failure, suggest `brew install ollama` or the `.dmg` from ollama.com/download as alternatives. On Linux, unchanged.
+
+Linux always uses `install.sh` — systemd user units work non-interactively there.
+
+## [4.8.0] — 2026-04-11
+
+### ✨ Offline mode — Gemma 4 E4B via Ollama in the setup wizard
+
+Fresh installs on a machine without any AI-provider key can now pick **Offline mode** as the first option in the setup wizard. It runs **Google Gemma 4 E4B** locally via Ollama — no API key, zero running cost, works 100% offline once downloaded.
+
+New in `bin/cli.js`:
+
+- `PROVIDERS[0]` is now `offline-gemma4`, labeled prominently with the `~10 GB one-time download` so users can't miss the size.
+- `setupOfflineGemma4()` helper walks the user through:
+  1. **Warning** about download size (15–70 min depending on connection) and on-disk footprint (~10 GB in `~/.ollama/models`)
+  2. **Confirmation prompt** — if the user declines, the wizard loops back to the normal provider picker (no dead ends)
+  3. **Ollama install** via the official `curl -fsSL https://ollama.com/install.sh | sh` if the `ollama` binary is missing
+  4. **Daemon check** — ensures Ollama is listening, spawns it in the background if not
+  5. **Cache check** — if `gemma4:e4b` is already pulled, skips the download
+  6. **Model pull** with a second confirmation before the 10 GB actually starts, streaming progress output so the user sees every layer land
+- `.env` gets `PRIMARY_PROVIDER=ollama`. The registry's Ollama preset in `src/providers/types.ts` already defaults to `gemma4:e4b`, so no extra environment variable is needed.
+
+macOS + Linux only. Windows users get pointed at https://ollama.com/download.
+
+### ✨ `/version` command + version display in `/status`
+
+- New `/version` command in both **Telegram** and **TUI**. Shows `Alvin Bot vX.Y.Z · Node vN · platform/arch`. Registered in `setMyCommands` so Telegram shows it in the autocomplete menu.
+- `/status` header on Telegram now reads `🤖 Alvin Bot vX.Y.Z` instead of just `Alvin Bot Status`.
+- TUI `/status` header also carries the version.
+- **Bug fix**: `/api/status` used to hard-code `version: "3.0.0"` (a leftover from v3). It now reads `BOT_VERSION` dynamically, so the TUI and Web UI see the actual running version.
+
+Implementation: new `src/version.ts` module reads `package.json` once at module load, exports `BOT_VERSION` as a const. Path resolution uses `import.meta.url` so the cwd can't break it.
+
+### 🐛 `alvin-bot launchd install` preserves other pm2 projects
+
+The initial 4.7.0 release called `pm2 kill` during `launchd install` to stop the pm2 daemon. That's wrong for users who have **other** pm2-managed projects (e.g. `polyseus`) alongside `alvin-bot` — their other work would go down with the switch.
+
+New behavior in `bin/cli.js`:
+
+- Parse `pm2 jlist` JSON to detect (a) whether `alvin-bot` is pm2-managed and (b) whether any other pm2 projects exist.
+- Only run `pm2 delete alvin-bot` — never `pm2 kill`. The daemon keeps running for the other projects.
+- Post-install hint is smarter:
+  - **pm2 now empty** → *"pm2 now has zero managed processes. Remove it with: `npm uninstall -g pm2`"*
+  - **pm2 still has other projects** → *"pm2 still has other projects running — leaving it installed."*
+
+Caught immediately after 4.7.0 shipped when Ali pointed out his Mac mini has `polyseus` in pm2 alongside `alvin-bot` and didn't want it touched.
+
 ## [4.7.0] — 2026-04-11
 
 ### ✨ Sub-Agents Stufe 2 — live-stream, bounded queue, 24h stats

package/bin/cli.js

@@ -54,6 +54,17 @@ const LOGO = `
 // ── Provider Definitions ────────────────────────────────────────────────────
 
 const PROVIDERS = [
+  {
+    key: "offline-gemma4",
+    name: "🔒 Offline — Gemma 4 E4B (no API key, ~10 GB one-time download)",
+    desc: () => "Works without internet. Runs Google Gemma 4 E4B locally via Ollama. Big first-time download, zero running cost, works forever offline.",
+    free: true,
+    envKey: null,
+    signup: null,
+    model: "gemma4:e4b",
+    needsCLI: false,
+    offline: true,
+  },
   {
     key: "groq",
     name: "Groq (Llama 3.3 70B)",
@@ -117,6 +128,216 @@ const PROVIDERS = [
   },
 ];
 
+// ── Offline mode: Ollama + Gemma 4 E4B ─────────────────────────────────────
+
+/**
+ * Check whether the `ollama` binary is present on PATH.
+ */
+function hasOllama() {
+  try {
+    execSync("ollama --version", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check whether Homebrew is available on PATH (macOS only path normally).
+ */
+function hasBrew() {
+  try {
+    execSync("brew --version", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Install Ollama. On macOS prefers `brew install ollama` because the
+ * official install.sh wants to drop Ollama.app into /Applications and
+ * start it as a GUI app — that needs a real user session with sudo and
+ * breaks over SSH or in any non-interactive context.
+ *
+ * Linux always uses the official install.sh (systemd user services work
+ * non-interactively).
+ *
+ * Returns true on success, false on failure.
+ */
+function installOllama() {
+  if (process.platform !== "darwin" && process.platform !== "linux") {
+    console.log("  ❌ Offline mode only supported on macOS and Linux.");
+    console.log("     Windows users: download from https://ollama.com/download");
+    return false;
+  }
+
+  // macOS preferred path: Homebrew (non-interactive, no sudo, no GUI dependency)
+  if (process.platform === "darwin" && hasBrew()) {
+    console.log("\n📥 Installing Ollama via Homebrew (non-interactive)...");
+    try {
+      execSync("brew install ollama", {
+        stdio: "inherit",
+        timeout: 300_000,
+      });
+      if (hasOllama()) {
+        console.log("  ✅ Ollama installed via Homebrew");
+        return true;
+      }
+      console.log("  ⚠️  Homebrew finished but `ollama` not on PATH yet.");
+    } catch (err) {
+      console.log(`\n  ⚠️  brew install ollama failed: ${err.message || err}`);
+      console.log("     Falling back to the official install.sh — this may need sudo and a GUI session.\n");
+    }
+  }
+
+  // Fallback: official installer
+  console.log("\n📥 Installing Ollama (official installer)...");
+  if (process.platform === "darwin") {
+    console.log("  ⚠️  Heads-up: on macOS the installer drops Ollama.app into");
+    console.log("     /Applications and wants to start it — this may prompt for");
+    console.log("     your admin password and only works in a local terminal,");
+    console.log("     not over SSH.\n");
+  }
+  try {
+    execSync("curl -fsSL https://ollama.com/install.sh | sh", {
+      stdio: "inherit",
+      timeout: 300_000,
+    });
+    return hasOllama();
+  } catch (err) {
+    console.log(`\n  ❌ Ollama install failed: ${err.message || err}`);
+    if (process.platform === "darwin") {
+      console.log("     On macOS, try one of:");
+      console.log("       • brew install ollama    (recommended)");
+      console.log("       • download the .dmg from https://ollama.com/download");
+    } else {
+      console.log("     Try manually: curl -fsSL https://ollama.com/install.sh | sh");
+    }
+    return false;
+  }
+}
+
+/**
+ * Ensure the Ollama daemon is running. Spawns it in the background if not.
+ */
+function ensureOllamaServe() {
+  try {
+    // 'ollama list' needs the daemon running
+    execSync("ollama list", { stdio: "pipe", timeout: 5000 });
+    return true;
+  } catch {
+    // Daemon not running — spawn it
+    try {
+      execSync("nohup ollama serve > /tmp/ollama-setup.log 2>&1 &", {
+        stdio: "pipe",
+        shell: "/bin/sh",
+      });
+      // Give it a moment
+      execSync("sleep 2", { stdio: "pipe" });
+      execSync("ollama list", { stdio: "pipe", timeout: 5000 });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+
+/**
+ * Check whether gemma4:e4b is already pulled into Ollama's model cache.
+ */
+function hasGemma4E4b() {
+  try {
+    const out = execSync("ollama list", { encoding: "utf-8", timeout: 5000 });
+    return /gemma4[:\s].*e4b/i.test(out);
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Pull gemma4:e4b from the Ollama registry. Streams progress to stdout.
+ * Returns true on success, false on failure.
+ */
+function pullGemma4E4b() {
+  console.log("\n📥 Downloading gemma4:e4b (~10 GB — this can take 10-30 min)...\n");
+  try {
+    execSync("ollama pull gemma4:e4b", {
+      stdio: "inherit",
+      timeout: 45 * 60_000, // 45 minutes
+    });
+    return hasGemma4E4b();
+  } catch (err) {
+    console.log(`\n  ❌ Pull failed: ${err.message || err}`);
+    return false;
+  }
+}
+
+/**
+ * Full offline-mode setup flow: warn about download size, confirm, install
+ * Ollama if missing, pull the model, verify. Returns true on success,
+ * false if the user bailed or something broke (caller falls back to
+ * interactive provider selection).
+ */
+async function setupOfflineGemma4() {
+  console.log("\n  ⚠️  Offline mode uses Google Gemma 4 E4B via Ollama.");
+  console.log("     • One-time download: ~10 GB");
+  console.log("     • On a 100 Mbps connection: ~15 minutes");
+  console.log("     • On a 20 Mbps connection: ~70 minutes");
+  console.log("     • Disk usage: ~10 GB in ~/.ollama/models");
+  console.log("     • Runs on CPU + GPU via Metal (macOS) / CUDA (Linux)");
+  console.log("     • Works 100% offline once downloaded\n");
+
+  const yesChars = getLocale() === "de" ? ["j", "ja", "y", "yes"] : ["y", "yes"];
+  const proceed = (await ask("  Continue with offline mode? (y/N): ")).trim().toLowerCase();
+  if (!yesChars.includes(proceed)) {
+    console.log("\n  ℹ️  Offline mode declined — returning to provider selection.\n");
+    return false;
+  }
+
+  // Step 1: Ollama binary
+  if (!hasOllama()) {
+    console.log("\n  ℹ️  Ollama not installed.");
+    const installProceed = (await ask("  Install Ollama now? (y/N): ")).trim().toLowerCase();
+    if (!yesChars.includes(installProceed)) {
+      console.log("\n  ℹ️  Offline mode cancelled — Ollama is required.\n");
+      return false;
+    }
+    if (!installOllama()) return false;
+    console.log("  ✅ Ollama installed");
+  } else {
+    console.log("\n  ✅ Ollama already installed");
+  }
+
+  // Step 2: Ensure daemon is running
+  if (!ensureOllamaServe()) {
+    console.log("\n  ⚠️  Could not start Ollama daemon. Try manually:");
+    console.log("     ollama serve");
+    console.log("     (in a separate terminal, then re-run alvin-bot setup)\n");
+    return false;
+  }
+  console.log("  ✅ Ollama daemon responding");
+
+  // Step 3: Model already present?
+  if (hasGemma4E4b()) {
+    console.log("  ✅ gemma4:e4b already downloaded — skipping pull");
+    return true;
+  }
+
+  // Step 4: Pull the model (big download)
+  console.log("\n  📦 gemma4:e4b not in cache yet.");
+  const pullProceed = (await ask("  Start 10 GB download now? (y/N): ")).trim().toLowerCase();
+  if (!yesChars.includes(pullProceed)) {
+    console.log("\n  ℹ️  Pull cancelled. You can run this later:");
+    console.log("     ollama pull gemma4:e4b\n");
+    return false;
+  }
+
+  if (!pullGemma4E4b()) return false;
+  console.log("\n  ✅ gemma4:e4b downloaded and ready\n");
+  return true;
+}
+
 // ── Provider Validation ────────────────────────────────────────────────────
 
 /**
@@ -594,6 +815,32 @@ async function setup() {
 
   console.log(`\n✅ ${t("setup.providerSelected")} ${provider.name}`);
 
+  // ── Offline mode: Gemma 4 E4B via Ollama ────────────────────────
+  // Handled specially because it needs a 10 GB model download, not an
+  // API key. If the user bails out anywhere in the flow, we loop back
+  // to the normal provider picker so setup isn't a dead-end.
+  if (provider.offline) {
+    const ok = await setupOfflineGemma4();
+    if (!ok) {
+      // User declined or something failed — pick a different provider
+      console.log(`\n  Choose a different provider:\n`);
+      for (let i = 0; i < PROVIDERS.length; i++) {
+        if (PROVIDERS[i].offline) continue;
+        const p = PROVIDERS[i];
+        const badge = p.free ? "🆓" : "💰";
+        const premium = p.needsCLI ? " ⭐" : "";
+        console.log(`  ${i + 1}. ${badge} ${p.name}${premium}`);
+      }
+      console.log("");
+      const fallbackChoice = parseInt((await ask(t("setup.yourChoice"))).trim()) || 2;
+      provider = PROVIDERS[Math.max(1, Math.min(fallbackChoice - 1, PROVIDERS.length - 1))];
+      console.log(`\n✅ ${t("setup.providerSelected")} ${provider.name}`);
+    }
+    // Note: if setupOfflineGemma4 succeeded, we skip further API-key
+    // validation below — offline mode doesn't need a key. The .env
+    // write step reads provider.offline and sets PRIMARY_PROVIDER=ollama.
+  }
+
   // ── Validate Provider ────────────────────────────────────────────
 
   // Claude SDK: show requirements upfront
@@ -803,13 +1050,17 @@ async function setup() {
   // ── Write .env
   console.log(`\n${t("setup.writingConfig")}`);
 
+  // Offline mode translates to PRIMARY_PROVIDER=ollama — the registry's
+  // ollama preset already points at gemma4:e4b, so no extra env needed.
+  const primaryKey = provider.offline ? "ollama" : provider.key;
+
   const envLines = [
     "# === Telegram ===",
     `BOT_TOKEN=${botToken || ""}`,
     `ALLOWED_USERS=${userId || ""}`,
     "",
     "# === AI Provider ===",
-    `PRIMARY_PROVIDER=${provider.key}`,
+    `PRIMARY_PROVIDER=${primaryKey}`,
   ];
 
   if (provider.envKey && providerApiKey) {
@@ -1261,6 +1512,32 @@ async function launchdInstall() {
     execSync(`launchctl unload -w "${plistPath}"`, { stdio: "pipe" });
   } catch { /* not loaded yet — fine */ }
 
+  // If pm2 is managing an alvin-bot process, tear that one process down.
+  // We deliberately do NOT `pm2 kill` the whole daemon — the user may
+  // have other pm2-managed projects (polyseus, etc.) and we must not
+  // nuke those. Only the alvin-bot entry is removed.
+  let pm2HadAlvinBot = false;
+  let pm2StillHasOtherProcesses = false;
+  try {
+    execSync("pm2 --version", { stdio: "pipe" });
+    // Check whether alvin-bot is currently pm2-managed
+    try {
+      const lsOut = execSync("pm2 jlist", { stdio: ["pipe", "pipe", "pipe"], encoding: "utf-8" });
+      const procs = JSON.parse(lsOut);
+      if (Array.isArray(procs)) {
+        pm2HadAlvinBot = procs.some((p) => p && p.name === "alvin-bot");
+        pm2StillHasOtherProcesses = procs.some((p) => p && p.name !== "alvin-bot");
+      }
+    } catch { /* pm2 jlist can fail on empty list or missing daemon — ignore */ }
+
+    if (pm2HadAlvinBot) {
+      try {
+        execSync("pm2 delete alvin-bot", { stdio: "pipe" });
+        console.log("🧹 Removed alvin-bot from pm2 (other pm2 projects left intact).");
+      } catch { /* already gone */ }
+    }
+  } catch { /* pm2 not installed — nothing to clean up */ }
+
   // Stop any nohup'd bot that might still be running
   try {
     execSync(`pkill -TERM -f 'node.*dist/index.js' || true`, { stdio: "pipe" });
@@ -1289,6 +1566,14 @@ async function launchdInstall() {
   console.log("   the macOS Keychain is automatically unlocked — Claude Code");
   console.log("   OAuth tokens (Max subscription) just work, no SSH keychain");
   console.log("   dance needed anymore.");
+  if (pm2HadAlvinBot && !pm2StillHasOtherProcesses) {
+    console.log("");
+    console.log("💡 pm2 now has zero managed processes. You can remove it entirely:");
+    console.log("      npm uninstall -g pm2");
+  } else if (pm2HadAlvinBot && pm2StillHasOtherProcesses) {
+    console.log("");
+    console.log("💡 pm2 still has other projects running — leaving it installed.");
+  }
   process.exit(0);
 }
 

package/dist/handlers/commands.js

@@ -18,6 +18,7 @@ import { screenshotUrl, extractText, generatePdf, hasPlaywright } from "../servi
 import { listJobs, createJob, deleteJob, toggleJob, runJobNow, formatNextRun, humanReadableSchedule } from "../services/cron.js";
 import { storePassword, revokePassword, getSudoStatus, verifyPassword } from "../services/sudo.js";
 import { config } from "../config.js";
+import { BOT_VERSION } from "../version.js";
 import { getWebPort } from "../web/server.js";
 import { getUsageSummary, getAllRateLimits, formatTokens } from "../services/usage-tracker.js";
 import { runUpdate, getAutoUpdate, setAutoUpdate, startAutoUpdateLoop } from "../services/updater.js";
@@ -141,6 +142,7 @@ export function registerCommands(bot) {
         { command: "effort", description: "Set reasoning depth" },
         { command: "voice", description: "Voice replies on/off" },
         { command: "status", description: "Current status" },
+        { command: "version", description: "Show Alvin Bot version" },
         { command: "new", description: "Start new session" },
         { command: "dir", description: "Change working directory" },
         { command: "web", description: "Quick web search" },
@@ -219,6 +221,10 @@ export function registerCommands(bot) {
             await ctx.reply(`Directory not found: ${resolved}`);
         }
     });
+    bot.command("version", async (ctx) => {
+        await ctx.reply(`🤖 *Alvin Bot* \`v${BOT_VERSION}\`\n` +
+            `Node ${process.version} · ${process.platform}/${process.arch}`, { parse_mode: "Markdown" });
+    });
     bot.command("status", async (ctx) => {
         const userId = ctx.from.id;
         const session = getSession(userId);
@@ -371,7 +377,7 @@ export function registerCommands(bot) {
             const failoverBadge = failedOver ? ` ${t("bot.status.failedOver", lang)}` : "";
             healthLines = `\n${t("bot.status.providerHealth", lang)}${failoverBadge}\n${rows.join("\n")}\n`;
         }
-        await ctx.reply(`🤖 *Alvin Bot Status*\n\n` +
+        await ctx.reply(`🤖 *Alvin Bot* \`v${BOT_VERSION}\`\n\n` +
             `*Model:* ${info.name} ${providerTag}\n` +
             `*Effort:* ${EFFORT_LABELS[session.effort]}\n` +
             `*Voice:* ${session.voiceReply ? "on" : "off"}\n` +

package/dist/tui/index.js

@@ -20,6 +20,7 @@ import { createInterface, cursorTo, clearLine as rlClearLine } from "readline";
 import WebSocket from "ws";
 import http from "http";
 import { initI18n, t } from "../i18n.js";
+import { BOT_VERSION } from "../version.js";
 // Init i18n before anything else
 initI18n();
 // ── ANSI Colors & Styles ────────────────────────────────
@@ -410,11 +411,17 @@ async function handleCommand(cmd) {
             }
             break;
         }
+        case "version":
+        case "v": {
+            console.log(`\n${C.bold}${C.brightCyan}🤖 Alvin Bot${C.reset} ${C.dim}v${BOT_VERSION}${C.reset}`);
+            console.log(`${C.dim}Node ${process.version} · ${process.platform}/${process.arch}${C.reset}\n`);
+            break;
+        }
         case "status":
         case "s": {
             try {
                 const data = await apiGet("/api/status");
-                console.log(`\n${C.bold}${C.brightCyan}${t("status.title")}${C.reset}`);
+                console.log(`\n${C.bold}${C.brightCyan}🤖 Alvin Bot${C.reset} ${C.dim}v${BOT_VERSION}${C.reset}`);
                 console.log(`${C.gray}${"─".repeat(40)}${C.reset}`);
                 if (data.model) {
                     console.log(`  ${C.cyan}${t("status.model")}${C.reset}    ${data.model.model || data.model.name || "?"}`);

package/dist/version.js

@@ -0,0 +1,24 @@
+/**
+ * Central source of truth for the running Alvin Bot version.
+ * Read from package.json once at module load — subsequent imports
+ * return the cached string without touching disk.
+ */
+import { readFileSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+function readVersion() {
+    try {
+        // dist/version.js is two levels deep; package.json sits at the root
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkgPath = resolve(here, "..", "package.json");
+        const raw = readFileSync(pkgPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.version === "string")
+            return parsed.version;
+    }
+    catch {
+        /* fall through to unknown */
+    }
+    return "unknown";
+}
+export const BOT_VERSION = readVersion();

package/dist/web/server.js

@@ -29,6 +29,7 @@ import { handleOpenAICompat } from "./openai-compat.js";
 import { addCanvasClient } from "./canvas.js";
 import { BOT_ROOT, ENV_FILE, PUBLIC_DIR, MEMORY_DIR, MEMORY_FILE, SOUL_FILE, DATA_DIR, MCP_CONFIG, SKILLS_DIR } from "../paths.js";
 import { broadcast } from "../services/broadcast.js";
+import { BOT_VERSION } from "../version.js";
 const WEB_PORT = parseInt(process.env.WEB_PORT || "3100");
 const WEB_PASSWORD = process.env.WEB_PASSWORD || "";
 /** The actual port the Web UI is running on (may differ from WEB_PORT if busy). */
@@ -259,7 +260,7 @@ async function handleAPI(req, res, urlPath, body) {
         }
         const { config: appConfig } = await import("../config.js");
         res.end(JSON.stringify({
-            bot: { version: "3.0.0", uptime: process.uptime() },
+            bot: { version: BOT_VERSION, uptime: process.uptime() },
             model: modelInfo,
             memory: { ...memory, vectors: index.entries, indexSize: index.sizeBytes },
             plugins: plugins.length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alvin-bot",
-  "version": "4.7.0",
+  "version": "4.8.1",
   "description": "Alvin Bot — Your personal AI agent on Telegram, WhatsApp, Discord, Signal, and Web.",
   "type": "module",
   "main": "dist/index.js",