@vecanova/zana 3.0.5

package/README.md

@@ -0,0 +1,42 @@
+# @vecanova/zana
+
+**Every person in the world can have their own Aeon.**
+
+```bash
+npm install -g @vecanova/zana
+zana init
+```
+
+That's it. Your sovereign cognitive AI, running on your hardware.
+
+## What this installs
+
+This npm package is a thin wrapper that:
+1. Verifies Python 3.11+ is present
+2. Installs the `zana` Python package via pip
+3. Exposes the `zana` command globally in your terminal
+
+## Requirements
+
+- Node.js 18+ (for this installer)
+- Python 3.11+ (for ZANA to run)
+
+No Docker required for the default install. No API keys required if you use Ollama.
+
+## Quick start
+
+```bash
+npm install -g @vecanova/zana   # installs everything
+zana init                        # ≤4 questions, <3 min to first conversation
+zana start                       # boot the stack
+zana chat                        # talk to your Aeon
+```
+
+## More
+
+- [GitHub](https://github.com/Kemquiros/zana-core)
+- [Documentation](https://github.com/Kemquiros/zana-core/tree/main/docs)
+
+MIT License — Built with honor in Medellín, Colombia 🇨🇴 by [VECANOVA](https://vecanova.com)
+
+*JUNTOS HACEMOS TEMBLAR LOS CIELOS.*

package/bin/zana.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+/**
+ * ZANA CLI — npm wrapper for the Python CLI.
+ *
+ * This file is the entry point when installed via `npm install -g @vecanova/zana`.
+ * It delegates all arguments to the Python `zana` CLI installed by postinstall.js.
+ */
+
+"use strict";
+
+const { spawnSync, execFileSync } = require("child_process");
+const path = require("path");
+const os = require("os");
+const fs = require("fs");
+
+// ── Locate the Python zana binary ────────────────────────────────────────────
+
+function findZanaBinary() {
+  // 1. Check if already in PATH
+  const which = process.platform === "win32" ? "where" : "which";
+  try {
+    const found = execFileSync(which, ["zana-py"], { encoding: "utf8" }).trim().split("\n")[0];
+    if (found) return found;
+  } catch (_) {}
+
+  // 2. Check common pip/uv install locations
+  const candidates = [
+    path.join(os.homedir(), ".local", "bin", "zana"),
+    path.join(os.homedir(), ".cargo", "bin", "zana"),
+    "/usr/local/bin/zana",
+    "/usr/bin/zana",
+    // Windows pip
+    path.join(os.homedir(), "AppData", "Local", "Programs", "Python", "Python312", "Scripts", "zana.exe"),
+  ];
+
+  for (const c of candidates) {
+    if (fs.existsSync(c)) return c;
+  }
+
+  return null;
+}
+
+function findPython() {
+  for (const bin of ["python3.12", "python3.11", "python3", "python"]) {
+    try {
+      const v = execFileSync(bin, ["--version"], { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+      const match = v.match(/Python (\d+)\.(\d+)/);
+      if (match && parseInt(match[1]) >= 3 && parseInt(match[2]) >= 11) {
+        return bin;
+      }
+    } catch (_) {}
+  }
+  return null;
+}
+
+// ── Bootstrap if not installed ────────────────────────────────────────────────
+
+function bootstrap() {
+  const python = findPython();
+  if (!python) {
+    console.error(
+      "\n❌ Python 3.11+ not found.\n" +
+      "   Install it from https://python.org/downloads/ then run:\n" +
+      "   npm install -g @vecanova/zana\n"
+    );
+    process.exit(1);
+  }
+
+  console.log("⚙️  Installing ZANA Python package (first run)...");
+  const result = spawnSync(
+    python,
+    ["-m", "pip", "install", "--quiet", "--upgrade", "zana"],
+    { stdio: "inherit" }
+  );
+
+  if (result.status !== 0) {
+    console.error(
+      "\n❌ Failed to install ZANA Python package.\n" +
+      "   Try manually: pip install zana\n" +
+      "   Or run the installer: bash <(curl -LsSf https://zana.vecanova.com/install.sh)\n"
+    );
+    process.exit(1);
+  }
+
+  console.log("✅ ZANA installed. Running your command...\n");
+}
+
+// ── Main: delegate to Python CLI ─────────────────────────────────────────────
+
+let zanaBin = findZanaBinary();
+
+if (!zanaBin) {
+  bootstrap();
+  zanaBin = findZanaBinary();
+}
+
+if (!zanaBin) {
+  // Last resort: run via python -m cli.main
+  const python = findPython();
+  if (!python) {
+    console.error("❌ Could not locate ZANA. Run: pip install zana");
+    process.exit(1);
+  }
+  zanaBin = null;
+  const args = process.argv.slice(2);
+  const result = spawnSync(python, ["-m", "cli.main", ...args], {
+    stdio: "inherit",
+    env: process.env,
+  });
+  process.exit(result.status ?? 1);
+}
+
+const args = process.argv.slice(2);
+const result = spawnSync(zanaBin, args, {
+  stdio: "inherit",
+  env: process.env,
+  shell: process.platform === "win32",
+});
+
+process.exit(result.status ?? 0);

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@vecanova/zana",
+  "version": "3.0.5",
+  "description": "ZANA — Zero Autonomous Neural Architecture. Every person deserves their own Aeon.",
+  "keywords": [
+    "ai",
+    "agent",
+    "cognitive",
+    "sovereign",
+    "aeon",
+    "llm",
+    "local-ai"
+  ],
+  "author": "John Tapias <absurdoeco@gmail.com> (https://vecanova.com)",
+  "license": "MIT",
+  "homepage": "https://github.com/Kemquiros/zana-core",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Kemquiros/zana-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Kemquiros/zana-core/issues"
+  },
+  "bin": {
+    "zana": "./bin/zana.js"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/",
+    "postinstall.js",
+    "README.md"
+  ]
+}

package/postinstall.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+/**
+ * postinstall.js — runs on `npm install -g @vecanova/zana`.
+ * Checks Python 3.11+, installs the ZANA Python package if missing.
+ */
+
+"use strict";
+
+const { execFileSync, spawnSync } = require("child_process");
+
+// Skip in CI environments to avoid hanging
+if (process.env.CI || process.env.ZANA_SKIP_POSTINSTALL) {
+  process.exit(0);
+}
+
+function findPython() {
+  for (const bin of ["python3.12", "python3.11", "python3", "python"]) {
+    try {
+      const v = execFileSync(bin, ["--version"], {
+        encoding: "utf8",
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 5000,
+      }).trim();
+      const match = v.match(/Python (\d+)\.(\d+)/);
+      if (match && parseInt(match[1]) >= 3 && parseInt(match[2]) >= 11) {
+        return bin;
+      }
+    } catch (_) {}
+  }
+  return null;
+}
+
+function isZanaInstalled(python) {
+  try {
+    execFileSync(python, ["-c", "import cli.main"], {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 5000,
+    });
+    return true;
+  } catch (_) {}
+  try {
+    execFileSync(python, ["-m", "pip", "show", "zana"], {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 5000,
+    });
+    return true;
+  } catch (_) {}
+  return false;
+}
+
+console.log("\n╔══════════════════════════════════════════════════╗");
+console.log("║   @vecanova/zana — ZANA CLI installer            ║");
+console.log("╚══════════════════════════════════════════════════╝\n");
+
+const python = findPython();
+
+if (!python) {
+  console.warn(
+    "⚠️  Python 3.11+ not found. ZANA needs Python to run.\n" +
+    "   Install it from https://python.org/downloads/\n" +
+    "   Then run: npm install -g @vecanova/zana\n"
+  );
+  process.exit(0); // non-fatal: npm install still succeeds
+}
+
+console.log(`✓  Python found: ${python}`);
+
+if (isZanaInstalled(python)) {
+  console.log("✓  ZANA Python package already installed.\n");
+  console.log("   Run: zana init   — to create your Aeon");
+  console.log("   Run: zana --help — to explore commands\n");
+  process.exit(0);
+}
+
+console.log("⚙️  Installing ZANA Python package via pip...");
+console.log("   This may take 1-2 minutes on first install.\n");
+
+const result = spawnSync(
+  python,
+  ["-m", "pip", "install", "--upgrade", "--quiet", "zana"],
+  { stdio: "inherit", timeout: 300_000 }
+);
+
+if (result.status === 0) {
+  console.log("\n✅ ZANA installed successfully!\n");
+  console.log("╔══════════════════════════════════════════════════╗");
+  console.log("║   Quick start:                                   ║");
+  console.log("║                                                  ║");
+  console.log("║   zana init    — create your Aeon (<3 min)       ║");
+  console.log("║   zana start   — boot the stack                  ║");
+  console.log("║   zana chat    — first conversation              ║");
+  console.log("║                                                  ║");
+  console.log("║   Your data. Your hardware. Your soul.           ║");
+  console.log("╚══════════════════════════════════════════════════╝\n");
+} else {
+  console.warn(
+    "\n⚠️  Could not auto-install ZANA Python package.\n" +
+    "   Run manually: pip install zana\n" +
+    "   Or: bash <(curl -LsSf https://zana.vecanova.com/install.sh)\n"
+  );
+  // non-fatal exit
+  process.exit(0);
+}