MinishLab/semble

これは何？

主な機能

• 01自然言語またはコードのクエリに対し、ランキング付きのコードスニペットを返す。
• 02APIキー、GPU、外部サービスを必要とせず、CPU上で動作する。
• 03検索や関連項目の特定に使えるツールを備えたMCPサーバーを提供する。
• 04スクリプトや独自ツール向けにCLIとPythonライブラリを提供する。
• 05複数のローカルまたはリモートのgitリポジトリを、ひとつのコーパスとして検索する。
• 06.gitignoreと.sembleignoreを尊重し、インデックスを差分更新する。

ユースケース

• 大規模なコードベースを編集する前に、コーディングエージェントが関連する関数を見つけられるようにする。
• 複数のマイクロサービスリポジトリを横断して、エンドポイントや定義を検索する。
• grepしてファイル全体を読むエージェントのワークフローで、トークン使用量を削減する。
• ネットワーク経由のAPI呼び出しをせずに、CIやサンドボックス環境でコード検索をスクリプトから実行する。

クイックスタート

1. 1

   uvをインストールします（uvのインストールガイドを参照）

2. 2

   uvのツールとしてsembleをインストールします

   uv tool install semble
3. 3

   対話型インストーラーを実行して、エージェント連携を設定します

   semble install

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

• !READMEによると、初回使用時にHugging Faceから特定の埋め込みモデルをダウンロードするため、一度ネットワーク接続が必要です。

収録されている特集

トピック

よくある質問

semble とは？

APIキー不要でCPU上で動作し、AIコーディングエージェントに関連するコードスニペットだけを返すコード検索ライブラリ。 Sembleは、Claude Code、Cursor、Codexなどのコーディングエージェント向けに作られたコード検索ライブラリです。自然言語またはコードのクエリを渡すと、エージェントにキーワードをgrepさせてファイル全体を読ませる代わりに、リポジトリから該当するスニペットを返し、探索に費やすトークンを削減します。

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

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

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

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

semble は何に使えますか？

大規模なコードベースを編集する前に、コーディングエージェントが関連する関数を見つけられるようにする。 複数のマイクロサービスリポジトリを横断して、エンドポイントや定義を検索する。 grepしてファイル全体を読むエージェントのワークフローで、トークン使用量を削減する。 ネットワーク経由のAPI呼び出しをせずに、CIやサンドボックス環境でコード検索をスクリプトから実行する。

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

uvをインストールします（uvのインストールガイドを参照） uvのツールとしてsembleをインストールします: uv tool install semble 対話型インストーラーを実行して、エージェント連携を設定します: semble install

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

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