@gmickel/gno 0.14.3 → 0.15.1

package/README.md

@@ -6,6 +6,7 @@
 [![MIT License](./assets/badges/license.svg)](./LICENSE)
 [![Website](./assets/badges/website.svg)](https://gno.sh)
 [![Twitter](./assets/badges/twitter.svg)](https://twitter.com/gmickel)
+[![Discord](./assets/badges/discord.svg)](https://discord.gg/nHEmyJB5tg)
 
 > **ClawdHub**: GNO skills bundled for Clawdbot — [clawdhub.com/gmickel/gno](https://clawdhub.com/gmickel/gno)
 
@@ -31,7 +32,14 @@ GNO is a local knowledge engine that turns your documents into a searchable, con
 
 ---
 
-## What's New in v0.13
+## What's New in v0.15
+
+- **HTTP Backends**: Offload embedding, reranking, and generation to remote GPU servers
+- Simple URI config: `http://host:port/path#modelname`
+- Works with llama-server, Ollama, LocalAI, vLLM
+- Run GNO on lightweight machines while GPU inference runs on your network
+
+### v0.13
 
 - **Knowledge Graph**: Interactive force-directed visualization of document connections
 - **Graph with Similarity**: See semantic similarity as golden edges (not just wiki/markdown links)
@@ -342,28 +350,29 @@ graph TD
 
 ## Features
 
-| Feature             | Description                                                                    |
-| :------------------ | :----------------------------------------------------------------------------- |
-| **Hybrid Search**   | BM25 + vector + RRF fusion + cross-encoder reranking                           |
-| **Document Editor** | Create, edit, delete docs with live markdown preview                           |
-| **Web UI**          | Visual dashboard for search, browse, edit, and AI Q&A                          |
-| **REST API**        | HTTP API for custom tools and integrations                                     |
-| **Multi-Format**    | Markdown, PDF, DOCX, XLSX, PPTX, plain text                                    |
-| **Local LLM**       | AI answers via llama.cpp, no API keys                                          |
-| **Privacy First**   | 100% offline, zero telemetry, your data stays yours                            |
-| **MCP Server**      | Works with Claude Desktop, Cursor, Zed, + 8 more                               |
-| **Collections**     | Organize sources with patterns, excludes, contexts                             |
-| **Tag Filtering**   | Frontmatter tags with hierarchical paths, filter via `--tags-any`/`--tags-all` |
-| **Note Linking**    | Wiki links, backlinks, related notes, cross-collection navigation              |
-| **Multilingual**    | 30+ languages, auto-detection, cross-lingual search                            |
-| **Incremental**     | SHA-256 tracking, only changed files re-indexed                                |
-| **Keyboard First**  | ⌘N capture, ⌘K search, ⌘/ shortcuts, ⌘S save                                   |
+| Feature              | Description                                                                    |
+| :------------------- | :----------------------------------------------------------------------------- |
+| **Hybrid Search**    | BM25 + vector + RRF fusion + cross-encoder reranking                           |
+| **Document Editor**  | Create, edit, delete docs with live markdown preview                           |
+| **Web UI**           | Visual dashboard for search, browse, edit, and AI Q&A                          |
+| **REST API**         | HTTP API for custom tools and integrations                                     |
+| **Multi-Format**     | Markdown, PDF, DOCX, XLSX, PPTX, plain text                                    |
+| **Local LLM**        | AI answers via llama.cpp, no API keys                                          |
+| **Remote Inference** | Offload to GPU servers via HTTP (llama-server, Ollama, LocalAI)                |
+| **Privacy First**    | 100% offline, zero telemetry, your data stays yours                            |
+| **MCP Server**       | Works with Claude Desktop, Cursor, Zed, + 8 more                               |
+| **Collections**      | Organize sources with patterns, excludes, contexts                             |
+| **Tag Filtering**    | Frontmatter tags with hierarchical paths, filter via `--tags-any`/`--tags-all` |
+| **Note Linking**     | Wiki links, backlinks, related notes, cross-collection navigation              |
+| **Multilingual**     | 30+ languages, auto-detection, cross-lingual search                            |
+| **Incremental**      | SHA-256 tracking, only changed files re-indexed                                |
+| **Keyboard First**   | ⌘N capture, ⌘K search, ⌘/ shortcuts, ⌘S save                                   |
 
 ---
 
 ## Local Models
 
-Models auto-download on first use to `~/.cache/gno/models/`.
+Models auto-download on first use to `~/.cache/gno/models/`. Alternatively, offload to a GPU server on your network using HTTP backends.
 
 | Model               | Purpose                               | Size         |
 | :------------------ | :------------------------------------ | :----------- |
@@ -384,6 +393,24 @@ gno models use slim
 gno models pull --all  # Optional: pre-download models (auto-downloads on first use)
 ```
 
+### HTTP Backends (Remote GPU)
+
+Offload inference to a GPU server on your network:
+
+```yaml
+# ~/.config/gno/config.yaml
+models:
+  activePreset: remote-gpu
+  presets:
+    - id: remote-gpu
+      name: Remote GPU Server
+      embed: "http://192.168.1.100:8081/v1/embeddings#bge-m3"
+      rerank: "http://192.168.1.100:8082/v1/completions#reranker"
+      gen: "http://192.168.1.100:8083/v1/chat/completions#qwen3-4b"
+```
+
+Works with llama-server, Ollama, LocalAI, vLLM, or any OpenAI-compatible server.
+
 > **Configuration**: [Model Setup](https://gno.sh/docs/CONFIGURATION/)
 
 ---

package/assets/badges/discord.svg

@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="110" height="28" viewBox="0 0 110 28">
+  <defs>
+    <linearGradient id="bg3" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#1a1a2e"/>
+      <stop offset="100%" style="stop-color:#0f0f1a"/>
+    </linearGradient>
+    <filter id="glow3">
+      <feGaussianBlur stdDeviation="0.5" result="coloredBlur"/>
+      <feMerge>
+        <feMergeNode in="coloredBlur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+  <rect width="110" height="28" rx="6" fill="url(#bg3)"/>
+  <rect x="1" y="1" width="108" height="26" rx="5" fill="none" stroke="#5865F2" stroke-opacity="0.4"/>
+  <!-- Discord logo -->
+  <g transform="translate(10, 6)" fill="#5865F2">
+    <path d="M13.5 4.5C12.5 4 11.4 3.6 10.3 3.4C10.2 3.6 10 3.9 9.9 4.1C8.7 3.9 7.5 3.9 6.4 4.1C6.3 3.9 6.1 3.6 6 3.4C4.9 3.6 3.8 4 2.8 4.5C0.7 7.6 0.1 10.6 0.4 13.6C1.7 14.5 2.9 15.1 4.1 15.5C4.4 15.1 4.7 14.6 4.9 14.1C4.4 13.9 4 13.7 3.6 13.4C3.7 13.3 3.8 13.2 3.9 13.1C6.5 14.3 9.3 14.3 11.9 13.1C12 13.2 12.1 13.3 12.2 13.4C11.8 13.7 11.4 13.9 10.9 14.1C11.1 14.6 11.4 15.1 11.7 15.5C12.9 15.1 14.1 14.5 15.4 13.6C15.7 10.1 14.8 7.1 13.5 4.5ZM5.3 11.6C4.6 11.6 4 10.9 4 10.1C4 9.3 4.6 8.6 5.3 8.6C6 8.6 6.6 9.3 6.6 10.1C6.6 10.9 6 11.6 5.3 11.6ZM10.5 11.6C9.8 11.6 9.2 10.9 9.2 10.1C9.2 9.3 9.8 8.6 10.5 8.6C11.2 8.6 11.8 9.3 11.8 10.1C11.8 10.9 11.2 11.6 10.5 11.6Z" transform="scale(1)"/>
+  </g>
+  <text x="32" y="18" font-family="ui-monospace,SFMono-Regular,Menlo,Monaco,monospace" font-size="12" font-weight="500" fill="#e2e8f0" filter="url(#glow3)">Discord</text>
+</svg>

package/assets/skill/examples.md

@@ -249,6 +249,7 @@ gno similar gno://notes/auth.md --cross-collection
 
 ```markdown
 # In your documents:
+
 See [[API Design]] for details.
 Check [[work:Project Plan]] for cross-collection link.
 Read [[Security#OAuth]] for specific section.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "0.14.3",
+  "version": "0.15.1",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",
@@ -43,6 +43,7 @@
     "start": "bun run src/index.ts",
     "lint": "oxlint --fix --type-aware --type-check && oxfmt .",
     "lint:check": "oxlint --type-aware --type-check && oxfmt --check .",
+    "typecheck": "bunx tsc --noEmit",
     "test": "bun test",
     "test:watch": "bun test --watch",
     "test:coverage": "bun test --coverage",
@@ -94,12 +95,12 @@
     "commander": "^14.0.2",
     "embla-carousel-react": "^8.6.0",
     "franc": "^6.2.0",
-    "lucide-react": "^0.562.0",
-    "markitdown-ts": "^0.0.8",
+    "lucide-react": "^0.563.0",
+    "markitdown-ts": "^0.0.9",
     "minimatch": "^10.1.1",
     "nanoid": "^5.1.6",
     "node-llama-cpp": "^3.14.5",
-    "officeparser": "^5.2.2",
+    "officeparser": "^6.0.4",
     "picocolors": "^1.1.1",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
@@ -109,7 +110,7 @@
     "remark-gfm": "^4.0.1",
     "shiki": "^3.20.0",
     "sqlite-vec": "^0.1.7-alpha.2",
-    "streamdown": "^1.6.10",
+    "streamdown": "^2.0.1",
     "tailwind-merge": "^3.4.0",
     "tailwindcss": "^4.1.18",
     "use-stick-to-bottom": "^1.1.1",
@@ -117,7 +118,7 @@
   },
   "devDependencies": {
     "@ai-sdk/openai": "^3.0.2",
-    "@biomejs/biome": "2.3.10",
+    "@biomejs/biome": "2.3.13",
     "@tailwindcss/cli": "^4.1.18",
     "@types/bun": "latest",
     "@types/react": "^19.2.7",
@@ -128,13 +129,13 @@
     "evalite": "^1.0.0-beta.15",
     "exceljs": "^4.4.0",
     "lefthook": "^2.0.13",
-    "oxfmt": "^0.21.0",
+    "oxfmt": "^0.27.0",
     "oxlint": "^1.36.0",
-    "oxlint-tsgolint": "^0.10.1",
+    "oxlint-tsgolint": "^0.11.4",
     "pdf-lib": "^1.17.1",
     "playwright": "^1.52.0",
     "pptxgenjs": "^4.0.1",
-    "ultracite": "7.0.4",
+    "ultracite": "7.1.1",
     "vitest": "^4.0.16"
   },
   "peerDependencies": {

package/src/cli/AGENTS.md

@@ -54,9 +54,9 @@ program
 
 ```typescript
 export const EXIT = {
-  SUCCESS: 0,    // Command completed successfully
+  SUCCESS: 0, // Command completed successfully
   VALIDATION: 1, // Bad args, missing params
-  RUNTIME: 2,    // IO, DB, model, network errors
+  RUNTIME: 2, // IO, DB, model, network errors
 } as const;
 ```
 

package/src/cli/CLAUDE.md

@@ -54,9 +54,9 @@ program
 
 ```typescript
 export const EXIT = {
-  SUCCESS: 0,    // Command completed successfully
+  SUCCESS: 0, // Command completed successfully
   VALIDATION: 1, // Bad args, missing params
-  RUNTIME: 2,    // IO, DB, model, network errors
+  RUNTIME: 2, // IO, DB, model, network errors
 } as const;
 ```
 

package/src/cli/pager.ts

@@ -167,7 +167,7 @@ export class Pager {
 
       // Write content to pager stdin
       if (proc.stdin) {
-        proc.stdin.write(content + "\n");
+        await proc.stdin.write(content + "\n");
         await proc.stdin.end();
       }
 

package/src/converters/adapters/officeparser/adapter.ts

@@ -1,9 +1,9 @@
 /**
  * officeparser adapter for PPTX conversion.
- * Uses parseOfficeAsync() with Buffer for in-memory extraction.
+ * Uses parseOffice() v6 API with Buffer for in-memory extraction.
  */
 
-import { parseOfficeAsync } from "officeparser";
+import { parseOffice } from "officeparser";
 
 import type {
   Converter,
@@ -76,10 +76,12 @@ export const officeparserAdapter: Converter = {
     try {
       // Zero-copy Buffer view (input.bytes is immutable by contract)
       const buffer = toBuffer(input.bytes);
-      const text = await parseOfficeAsync(buffer, {
+      // v6 API: parseOffice returns AST, use .toText() for plain text
+      const ast = await parseOffice(buffer, {
         newlineDelimiter: "\n",
         ignoreNotes: false, // Include speaker notes
       });
+      const text = ast.toText();
 
       if (!text || text.trim().length === 0) {
         return {

package/src/converters/versions.ts

@@ -20,5 +20,5 @@ export const NATIVE_VERSIONS = {
  */
 export const ADAPTER_VERSIONS = {
   "markitdown-ts": "0.0.8",
-  officeparser: "5.2.0",
+  officeparser: "6.0.4",
 } as const;

package/src/llm/httpEmbedding.ts

@@ -0,0 +1,197 @@
+/**
+ * HTTP-based embedding port implementation.
+ * Calls OpenAI-compatible embedding endpoints.
+ *
+ * @module src/llm/httpEmbedding
+ */
+
+import type { EmbeddingPort, LlmResult } from "./types";
+
+import { inferenceFailedError } from "./errors";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+interface OpenAIEmbeddingResponse {
+  data: Array<{
+    embedding: number[];
+    index: number;
+    object: string;
+  }>;
+  model: string;
+  object: string;
+  usage: {
+    prompt_tokens: number;
+    total_tokens: number;
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+
+export class HttpEmbedding implements EmbeddingPort {
+  private readonly apiUrl: string;
+  private readonly modelName: string;
+  private dims: number | null = null;
+  readonly modelUri: string;
+
+  constructor(modelUri: string) {
+    this.modelUri = modelUri;
+    // Parse URI: http://host:port/v1/embeddings#modelname or just http://host:port
+    const hashIndex = modelUri.indexOf("#");
+    if (hashIndex > 0) {
+      this.apiUrl = modelUri.slice(0, hashIndex);
+      this.modelName = modelUri.slice(hashIndex + 1);
+    } else {
+      this.apiUrl = modelUri;
+      // Try to extract model name from URL path or use default
+      const url = new URL(modelUri);
+      const pathParts = url.pathname.split("/");
+      this.modelName = pathParts[pathParts.length - 1] || "embedding-model";
+    }
+  }
+
+  async init(): Promise<LlmResult<void>> {
+    // Test connection with a simple embedding
+    const result = await this.embed("test");
+    if (!result.ok) {
+      return result;
+    }
+    return { ok: true, value: undefined };
+  }
+
+  async embed(text: string): Promise<LlmResult<number[]>> {
+    try {
+      const response = await fetch(this.apiUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          input: text,
+          model: this.modelName,
+        }),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        return {
+          ok: false,
+          error: inferenceFailedError(
+            this.modelUri,
+            new Error(`HTTP ${response.status}: ${errorText}`)
+          ),
+        };
+      }
+
+      const data = (await response.json()) as OpenAIEmbeddingResponse;
+      const vector = data.data[0]?.embedding;
+
+      if (!vector || !Array.isArray(vector)) {
+        return {
+          ok: false,
+          error: inferenceFailedError(
+            this.modelUri,
+            new Error("Invalid response format: missing embedding")
+          ),
+        };
+      }
+
+      // Cache dimensions on first call
+      if (this.dims === null) {
+        this.dims = vector.length;
+      }
+
+      return { ok: true, value: vector };
+    } catch (e) {
+      return {
+        ok: false,
+        error: inferenceFailedError(
+          this.modelUri,
+          e instanceof Error ? e : new Error(String(e))
+        ),
+      };
+    }
+  }
+
+  async embedBatch(texts: string[]): Promise<LlmResult<number[][]>> {
+    try {
+      const response = await fetch(this.apiUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          input: texts,
+          model: this.modelName,
+        }),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        return {
+          ok: false,
+          error: inferenceFailedError(
+            this.modelUri,
+            new Error(`HTTP ${response.status}: ${errorText}`)
+          ),
+        };
+      }
+
+      const data = (await response.json()) as OpenAIEmbeddingResponse;
+
+      // Sort by index to maintain order
+      const sorted = data.data.sort((a, b) => a.index - b.index);
+      const vectors = sorted.map((item) => item.embedding);
+
+      // Validate all embeddings
+      for (let i = 0; i < vectors.length; i++) {
+        if (!vectors[i] || !Array.isArray(vectors[i])) {
+          return {
+            ok: false,
+            error: inferenceFailedError(
+              this.modelUri,
+              new Error(`Invalid embedding at index ${i}`)
+            ),
+          };
+        }
+      }
+
+      // Cache dimensions on first call
+      if (this.dims === null && vectors.length > 0 && vectors[0]) {
+        this.dims = vectors[0].length;
+      }
+
+      return { ok: true, value: vectors };
+    } catch (e) {
+      return {
+        ok: false,
+        error: inferenceFailedError(
+          this.modelUri,
+          e instanceof Error ? e : new Error(String(e))
+        ),
+      };
+    }
+  }
+
+  dimensions(): number {
+    if (this.dims === null) {
+      throw new Error("Call init() or embed() first to initialize dimensions");
+    }
+    return this.dims;
+  }
+
+  async dispose(): Promise<void> {
+    // Nothing to dispose for HTTP client
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// URI Detection
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function isHttpModelUri(uri: string): boolean {
+  return uri.startsWith("http://") || uri.startsWith("https://");
+}

package/src/llm/httpGeneration.ts

@@ -0,0 +1,119 @@
+/**
+ * HTTP-based generation port implementation.
+ * Calls OpenAI-compatible chat completion endpoints.
+ *
+ * @module src/llm/httpGeneration
+ */
+
+import type { GenerationPort, GenParams, LlmResult } from "./types";
+
+import { inferenceFailedError } from "./errors";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+interface OpenAIChatResponse {
+  id: string;
+  object: string;
+  created: number;
+  model: string;
+  choices: Array<{
+    index: number;
+    message: {
+      role: string;
+      content: string;
+      reasoning_content?: string; // Qwen3 thinking mode
+    };
+    finish_reason: string;
+  }>;
+  usage: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+
+export class HttpGeneration implements GenerationPort {
+  private readonly apiUrl: string;
+  private readonly modelName: string;
+  readonly modelUri: string;
+
+  constructor(modelUri: string) {
+    this.modelUri = modelUri;
+    // Parse URI: http://host:port/v1/chat/completions#modelname
+    const hashIndex = modelUri.indexOf("#");
+    if (hashIndex > 0) {
+      this.apiUrl = modelUri.slice(0, hashIndex);
+      this.modelName = modelUri.slice(hashIndex + 1);
+    } else {
+      this.apiUrl = modelUri;
+      // Try to extract model name from URL path or use default
+      const url = new URL(modelUri);
+      const pathParts = url.pathname.split("/");
+      this.modelName = pathParts[pathParts.length - 1] || "llama";
+    }
+  }
+
+  async generate(
+    prompt: string,
+    params?: GenParams
+  ): Promise<LlmResult<string>> {
+    try {
+      const response = await fetch(this.apiUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          model: this.modelName,
+          messages: [{ role: "user", content: prompt }],
+          temperature: params?.temperature ?? 0,
+          max_tokens: params?.maxTokens ?? 256,
+          stop: params?.stop,
+          seed: params?.seed,
+        }),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        return {
+          ok: false,
+          error: inferenceFailedError(
+            this.modelUri,
+            new Error(`HTTP ${response.status}: ${errorText}`)
+          ),
+        };
+      }
+
+      const data = (await response.json()) as OpenAIChatResponse;
+      const content = data.choices[0]?.message?.content ?? "";
+
+      return { ok: true, value: content };
+    } catch (e) {
+      return {
+        ok: false,
+        error: inferenceFailedError(
+          this.modelUri,
+          e instanceof Error ? e : new Error(String(e))
+        ),
+      };
+    }
+  }
+
+  async dispose(): Promise<void> {
+    // Nothing to dispose for HTTP client
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// URI Detection
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function isHttpGenUri(uri: string): boolean {
+  return uri.startsWith("http://") || uri.startsWith("https://");
+}

package/src/llm/httpRerank.ts

@@ -0,0 +1,191 @@
+/**
+ * HTTP-based rerank port implementation.
+ * Calls OpenAI-compatible completions endpoints for reranking.
+ *
+ * @module src/llm/httpRerank
+ */
+
+import type { LlmResult, RerankPort, RerankScore } from "./types";
+
+import { inferenceFailedError } from "./errors";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+interface OpenAICompletionResponse {
+  choices: Array<{
+    text: string;
+    index: number;
+    logprobs?: unknown;
+    finish_reason: string;
+  }>;
+  model: string;
+  usage: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+
+export class HttpRerank implements RerankPort {
+  private readonly apiUrl: string;
+  private readonly modelName: string;
+  private readonly instruction: string;
+  readonly modelUri: string;
+
+  constructor(modelUri: string) {
+    this.modelUri = modelUri;
+    // Parse URI: http://host:port/v1/completions#modelname
+    const hashIndex = modelUri.indexOf("#");
+    if (hashIndex > 0) {
+      this.apiUrl = modelUri.slice(0, hashIndex);
+      this.modelName = modelUri.slice(hashIndex + 1);
+    } else {
+      this.apiUrl = modelUri;
+      const url = new URL(modelUri);
+      const pathParts = url.pathname.split("/");
+      this.modelName = pathParts[pathParts.length - 1] || "reranker-model";
+    }
+    // Default instruction for retrieval tasks
+    this.instruction =
+      "Given a web search query, retrieve relevant passages that answer the query";
+  }
+
+  async rerank(
+    query: string,
+    documents: string[]
+  ): Promise<LlmResult<RerankScore[]>> {
+    if (documents.length === 0) {
+      return { ok: true, value: [] };
+    }
+
+    try {
+      // Build prompts for all documents
+      const prompts = documents.map((doc) => this.buildPrompt(query, doc));
+
+      // Score all documents in a single batch request
+      const scoresResult = await this.scoreBatch(prompts);
+
+      if (!scoresResult.ok) {
+        return { ok: false, error: scoresResult.error };
+      }
+
+      // Map scores back to document indices
+      const scores = scoresResult.value.map((score, index) => ({
+        index,
+        score,
+      }));
+
+      // Sort by score descending
+      scores.sort((a, b) => b.score - a.score);
+
+      // Assign ranks
+      const rankedScores: RerankScore[] = scores.map((item, rank) => ({
+        index: item.index,
+        score: item.score,
+        rank: rank + 1,
+      }));
+
+      return { ok: true, value: rankedScores };
+    } catch (e) {
+      return {
+        ok: false,
+        error: inferenceFailedError(
+          this.modelUri,
+          e instanceof Error ? e : new Error(String(e))
+        ),
+      };
+    }
+  }
+
+  private buildPrompt(query: string, document: string): string {
+    return `<Instruct>: ${this.instruction}\n<Query>: ${query}\n<Document>: ${document}\n<Score>:`;
+  }
+
+  private async scoreBatch(prompts: string[]): Promise<LlmResult<number[]>> {
+    try {
+      const response = await fetch(this.apiUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          model: this.modelName,
+          prompt: prompts, // Array of prompts for batching
+          max_tokens: 10, // Just need the score
+          temperature: 0, // Deterministic
+          stop: ["\n", "<"],
+        }),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        return {
+          ok: false,
+          error: inferenceFailedError(
+            this.modelUri,
+            new Error(`HTTP ${response.status}: ${errorText}`)
+          ),
+        };
+      }
+
+      const data = (await response.json()) as OpenAICompletionResponse;
+
+      // Parse scores from all choices
+      const scores: number[] = data.choices.map((choice) => {
+        const text = choice.text?.trim() ?? "";
+
+        // Parse score from response
+        const scoreMatch = text.match(/[-+]?[0-9]*\.?[0-9]+/);
+        if (!scoreMatch) {
+          return 0; // Default low score if no number found
+        }
+
+        const score = parseFloat(scoreMatch[0]);
+        return this.normalizeScore(score);
+      });
+
+      return { ok: true, value: scores };
+    } catch (e) {
+      return {
+        ok: false,
+        error: inferenceFailedError(
+          this.modelUri,
+          e instanceof Error ? e : new Error(String(e))
+        ),
+      };
+    }
+  }
+
+  private normalizeScore(score: number): number {
+    // Handle different score ranges
+    if (score < -10 || score > 10) {
+      // Likely logit or unbounded, apply sigmoid-like normalization
+      return 1 / (1 + Math.exp(-score));
+    } else if (score >= 0 && score <= 1) {
+      // Already normalized
+      return score;
+    } else {
+      // Assume -5 to 5 range, normalize to 0-1
+      const normalized = (score + 5) / 10;
+      return Math.max(0, Math.min(1, normalized));
+    }
+  }
+
+  async dispose(): Promise<void> {
+    // Nothing to dispose for HTTP client
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// URI Detection
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function isHttpRerankUri(uri: string): boolean {
+  return uri.startsWith("http://") || uri.startsWith("https://");
+}

package/src/llm/index.ts

@@ -26,6 +26,12 @@ export {
 } from "./errors";
 // Adapter
 export { createLlmAdapter, LlmAdapter } from "./nodeLlamaCpp/adapter";
+// HTTP Embedding
+export { HttpEmbedding, isHttpModelUri } from "./httpEmbedding";
+// HTTP Generation
+export { HttpGeneration, isHttpGenUri } from "./httpGeneration";
+// HTTP Rerank
+export { HttpRerank, isHttpRerankUri } from "./httpRerank";
 // Lifecycle
 export {
   getModelManager,

package/src/llm/nodeLlamaCpp/adapter.ts

@@ -16,6 +16,9 @@ import type {
 } from "../types";
 
 import { ModelCache } from "../cache";
+import { HttpEmbedding, isHttpModelUri } from "../httpEmbedding";
+import { HttpGeneration, isHttpGenUri } from "../httpGeneration";
+import { HttpRerank, isHttpRerankUri } from "../httpRerank";
 import { getActivePreset, getModelConfig } from "../registry";
 import { NodeLlamaCppEmbedding } from "./embedding";
 import { NodeLlamaCppGeneration } from "./generation";
@@ -54,6 +57,7 @@ export class LlmAdapter {
 
   /**
    * Create an embedding port.
+   * Supports HTTP endpoints for remote embedding models.
    * With options.policy.allowDownload=true, auto-downloads if not cached.
    */
   async createEmbeddingPort(
@@ -64,6 +68,17 @@ export class LlmAdapter {
     const uri = modelUri ?? preset.embed;
     const policy = options?.policy ?? DEFAULT_POLICY;
 
+    // Use HTTP embedding for remote endpoints
+    if (isHttpModelUri(uri)) {
+      const httpEmbed = new HttpEmbedding(uri);
+      // Initialize to verify connection and get dimensions
+      const initResult = await httpEmbed.init();
+      if (!initResult.ok) {
+        return { ok: false, error: initResult.error };
+      }
+      return { ok: true, value: httpEmbed };
+    }
+
     // Ensure model is available (downloads if policy allows)
     const resolved = await this.cache.ensureModel(
       uri,
@@ -83,6 +98,7 @@ export class LlmAdapter {
 
   /**
    * Create a generation port.
+   * Supports HTTP endpoints for remote generation models.
    * With options.policy.allowDownload=true, auto-downloads if not cached.
    */
   async createGenerationPort(
@@ -93,6 +109,12 @@ export class LlmAdapter {
     const uri = modelUri ?? preset.gen;
     const policy = options?.policy ?? DEFAULT_POLICY;
 
+    // Use HTTP generation for remote endpoints
+    if (isHttpGenUri(uri)) {
+      const httpGen = new HttpGeneration(uri);
+      return { ok: true, value: httpGen };
+    }
+
     // Ensure model is available (downloads if policy allows)
     const resolved = await this.cache.ensureModel(
       uri,
@@ -112,6 +134,7 @@ export class LlmAdapter {
 
   /**
    * Create a rerank port.
+   * Supports HTTP endpoints for remote reranking models.
    * With options.policy.allowDownload=true, auto-downloads if not cached.
    */
   async createRerankPort(
@@ -122,6 +145,12 @@ export class LlmAdapter {
     const uri = modelUri ?? preset.rerank;
     const policy = options?.policy ?? DEFAULT_POLICY;
 
+    // Use HTTP rerank for remote endpoints
+    if (isHttpRerankUri(uri)) {
+      const httpRerank = new HttpRerank(uri);
+      return { ok: true, value: httpRerank };
+    }
+
     // Ensure model is available (downloads if policy allows)
     const resolved = await this.cache.ensureModel(
       uri,

package/src/mcp/AGENTS.md

@@ -40,14 +40,16 @@ export const toolName: Tool = {
   description: "What this tool does",
   inputSchema: {
     type: "object",
-    properties: { /* ... */ },
+    properties: {
+      /* ... */
+    },
     required: ["query"],
   },
 };
 
 export async function handleToolName(
   args: ToolArgs,
-  store: SqliteAdapter,
+  store: SqliteAdapter
   // ... other ports
 ): Promise<CallToolResult> {
   // 1. Validate args

package/src/mcp/CLAUDE.md

@@ -40,14 +40,16 @@ export const toolName: Tool = {
   description: "What this tool does",
   inputSchema: {
     type: "object",
-    properties: { /* ... */ },
+    properties: {
+      /* ... */
+    },
     required: ["query"],
   },
 };
 
 export async function handleToolName(
   args: ToolArgs,
-  store: SqliteAdapter,
+  store: SqliteAdapter
   // ... other ports
 ): Promise<CallToolResult> {
   // 1. Validate args

package/src/serve/AGENTS.md

@@ -52,7 +52,7 @@ interface ServerContext {
   embedPort: EmbeddingPort | null;
   genPort: GenerationPort | null;
   rerankPort: RerankPort | null;
-  capabilities: { bm25, vector, hybrid, answer };
+  capabilities: { bm25; vector; hybrid; answer };
 }
 ```
 
@@ -113,7 +113,7 @@ Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully suppor
 Server example:
 
 ```ts
-import index from "./index.html"
+import index from "./index.html";
 
 Bun.serve({
   routes: {
@@ -134,13 +134,13 @@ Bun.serve({
     },
     close: (ws) => {
       // handle close
-    }
+    },
   },
   development: {
     hmr: true,
     console: true,
-  }
-})
+  },
+});
 ```
 
 HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
@@ -160,7 +160,7 @@ With the following `frontend.tsx`:
 import React from "react";
 
 // import .css files directly and it works
-import './index.css';
+import "./index.css";
 
 import { createRoot } from "react-dom/client";
 

package/src/serve/CLAUDE.md

@@ -52,7 +52,7 @@ interface ServerContext {
   embedPort: EmbeddingPort | null;
   genPort: GenerationPort | null;
   rerankPort: RerankPort | null;
-  capabilities: { bm25, vector, hybrid, answer };
+  capabilities: { bm25; vector; hybrid; answer };
 }
 ```
 
@@ -113,7 +113,7 @@ Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully suppor
 Server example:
 
 ```ts
-import index from "./index.html"
+import index from "./index.html";
 
 Bun.serve({
   routes: {
@@ -134,13 +134,13 @@ Bun.serve({
     },
     close: (ws) => {
       // handle close
-    }
+    },
   },
   development: {
     hmr: true,
     console: true,
-  }
-})
+  },
+});
 ```
 
 HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
@@ -160,7 +160,7 @@ With the following `frontend.tsx`:
 import React from "react";
 
 // import .css files directly and it works
-import './index.css';
+import "./index.css";
 
 import { createRoot } from "react-dom/client";
 

package/src/serve/public/app.tsx

@@ -96,7 +96,50 @@ function App() {
 
   return (
     <CaptureModalProvider>
-      <Page navigate={navigate} />
+      <div className="flex min-h-screen flex-col">
+        <div className="flex-1">
+          <Page navigate={navigate} />
+        </div>
+        <footer className="border-t border-border/50 bg-background/80 py-4 text-center text-muted-foreground text-sm">
+          <div className="flex items-center justify-center gap-4">
+            <a
+              className="transition-colors hover:text-foreground"
+              href="https://github.com/gmickel/gno"
+              rel="noopener noreferrer"
+              target="_blank"
+            >
+              GitHub
+            </a>
+            <span className="text-border">·</span>
+            <a
+              className="transition-colors hover:text-foreground"
+              href="https://discord.gg/nHEmyJB5tg"
+              rel="noopener noreferrer"
+              target="_blank"
+            >
+              Discord
+            </a>
+            <span className="text-border">·</span>
+            <a
+              className="transition-colors hover:text-foreground"
+              href="https://gno.sh"
+              rel="noopener noreferrer"
+              target="_blank"
+            >
+              gno.sh
+            </a>
+            <span className="text-border">·</span>
+            <a
+              className="transition-colors hover:text-foreground"
+              href="https://twitter.com/gmickel"
+              rel="noopener noreferrer"
+              target="_blank"
+            >
+              Twitter
+            </a>
+          </div>
+        </footer>
+      </div>
       <HelpButton onClick={() => setShortcutHelpOpen(true)} />
       <ShortcutHelpModal
         onOpenChange={setShortcutHelpOpen}

package/vendor/fts5-snowball/README.md

@@ -24,13 +24,15 @@ The Snowball stemmer supports: Arabic, Basque, Catalan, Danish, Dutch, English,
 ## Usage
 
 ```typescript
-import { Database } from 'bun:sqlite';
+import { Database } from "bun:sqlite";
 
 // Load extension
-db.loadExtension('vendor/fts5-snowball/darwin-arm64/fts5stemmer.dylib');
+db.loadExtension("vendor/fts5-snowball/darwin-arm64/fts5stemmer.dylib");
 
 // Create FTS table with snowball tokenizer
-db.exec(`CREATE VIRTUAL TABLE docs USING fts5(content, tokenize='snowball english')`);
+db.exec(
+  `CREATE VIRTUAL TABLE docs USING fts5(content, tokenize='snowball english')`
+);
 ```
 
 ## License