Repolode
MinishLab

MinishLab/semble

Библиотека для поиска кода, которая возвращает AI-агентам только нужные фрагменты и работает на CPU без API-ключей.

Звёзды
6,367
Форки
286
Открытые issues
7
Последний коммит
4 дня назад

Что это?

Semble — библиотека для поиска кода, предназначенная для coding-агентов, таких как Claude Code, Cursor и Codex. Она принимает запрос на естественном языке или фрагмент кода и возвращает подходящие фрагменты из репозитория, вместо того чтобы агент искал ключевые слова через grep и читал файлы целиком. Так на изучение кодовой базы уходит меньше токенов.

Библиотека разбивает файлы на фрагменты с учётом структуры кода с помощью tree-sitter и оценивает запрос двумя поисковыми механизмами: статическими эмбеддингами Model2Vec для семантического сходства и BM25 для поиска по идентификаторам и названиям API. Результаты объединяются с помощью Reciprocal Rank Fusion и повторно ранжируются с учётом таких сигналов, как повышение приоритета определений и штрафы для тестовых файлов. Индексы кэшируются и обновляются инкрементально при изменении файлов.

Semble можно использовать как MCP-сервер, CLI с интеграцией в AGENTS.md или через Python API. Библиотека принимает локальные пути и git URL, умеет искать сразу по нескольким репозиториям и поддерживает контент типов code, docs и config.

Ключевые возможности

  • 01Возвращает ранжированные фрагменты кода для запросов на естественном языке и запросов с кодом.
  • 02Работает на CPU без API-ключей, GPU и внешних сервисов.
  • 03Предоставляет MCP-сервер с инструментами поиска и поиска связанного кода.
  • 04Включает CLI и Python-библиотеку для скриптов и собственных инструментов.
  • 05Ищет по нескольким локальным или удалённым git-репозиториям как по единому корпусу.
  • 06Учитывает .gitignore и .sembleignore и инкрементально обновляет индексы.

Сценарии использования

  • Помогать coding-агенту находить нужные функции перед редактированием большой кодовой базы.
  • Искать endpoint или определение сразу в нескольких репозиториях микросервисов.
  • Сокращать расход токенов в рабочих процессах агентов, которые иначе используют grep и читают файлы целиком.
  • Автоматизировать поиск кода в CI или изолированных средах без сетевых API-вызовов.

Быстрый старт

  1. 1

    Установите uv (см. руководство по установке uv)

  2. 2

    Установите semble как инструмент uv

    uv tool install semble
  3. 3

    Запустите интерактивный установщик, чтобы настроить интеграции с агентами

    semble install

Что важно знать

  • В README указано, что при первом использовании с Hugging Face загружается определённая модель эмбеддингов, поэтому один раз потребуется подключение к сети.

В подборках

Темы

Частые вопросы

Что такое semble?
Библиотека для поиска кода, которая возвращает AI-агентам только нужные фрагменты и работает на CPU без API-ключей. Semble — библиотека для поиска кода, предназначенная для coding-агентов, таких как Claude Code, Cursor и Codex. Она принимает запрос на естественном языке или фрагмент кода и возвращает подходящие фрагменты из репозитория, вместо того чтобы агент искал ключевые слова через grep и читал файлы целиком. Так на изучение кодовой базы уходит меньше токенов.
semble можно использовать бесплатно? Какая у него лицензия?
semble распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
semble всё ещё поддерживается?
Активно поддерживается. Последний коммит в semble — 3 нояб. 2026 г..
Для чего можно использовать semble?
Помогать coding-агенту находить нужные функции перед редактированием большой кодовой базы. Искать endpoint или определение сразу в нескольких репозиториях микросервисов. Сокращать расход токенов в рабочих процессах агентов, которые иначе используют grep и читают файлы целиком. Автоматизировать поиск кода в CI или изолированных средах без сетевых API-вызовов.
Как установить semble?
Установите uv (см. руководство по установке uv) Установите semble как инструмент uv: uv tool install semble Запустите интерактивный установщик, чтобы настроить интеграции с агентами: semble install
Где скачать semble?
Исходный код и инструкции по установке — на GitHub: https://github.com/MinishLab/semble

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

CLI для семантического поиска по коду с локальными эмбеддингами, анализом графа вызовов и MCP-сервером для AI-агентов — с приоритетом конфиденциальности.

1,9 тыс.+11 за неделю160CMITАктивно поддерживаетсяОбновлён 5 дней назад