Skip to Content
QMD Search SDKCLI & Single-Binary

CLI & Single-Binary

⚠️

Known Issue — Die Single-Binary wird zwar gebaut und veroeffentlicht, startet aber aktuell nicht aufgrund einer Inkompatibilitaet zwischen Bun und better-sqlite3 (nativer Node.js C++ Addon, ABI Mismatch). Siehe oven-sh/bun#16050 . Nutze stattdessen die Docker-Images oder die NPM-Pakete.

qmd-search kann als Single-Binary ohne Node.js oder Docker betrieben werden (kompiliert mit Bun).

Installation

curl -fsSL https://marketplace.processcube.io/qmd-search/install | bash

Oder manuell von GitHub Releases .

Unterstuetzte Plattformen

PlattformBinaryExtension
macOS arm64 (Apple Silicon)qmd-search-darwin-arm64vec0.dylib
Linux x64qmd-search-linux-x64vec0.so
Windows x64qmd-search-windows-x64vec0.dll

Befehle

Index erstellen

qmd-search index --config ./config.json

Server starten

qmd-search serve --db ./data/index.sqlite --port 3001

Mit MCP-Endpoint:

qmd-search serve --db ./data/index.sqlite --mcp

Einmalige Suche

qmd-search search --db ./data/index.sqlite -q "deployment"

JSON-Ausgabe (fuer Scripting):

qmd-search search --db ./data/index.sqlite -q "deployment" --json

Vollstaendige Optionen

qmd-search — Hybrid-Suche (BM25 + Vektor) als Single-Binary

Befehle:
  index   --config <file> [--output <db>]   Index erstellen/aktualisieren
  serve   --db <file> [--port 3001] [--mcp] Such-Server starten
  search  --db <file> -q <query> [--json]   Einmalige Suche

Umgebungsvariablen:
  QMD_INDEX_PATH      Pfad zur SQLite-Datenbank
  QMD_EMBED_PROVIDER  none | openai | voyage
  QMD_SEARCH_MODE     fts | hybrid
  QMD_API_KEY         API-Key fuer Auth (Serve-Modus)
  GITHUB_TOKEN        Fuer GitHub-Plugin (Index-Modus)

Dateistruktur

Nach Installation:

~/.qmd-search/
  qmd-search              # Binary
  extensions/
    vec0.dylib            # SQLite-Extension (oder vec0.so auf Linux)

Plugins nachladen

Eigene Plugins werden als .ts- oder .js-Dateien im plugins/-Verzeichnis abgelegt:

~/.qmd-search/
  qmd-search
  extensions/
    vec0.dylib
  plugins/
    confluence-source.ts   # Content-Source Plugin
    odoo-auth.ts           # Auth Plugin

Die Bun-Runtime in der Binary kann TypeScript direkt ausfuehren — kein Build-Schritt noetig.

Update / Deinstallation

# Update
curl -fsSL https://marketplace.processcube.io/qmd-search/install | bash
 
# Spezifische Version
QMD_VERSION=qmd-search-v0.2.0 curl -fsSL https://marketplace.processcube.io/qmd-search/install | bash
 
# Deinstallation
rm -rf ~/.qmd-search /usr/local/bin/qmd-search
AuthentifizierungDocker