tobi/qmd

これは何？

主な機能

• 01BM25によるキーワード検索、ベクトル類似度検索、LLMによる再ランキングを組み合わせたハイブリッド検索
• 02node-llama-cppを通じてGGUFモデルを使用し、すべてローカルで実行
• 03名前付きコレクションにパスベースのコンテキストを設定でき、検索結果とともに返却
• 04連携用のMCPサーバー、HTTPエンドポイント、TypeScript SDK
• 05エージェントのワークフローを想定したJSONおよびファイル一覧形式での出力
• 06型付きYAML frontmatterによるメタデータフィルタリングと、コードファイル向けの任意のAST対応チャンク分割

ユースケース

• 個人用のObsidian風ノートフォルダを、完全一致する単語ではなく意味で検索する
• チームの共有フォルダから過去の会議の文字起こしや決定事項を探す
• プロジェクトのドキュメントを対象としたローカル検索ツールをAIエージェントに提供する
• コードベースのドキュメントやソースファイルをインデックス化してセマンティック検索する

クイックスタート

1. 1

   npmでグローバルにインストールする

   npm install -g @tobilu/qmd
2. 2

   ノートのコレクションを追加する

   qmd collection add ~/notes --name notes
3. 3

   セマンティック検索用の埋め込みを生成する

   qmd embed
4. 4

   リランキングを使ってハイブリッド検索を実行する

   qmd query "quarterly planning process"

使う前に知っておきたいこと

• !セマンティック検索とリランキングには、node-llama-cpp経由でローカルのGGUFモデルを使用するため、ディスク容量とメモリが必要です。
• !検索で最良の結果を得るには、コレクションとコンテキストを追加し、埋め込みを生成しておく必要があります。

トピック

よくある質問

qmd とは？

Markdownのメモ、会議の文字起こし、ドキュメントを対象に、BM25、ベクトル検索、LLMによる再ランキングを組み合わせたローカル実行型のCLI検索エンジン。 QMD（Query Markup Documents）は、Markdownのメモ、会議の文字起こし、ドキュメント、ナレッジベースなど、個人やチームのナレッジを検索するオンデバイス検索エンジンです。ソースを名前付きコレクションに整理し、コマンドライン、TypeScript SDK、またはMCPサーバーから、キーワードや自然言語で検索できます。

qmd は無料で使えますか？ライセンスは？

qmd は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

qmd は今もメンテナンスされていますか？

活発にメンテナンス中。qmd の最終コミットは 2026年10月15日 です。

qmd は何に使えますか？

個人用のObsidian風ノートフォルダを、完全一致する単語ではなく意味で検索する チームの共有フォルダから過去の会議の文字起こしや決定事項を探す プロジェクトのドキュメントを対象としたローカル検索ツールをAIエージェントに提供する コードベースのドキュメントやソースファイルをインデックス化してセマンティック検索する

qmd のインストール方法は？

npmでグローバルにインストールする: npm install -g @tobilu/qmd ノートのコレクションを追加する: qmd collection add ~/notes --name notes セマンティック検索用の埋め込みを生成する: qmd embed リランキングを使ってハイブリッド検索を実行する: qmd query "quarterly planning process"

qmd はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/tobi/qmd