chemenu/raw/documents/qmd - GitHub Repository.md

qmd - GitHub Repository (tobi/qmd)

Source: https://github.com/tobi/qmd Retrieved: 2026-09-02, via https://api.github.com/repos/tobi/qmd, https://api.github.com/repos/tobi/qmd/languages, and the raw README/package.json at the main branch HEAD (pushed_at: 2026-08-18T14:26:31Z at retrieval time). Fidelity: the API JSON fields are quoted verbatim; the README/package.json excerpts below are quoted verbatim from the fetched files, trimmed to what backs the corrected claims on kb/entities/tools/qmd.md - not a full copy of either file.

Repository metadata (GitHub API)

{
  "full_name": "tobi/qmd",
  "description": "mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local",
  "language": "TypeScript",
  "html_url": "https://github.com/tobi/qmd",
  "license": {"key": "mit", "name": "MIT License", "spdx_id": "MIT"}
}

Byte-weighted language breakdown (/languages endpoint):

{
  "TypeScript": 1597168,
  "Python": 200880,
  "Shell": 26136,
  "JavaScript": 23132,
  "Nix": 5984,
  "Just": 1081,
  "Dockerfile": 1074
}

package.json dependencies

{
  "name": "@tobilu/qmd",
  "dependencies": {
    "@modelcontextprotocol/server": "2.0.0",
    "better-sqlite3": "^13.0.3",
    "fast-glob": "3.3.3",
    "node-llama-cpp": "3.20.0",
    "picomatch": "4.0.5",
    "sqlite-vec": "0.1.9",
    "tree-sitter-go": "0.25.0",
    "tree-sitter-python": "0.25.0",
    "tree-sitter-rust": "0.24.0",
    "tree-sitter-typescript": "0.23.2",
    "web-tree-sitter": "0.26.12",
    "yaml": "2.9.0",
    "zod": "4.2.1"
  }
}

README excerpts

Opening description (README.md, line 5):

QMD combines BM25 full-text search, vector semantic search, and LLM re-ranking—all running locally via node-llama-cpp with GGUF models.

Install ("Quick Start" section):

# Install globally (Node or Bun)
npm install -g @tobilu/qmd
# or
bun install -g @tobilu/qmd

# Or run directly
npx @tobilu/qmd ...
bunx @tobilu/qmd ...

Scoring table (architecture section):

Stage	Method	Formula	Range
FTS (BM25)	SQLite FTS5 BM25	Math.abs(score)	0 to ~25+
Vector	Cosine distance	1 / (1 + distance)	0.0 to 1.0
Reranker	LLM 0-10 rating	score / 10	0.0 to 1.0

Diagnostic command comment, confirming sqlite-vec is the vector index used at runtime, not only a listed dependency:

# Diagnose the install (runtime, sqlite-vec, embedding fingerprints, GPU probe)

Not extracted

The full README (1301 lines: library API, MCP server usage, tree-sitter code-chunking options, config file reference, CLI subcommand reference) - only the excerpts backing the corrected qmd.md claims (language, runtime, install method, search/rerank stack) were pulled. A future qmd page expansion covering its library API or MCP server would need a fresh fetch, not a reuse of this file's ## Not extracted judgment.