torben
778764de4d
Files changed: - kb/concepts/Delete Rather Than Anonymize.md - kb/concepts/Dual Licensing by File Plan.md - kb/concepts/Publish-Remote Gate.md - kb/entities/INDEX.md - kb/entities/tools/qmd.md - kb/index.md - kb/log.md - kb/provenance.md - kb/sources/INDEX.md - kb/sources/Source - qmd - GitHub Repository.md - raw/documents/qmd - GitHub Repository.md
102 lines
2.9 KiB
Markdown
102 lines
2.9 KiB
Markdown
# 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)
|
|
|
|
```json
|
|
{
|
|
"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):
|
|
|
|
```json
|
|
{
|
|
"TypeScript": 1597168,
|
|
"Python": 200880,
|
|
"Shell": 26136,
|
|
"JavaScript": 23132,
|
|
"Nix": 5984,
|
|
"Just": 1081,
|
|
"Dockerfile": 1074
|
|
}
|
|
```
|
|
|
|
## `package.json` dependencies
|
|
|
|
```json
|
|
{
|
|
"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):
|
|
|
|
```sh
|
|
# 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.
|