pudu-ai 0.2.4 → 0.2.6

package/README.md

@@ -42,6 +42,7 @@ npx pudu-ai
 npx pudu-ai hardware
 npx pudu-ai models
 npx pudu-ai models add-path ~/Models
+npx pudu-ai setup
 npx pudu-ai recommend
 npx pudu-ai recommend --install --yes
 npx pudu-ai recommend --link opencode --yes

package/dist/cli/index.js

@@ -17,7 +17,8 @@ function parseArgs(argv) {
     "doctor",
     "report",
     "tasks",
-    "launch"
+    "launch",
+    "setup"
   ];
   const isKnown = known.includes(command);
   let addPath;
@@ -839,7 +840,17 @@ var en = {
   aboutReport: "Writes the latest measured run as Markdown. Use it to paste results into GitHub or notes.",
   aboutLaunch: "Explains Ollama integrations (OpenCode, OpenClaw, Hermes, Claude Code). Pull/launch only with --yes if the model grade is S\u2013B and speed is enough. Use it to wire a coding agent only when this hardware can carry it.",
   aboutAddPath: "Adds a GGUF folder to scan (not the whole disk). Use it so llama-bench can find models outside Ollama.",
-  nav: "[B] Benchmark  [M] Models  [R] Recommend  [T] Tasks  [H] Hardware  [C] Compare  [L] History  [Q] Quit",
+  nav: "[S] Setup/Install  [B] Benchmark  [M] Models  [R] Recommend  [T] Tasks  [H] Hardware  [C] Compare  [L] History  [Q] Quit",
+  setupTitle: "SETUP \u2014 INSTALL MODELS & AGENTS",
+  setupIntro: "Pick a recommended model (grade S\u2013B), install it with Ollama, then link or install OpenCode, Hermes, or OpenClaw.",
+  setupStep1: "1. Recommended models (\u2191\u2193 to choose)",
+  setupStep2: "2. Install the selected model",
+  setupInstallModel: "Press Enter or I  \u2192  ollama pull (only if grade is S, A, or B)",
+  setupStep3: "3. Coding agent \u2014 link if present, install if missing",
+  setupLinkNow: "installed \u2192 press 1/2/3 to link this model",
+  setupInstallAgent: "not installed \u2192 press 1/2/3 to install via ollama launch (if eligible)",
+  setupKeys: "Enter/I = pull model    1 OpenCode    2 Hermes    3 OpenClaw    Esc = back",
+  setupCta: "\u2192 Press [S] or [I] to INSTALL a recommended model and link OpenCode / Hermes / OpenClaw",
   machine: "MACHINE",
   runtimes: "LOCAL AI RUNTIMES",
   installedModels: "INSTALLED MODELS",
@@ -960,6 +971,7 @@ Usage:
   npx pudu-ai hardware
   npx pudu-ai models
   npx pudu-ai models add-path ~/Models
+  npx pudu-ai setup
   npx pudu-ai recommend
   npx pudu-ai recommend --install --yes
   npx pudu-ai recommend --link opencode --yes
@@ -1011,7 +1023,17 @@ var es = {
   aboutReport: "Exporta la \xFAltima corrida medida en Markdown. Sirve para pegar resultados en GitHub o notas.",
   aboutLaunch: "Explica las integraciones de Ollama (OpenCode, OpenClaw, Hermes, Claude Code). Pull/launch solo con --yes si la nota es S\u2013B y hay velocidad suficiente. Sirve para conectar un agente de c\xF3digo solo cuando el hardware lo aguanta.",
   aboutAddPath: "A\xF1ade una carpeta GGUF a escanear (no todo el disco). Sirve para que llama-bench encuentre modelos fuera de Ollama.",
-  nav: "[B] Benchmark  [M] Modelos  [R] Recomendaciones  [T] Tareas  [H] Hardware  [C] Comparar  [L] Historial  [Q] Salir",
+  nav: "[S] Setup/Instalar  [B] Benchmark  [M] Modelos  [R] Recomendaciones  [T] Tareas  [H] Hardware  [C] Comparar  [L] Historial  [Q] Salir",
+  setupTitle: "SETUP \u2014 INSTALAR MODELOS Y AGENTES",
+  setupIntro: "Elige un modelo recomendado (nota S\u2013B), inst\xE1lalo con Ollama y luego vincula o instala OpenCode, Hermes u OpenClaw.",
+  setupStep1: "1. Modelos recomendados (\u2191\u2193 para elegir)",
+  setupStep2: "2. Instalar el modelo seleccionado",
+  setupInstallModel: "Enter o I  \u2192  ollama pull (solo si la nota es S, A o B)",
+  setupStep3: "3. Agente de c\xF3digo \u2014 vincular si existe, instalar si falta",
+  setupLinkNow: "instalado \u2192 pulsa 1/2/3 para vincular este modelo",
+  setupInstallAgent: "no instalado \u2192 pulsa 1/2/3 para instalar con ollama launch (si es elegible)",
+  setupKeys: "Enter/I = descargar modelo    1 OpenCode    2 Hermes    3 OpenClaw    Esc = atr\xE1s",
+  setupCta: "\u2192 Pulsa [S] o [I] para INSTALAR un modelo recomendado y vincular OpenCode / Hermes / OpenClaw",
   machine: "EQUIPO",
   runtimes: "RUNTIMES DE IA LOCAL",
   installedModels: "MODELOS INSTALADOS",
@@ -1132,6 +1154,7 @@ Uso:
   npx pudu-ai hardware
   npx pudu-ai models
   npx pudu-ai models add-path ~/Models
+  npx pudu-ai setup
   npx pudu-ai recommend
   npx pudu-ai recommend --install --yes
   npx pudu-ai recommend --link opencode --yes
@@ -2059,7 +2082,8 @@ function Dashboard({ session }) {
         " ",
         GRADE_MEANING[rec.grade]
       ] }, `${rec.useCase}-${rec.model.id}`)),
-      /* @__PURE__ */ jsx(Text, { dimColor: true, children: t("credits") })
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: t("credits") }),
+      /* @__PURE__ */ jsx(Text, { bold: true, color: "yellow", children: t("setupCta") })
     ] })
   ] });
 }
@@ -2471,19 +2495,23 @@ async function pullOllamaModel(modelId) {
 
 // src/tui/views/Recommend.tsx
 import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+var TOOLS = [
+  { key: "1", id: "opencode", label: "OpenCode" },
+  { key: "2", id: "hermes", label: "Hermes" },
+  { key: "3", id: "openclaw", label: "OpenClaw" }
+];
 function RecommendView({ session }) {
   const { exit } = useApp();
   const [cursor, setCursor] = useState(0);
   const [log, setLog] = useState("");
   const [busy, setBusy] = useState(false);
   const recs = session.recommendations;
+  const rec = recs[cursor];
   useInput((input, key) => {
     if (busy) return;
-    if (key.escape) return;
     if (key.upArrow) setCursor((c) => Math.max(0, c - 1));
     if (key.downArrow) setCursor((c) => Math.min(Math.max(recs.length - 1, 0), c + 1));
-    const rec = recs[cursor];
-    if (input.toLowerCase() === "i" && rec) {
+    if ((input.toLowerCase() === "i" || key.return) && rec) {
       if (!canInstallGrade(rec.grade)) {
         setLog(t("installGradeBlock", { grade: rec.grade }));
         return;
@@ -2495,8 +2523,7 @@ function RecommendView({ session }) {
         setBusy(false);
       });
     }
-    const map = { o: "opencode", e: "hermes", w: "openclaw" };
-    const tool = map[input.toLowerCase()];
+    const tool = TOOLS.find((item) => item.key === input)?.id;
     if (tool && rec) {
       const decision = decideLaunch(session, tool);
       if (!decision.eligible) {
@@ -2513,29 +2540,40 @@ function RecommendView({ session }) {
     }
   });
   return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx4(Text4, { bold: true, color: "cyan", children: t("recommended") }),
-    /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: t("aboutRecommend") }),
-    /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: t("recommendKeys") }),
-    recs.map((rec, i) => /* @__PURE__ */ jsxs4(Text4, { color: i === cursor ? "cyan" : void 0, children: [
+    /* @__PURE__ */ jsxs4(Box4, { borderStyle: "round", borderColor: "yellow", flexDirection: "column", paddingX: 1, marginBottom: 1, children: [
+      /* @__PURE__ */ jsx4(Text4, { bold: true, color: "yellow", children: t("setupTitle") }),
+      /* @__PURE__ */ jsx4(Text4, { children: t("setupIntro") })
+    ] }),
+    /* @__PURE__ */ jsx4(Text4, { bold: true, color: "cyan", children: t("setupStep1") }),
+    recs.length === 0 && /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: t("installNone") }),
+    recs.map((item, i) => /* @__PURE__ */ jsxs4(Text4, { color: i === cursor ? "cyan" : void 0, children: [
       i === cursor ? "\u276F " : "  ",
-      /* @__PURE__ */ jsx4(Text4, { color: "magenta", children: rec.useCase.padEnd(12) }),
-      rec.model.name.padEnd(22),
+      /* @__PURE__ */ jsx4(Text4, { color: "magenta", children: item.useCase.padEnd(12) }),
+      item.model.name.padEnd(22),
       " ",
-      /* @__PURE__ */ jsx4(Text4, { color: gradeColor(rec.grade), bold: true, children: rec.grade }),
+      /* @__PURE__ */ jsx4(Text4, { color: gradeColor(item.grade), bold: true, children: item.grade }),
       " ",
-      GRADE_MEANING[rec.grade]
-    ] }, `${rec.useCase}-${rec.model.id}`)),
+      GRADE_MEANING[item.grade]
+    ] }, `${item.useCase}-${item.model.id}`)),
+    /* @__PURE__ */ jsxs4(Box4, { marginTop: 1, flexDirection: "column", children: [
+      /* @__PURE__ */ jsx4(Text4, { bold: true, color: "green", children: t("setupStep2") }),
+      /* @__PURE__ */ jsx4(Text4, { color: "green", children: t("setupInstallModel") })
+    ] }),
     /* @__PURE__ */ jsxs4(Box4, { marginTop: 1, flexDirection: "column", children: [
-      /* @__PURE__ */ jsx4(Text4, { bold: true, color: "yellow", children: t("agentsTitle") }),
-      session.agents.map((agent) => /* @__PURE__ */ jsxs4(Text4, { color: agent.detected ? "green" : "gray", children: [
+      /* @__PURE__ */ jsx4(Text4, { bold: true, color: "yellow", children: t("setupStep3") }),
+      session.agents.map((agent, index) => /* @__PURE__ */ jsxs4(Text4, { color: agent.detected ? "green" : "yellow", children: [
+        "[",
+        index + 1,
+        "] ",
         agent.detected ? "\u2713" : "\u25CB",
         " ",
         agent.label.padEnd(12),
         " ",
-        agent.detected ? t("detected") : t("agentMissing")
+        agent.detected ? t("setupLinkNow") : t("setupInstallAgent")
       ] }, agent.id))
     ] }),
-    log ? /* @__PURE__ */ jsx4(Text4, { color: "green", children: log }) : /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: t("credits") })
+    /* @__PURE__ */ jsx4(Box4, { marginTop: 1, children: /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: t("setupKeys") }) }),
+    log ? /* @__PURE__ */ jsx4(Text4, { color: "green", children: log }) : null
   ] });
 }
 
@@ -2999,33 +3037,43 @@ function TasksView({ session }) {
   ] });
 }
 
+// src/tui/keys.ts
+function handleAppKey(screen, input, key) {
+  const letter = input.toLowerCase();
+  if (screen === "benchmark") return { type: "ignore" };
+  if (screen === "recommend" || screen === "tasks") {
+    if (letter === "q") return { type: "quit" };
+    if (key.escape) return { type: "home" };
+    return { type: "ignore" };
+  }
+  if (letter === "q" || key.escape) return { type: "quit" };
+  if (letter === "b") return { type: "screen", screen: "benchmark" };
+  if (letter === "m") return { type: "screen", screen: "models" };
+  if (letter === "r") return { type: "screen", screen: "recommend" };
+  if (letter === "h") return { type: "screen", screen: "hardware" };
+  if (letter === "c") return { type: "screen", screen: "compare" };
+  if (letter === "l") return { type: "screen", screen: "history" };
+  if (letter === "t") return { type: "screen", screen: "tasks" };
+  if (letter === "s" || letter === "i") return { type: "screen", screen: "recommend" };
+  if (key.return && screen === "home") return { type: "screen", screen: "benchmark" };
+  return { type: "ignore" };
+}
+
 // src/tui/App.tsx
 import { jsx as jsx9, jsxs as jsxs8 } from "react/jsx-runtime";
 function App(props) {
   const { exit } = useApp2();
-  const [screen, setScreen] = useState4("home");
+  const [screen, setScreen] = useState4(props.start ?? "home");
   const [selected, setSelected] = useState4(0);
   const benchable = useMemo2(
     () => props.session.models.filter((m) => Boolean(m.artifactPath)),
     [props.session.models]
   );
   useInput4((input, key) => {
-    if (screen === "benchmark") return;
-    if (screen === "recommend" || screen === "tasks") {
-      if (letter === "q") exit();
-      if (key.escape) setScreen("home");
-      return;
-    }
-    const letter = input.toLowerCase();
-    if (letter === "q" || key.escape) exit();
-    if (letter === "b") setScreen("benchmark");
-    if (letter === "m") setScreen("models");
-    if (letter === "r") setScreen("recommend");
-    if (letter === "h") setScreen("hardware");
-    if (letter === "c") setScreen("compare");
-    if (letter === "l") setScreen("history");
-    if (letter === "t") setScreen("tasks");
-    if (key.return && screen === "home") setScreen("benchmark");
+    const result = handleAppKey(screen, input, key);
+    if (result.type === "quit") exit();
+    if (result.type === "home") setScreen("home");
+    if (result.type === "screen") setScreen(result.screen);
   });
   return /* @__PURE__ */ jsxs8(Box9, { flexDirection: "column", padding: 1, children: [
     screen === "home" && /* @__PURE__ */ jsx9(Dashboard, { session: props.session }),
@@ -3052,8 +3100,8 @@ function App(props) {
 
 // src/tui/render.tsx
 import { jsx as jsx10 } from "react/jsx-runtime";
-async function renderDashboard(session, preset) {
-  const instance = render(/* @__PURE__ */ jsx10(App, { session, preset }));
+async function renderDashboard(session, preset, start) {
+  const instance = render(/* @__PURE__ */ jsx10(App, { session, preset, start }));
   await instance.waitUntilExit();
 }
 
@@ -3115,6 +3163,13 @@ ${runtimesText(session)}`),
     case "models":
       print(args2.json ? session.rows : explained("aboutModels", modelsText(session)), args2.json);
       return 0;
+    case "setup":
+      if (args2.json) {
+        print({ recommendations: session.recommendations, agents: session.agents }, true);
+        return 0;
+      }
+      await renderDashboard(session, args2.preset, "recommend");
+      return 0;
     case "recommend": {
       if (args2.install && args2.yes) {
         const rec = session.recommendations.find((r) => canInstallGrade(r.grade));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pudu-ai",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Pudu-AI — local AI hardware & benchmark lab for the terminal",
   "keywords": [
     "ai",