qmd

Search local markdown notes and documents using hybrid BM25, vector, and LLM reranking retrieval.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/azaanaliraza/operarius --skill qmd-azaanaliraza
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qmd
Source: https://github.com/azaanaliraza/operarius/tree/main/src-tauri/bin/hermes/optional-skills/research/qmd
Command: npx skills add https://github.com/azaanaliraza/operarius --skill qmd-azaanaliraza

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @tobilu/qmd.

What problem does it solve? Finding information across large collections of personal notes, meeting transcripts, and documentation is slow with plain keyword grep and impossible with conceptual questions. This Skill indexes local text files and retrieves answers using keyword matching, semantic vector search, and LLM reranking, all running on-device with no cloud dependencies. ## Core Features & Use Cases - Three Search Modes: BM25 keyword search for exact terms, vector search for conceptual queries, and hybrid query mode combining both with LLM reranking for best quality. - Collection Management: Add directories as named collections, attach context descriptions to improve retrieval accuracy, and generate embeddings with a single command. - MCP Integration: Expose search tools directly to Hermes Agent via stdio or a persistent HTTP daemon that keeps models warm for fast repeated queries. - Use Case: A user asks "what decisions were made about the database migration" and the hybrid query pipeline searches meeting transcripts and project docs, returning reranked excerpts with document IDs for full retrieval. ## Quick Start Ask the agent to search your notes for a specific topic, for example: "Search my knowledge base for notes about the API redesign decisions."

Frequently Asked Questions about qmd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search my local notes and markdown files semantically?▼

Install qmd via npm, add your notes directory with qmd collection add, run qmd embed to generate vector embeddings, then use qmd vsearch for semantic queries or qmd query for hybrid search with reranking. Everything runs locally without cloud services.

What is the difference between qmd search, vsearch, and query?▼

qmd search runs BM25 keyword matching in about 0.2 seconds with no models loaded. qmd vsearch uses the embedding model for semantic search in about 3 seconds. qmd query combines both with query expansion and LLM reranking for the highest quality results.

Does qmd work with MCP and Hermes Agent?▼

Yes, qmd includes a built-in MCP server. Configure it in ~/.hermes/config.yaml using stdio mode with qmd mcp, or run qmd mcp --http --daemon for a persistent HTTP server on port 8181 that keeps models warm for faster queries.

Why is the first qmd query slow at around 19 seconds?▼

The cold start delay happens because the three GGUF models must load into memory on first use. Run the HTTP daemon mode to keep models warm, or use qmd search for BM25-only queries that need no models.

What are the system requirements for running qmd locally?▼

qmd requires Node.js version 22 or later and about 2GB of disk space for its three GGUF models. On macOS, you also need Homebrew SQLite because the system SQLite lacks extension loading support.