@inferall/cli 0.2.1 → 0.2.2

package/README.md

@@ -35,6 +35,12 @@ The wizard:
 
 ## Commands
 
+For a project with no existing AI client, `init` writes a first-request example:
+`node inferall-hello.mjs` or `python3 inferall_hello.py`. Both use built-in
+libraries, read your exported key or the `.env` beside the example, and select
+the free model explicitly. A refusal or empty response exits nonzero and prints
+an explanation to stderr. Existing example files are left intact.
+
 - `init`: the wizard above (default).
 - `doctor`: health-check an existing setup. Key present and valid, `.env`
   gitignore hygiene, whether every client call site points at the gateway, and

package/bin/build-info.json

@@ -1 +1 @@
-{"sha":"2a3e95e","ref":"main","offMain":null}
+{"sha":"51fd6a7","ref":"main","offMain":null}

package/bin/inferall.js

@@ -1877,9 +1877,175 @@ export function isPlausiblePatch(text, site, base) {
 export function writeExample(root, kind) {
   const p = join(root, kind === "python" ? "inferall_hello.py" : "inferall-hello.mjs");
   if (existsSync(p)) return { path: null, problem: null };   // never clobber theirs
+  // The examples are dependency-free (Node fetch, Python urllib) and read the
+  // key from the environment, else from the .env next to the file, so a plain
+  // `node`/`python3` run works right after init. String.raw keeps the regex
+  // backslashes; the generated code avoids backticks and "${" for that reason.
   const body = kind === "python"
-    ? `"""InferAll hello. Run: python inferall_hello.py (pip install inferall-ai)"""\nfrom inferall import Inferall\n\nai = Inferall()  # reads INFERALL_API_KEY from the environment\nprint(ai.text("Explain InferAll in one sentence."))\n`
-    : `// InferAll hello. Run: node --env-file=.env inferall-hello.mjs\nconst res = await fetch("${API_BASE}/chat/completions", {\n  method: "POST",\n  headers: {\n    Authorization: \`Bearer \${process.env.INFERALL_API_KEY}\`,\n    "Content-Type": "application/json",\n  },\n  body: JSON.stringify({\n    model: "${FREE_MODEL}",\n    messages: [{ role: "user", content: "Explain InferAll in one sentence." }],\n  }),\n});\nconsole.log((await res.json()).choices?.[0]?.message?.content ?? (await res.text()));\n`;
+    ? String.raw`"""InferAll hello. Run: python3 inferall_hello.py (no packages needed)"""
+import json
+import http.client
+import os
+import re
+import sys
+import urllib.error
+import urllib.request
+from pathlib import Path
+
+API_BASE = ${JSON.stringify(API_BASE)}
+MODEL = ${JSON.stringify(FREE_MODEL)}
+
+
+def fail(message):
+    print("inferall: " + message, file=sys.stderr)
+    sys.exit(1)
+
+
+def read_key():
+    # INFERALL_API_KEY from the environment first, else the .env beside this file.
+    key = os.environ.get("INFERALL_API_KEY", "").strip()
+    if key:
+        return key
+    try:
+        text = (Path(__file__).resolve().parent / ".env").read_text(encoding="utf-8-sig")
+    except FileNotFoundError:
+        return ""
+    except OSError as e:
+        fail("could not read .env: %s" % e)
+    pattern = re.compile(r"^\s*(?:export\s+)?INFERALL_API_KEY\s*=(.*)$")
+    for line in text.splitlines():
+        m = pattern.match(line)
+        if m:
+            value = m.group(1).strip()
+            if value[:1] in ('"', "'"):
+                close = value.find(value[0], 1)
+                return value[1:close] if close != -1 else value
+            return re.sub(r"\s+#.*$", "", value).strip()
+    return ""
+
+
+key = read_key()
+if not key:
+    fail("INFERALL_API_KEY is not set. Export it or put it in the .env next to this file.")
+
+request = urllib.request.Request(
+    API_BASE + "/chat/completions",
+    data=json.dumps({
+        "model": MODEL,
+        "messages": [{"role": "user", "content": "Explain InferAll in one sentence."}],
+    }).encode(),
+    headers={
+        "Authorization": "Bearer " + key,
+        "Content-Type": "application/json",
+        "User-Agent": "inferall-hello-example",
+    },
+    method="POST",
+)
+try:
+    try:
+        res = urllib.request.urlopen(request, timeout=120)
+    except urllib.error.HTTPError as e:
+        res = e
+    with res:
+        status, raw = res.status, res.read()
+except (OSError, http.client.HTTPException) as e:
+    fail("request failed: %s" % e)
+
+text = raw.decode("utf-8", "replace")
+try:
+    data = json.loads(text)
+except ValueError:
+    data = None
+if not isinstance(data, dict):
+    data = {}
+
+if not 200 <= status < 300:
+    err = data.get("error")
+    detail = err.get("message") if isinstance(err, dict) else err
+    detail = detail or data.get("message") or text.strip()[:300] or "no response body"
+    fail("HTTP %d: %s" % (status, detail))
+
+try:
+    answer = data["choices"][0]["message"]["content"]
+except (KeyError, IndexError, TypeError):
+    answer = None
+if not isinstance(answer, str) or not answer.strip():
+    fail("the gateway answered HTTP %d but the response had no answer text" % status)
+print(answer)
+`
+    : String.raw`// InferAll hello. Run: node inferall-hello.mjs (Node 18+, no packages needed)
+import { readFileSync } from "node:fs";
+
+const API_BASE = ${JSON.stringify(API_BASE)};
+const MODEL = ${JSON.stringify(FREE_MODEL)};
+
+function fail(message) {
+  console.error("inferall: " + message);
+  process.exit(1);
+}
+
+// INFERALL_API_KEY from the environment first, else the .env beside this file.
+function readKey() {
+  const fromEnv = (process.env.INFERALL_API_KEY || "").trim();
+  if (fromEnv) return fromEnv;
+  let text;
+  try {
+    text = readFileSync(new URL(".env", import.meta.url), "utf8");
+  } catch (err) {
+    if (err.code === "ENOENT") return "";
+    fail("could not read .env: " + err.message);
+  }
+  for (const line of text.split(/\r?\n/)) {
+    const m = line.match(/^\s*(?:export\s+)?INFERALL_API_KEY\s*=(.*)$/);
+    if (m) {
+      const value = m[1].trim();
+      if (value[0] === '"' || value[0] === "'") {
+        const close = value.indexOf(value[0], 1);
+        return close === -1 ? value : value.slice(1, close);
+      }
+      return value.replace(/\s+#.*$/, "").trim();
+    }
+  }
+  return "";
+}
+
+const key = readKey();
+if (!key) fail("INFERALL_API_KEY is not set. Export it or put it in the .env next to this file.");
+
+let res;
+let raw;
+try {
+  res = await fetch(API_BASE + "/chat/completions", {
+    method: "POST",
+    headers: { Authorization: "Bearer " + key, "Content-Type": "application/json" },
+    body: JSON.stringify({
+      model: MODEL,
+      messages: [{ role: "user", content: "Explain InferAll in one sentence." }],
+    }),
+    signal: AbortSignal.timeout(120_000),
+  });
+  raw = await res.text();
+} catch (err) {
+  fail("request failed: " + (err.name === "TimeoutError" ? "timed out after 120s" : err.message));
+}
+
+let data;
+try {
+  data = JSON.parse(raw);
+} catch {}
+
+if (!res.ok) {
+  const e = data?.error;
+  const detail = (typeof e === "string" ? e : e?.message) || data?.message || raw.trim().slice(0, 300) || res.statusText;
+  fail("HTTP " + res.status + ": " + detail);
+}
+
+const answer = data?.choices?.[0]?.message?.content;
+if (typeof answer !== "string" || !answer.trim()) {
+  fail("the gateway answered HTTP " + res.status + " but the response had no answer text");
+}
+console.log(answer);
+`;
   try {
     writeFileSync(p, body);
     return { path: p, problem: null };
@@ -2858,6 +3024,10 @@ async function main() {
       console.log(`  ${c.red("✗")} ${example.problem}`);
       envResult.problems.push(example.problem);
     }
+    if (example.path) {
+      const run = project.kind === "node" ? "node inferall-hello.mjs" : "python3 inferall_hello.py";
+      console.log(`  ${c.dim("run:")} ${c.bold(run)} ${c.dim("(reads INFERALL_API_KEY from the environment or .env)")}`);
+    }
     if (project.kind === "node") console.log(`  ${c.dim("optional:")} npm install @inferall/sdk`);
     else console.log(`  ${c.dim("optional:")} pip install inferall-ai`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inferall/cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Install InferAll into your project in one command: npx @inferall/cli init",
   "bin": {
     "inferall": "bin/inferall.js"