Community画像github.com

gemma-embed-search

画像、音声、テキストファイルをローカルのマルチモーダル埋め込みモデルでインデックス化し、自然言語で検索します。再開可能なベクターインデックスを構築し、セマンティック類似度でファイルをランク付けします。

gemma-embed-search とは?

Gemma Embed Searchは、ユーザーのローカルマシン上で動作するマルチモーダル埋め込みモデル(例:EmbeddingGemma 2)を使用して、画像、音声、テキストファイルを単一の埋め込み空間にインデックス化し、自然言語クエリで意味的に検索できるスキルです。 主な特徴は、llama.cppのllama-serverなど、OpenAI互換の/v1/embeddingsエンドポイントを提供するローカルサーバーと連携することです。これにより、データが外部にアップロードされることはありません。`scripts/embed_search.py`スクリプトは、サーバーの健全性確認(doctor)、接続設定の保存(init)、ファイルのインデックス化(index)、クエリによる検索(search)の4つの機能を提供します。検索結果はスコア順に表示され、色フィルタリング、複数ファセットのANDクエリ、JSON出力、HTMLコンタクトシート生成などが可能です。 用途としては、ローカル写真ライブラリからの特定の被写体の検索、音声クリップの内容に基づく検索、文書の意味的検索などが考えられます。また、インデックスは増分的かつ再開可能で、中断後も続きから再開できます。 対応プラットフォームは、Linux、macOS、Windowsです。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/claudejaune/gemma-embed-search/tree/HEAD

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Gemma Embed Search

意味によってローカルファイルを取得します。1つの埋め込み空間に画像、音声、テキストが保持されるため、入力されたクエリに一致する画像、クリップ、またはドキュメントが返されます。モデルはユーザーのハードウェア上のローカルサーバーで動作し、どこにもアップロードされません。

scripts/embed_search.pyは4つの処理を行います: doctorはサーバーをチェックし、initは接続を保存し、indexはファイルをキャッシュに埋め込み、searchはクエリに対してランク付けします。

ローカル設定

設定はconfig.jsonに保存され、このファイルには保存しません:

  • Linux および macOS: ~/.config/gemma-embed-search/config.json
  • Windows: %USERPROFILE%\.config\gemma-embed-search\config.json

最初にそのファイルを読み取ります。それにurlとmodelがある場合、以降のすべてのコマンドは接続フラグなしで動作し、ステップ2をスキップできます。

ファイルがないか不完全な場合は、ユーザーにサーバーURLとインデックス化するフォルダを尋ね、doctorを実行してサーバーが実際に提供するモデルをリストアップし、initを実行してファイルを書き込みます。initはマージされるため、一度に1つの設定を追加しても安全です。モデル名を推測しないでください。

このフォルダからconfig.example.jsonをそのパスにコピーして編集することは、initと同じ処理を行います。ファイルを直接編集したいユーザー向けです。`

関連スキル