MinishLab/semble

Быстрый и точный поиск кода для агентов. Использует на ~98% меньше токенов, чем grep+read

Агенты⭐ 6 115Pythonпоследний релиз: v0.6.0
Открыть на GitHub ↗Сайт проекта ↗

Что это за инструмент

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

Зачем нужен

Инструмент позволяет агентам (например, Claude Code, Cursor, Codex) мгновенно находить релевантные фрагменты кода по текстовому запросу, экономя до 98% токенов по сравнению с традиционным перебором файлов (grep+read). Работает локально на CPU без ключей API и внешних сервисов.

Что можно реализовать

  • Интеграция поиска в AI-кодинги через MCP Server для мгновенного доступа к контексту репозитория.
  • Автоматизированный поиск по коду в CI/CD пайплайнах или скриптах через CLI.
  • Создание специализированных под-агентов (sub-agents) для навигации по крупным кодовым базам.
  • Поиск по документации и конфигурации проекта наряду с исходным кодом.

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

  • Скорость: индексация репозитория занимает ~250 мс, ответ на запрос — ~1.5 мс.
  • Экономия токенов: использование ~98% меньше токенов по сравнению с grep+read.
  • Точность: качество поиска (NDCG@10 0.854) сопоставимо с тяжелыми трансформерами, но работает на CPU.
  • Простота установки: автоматическая настройка для популярных агентов через `semble install`.
  • Гибкость фильтрации: поддержка `.gitignore` и `.sembleignore` для управления индексацией.

👤 Кому подойдёт: разработчики, использующие AI-ассистентов для кодинга; DevOps-инженеры; архитекторы ПО, работающие с большими кодовыми базами.

Релизы

v0.6.0minor
🕐 10 дн назад · релиз на GitHub ↗

Релиз v0.6.0: добавлена поддержка поиска по нескольким репозиториям, прогресс-бар для CLI и исправлено удаление максимальной длины.

  • Added: Добавлена поддержка поиска по нескольким репозиториям одновременно.
  • Added: В интерфейс командной строки внедрены прогресс-бар и форматированный вывод.
  • Fixed: Исправлено удаление параметра максимальной длины (max length).
  • Fixed: Устранены ошибки в аннотациях, указывающих на устаревшие или несуществующие файлы.
  • Added: Добавлена опция бенчмарка только для Semble и исправлен подсчёт строк в чанках.
v0.5.6minor
🕐 16 дн назад · релиз на GitHub ↗

В Semble v0.5.6 добавлена настройка лимита размера файлов, исправлены права доступа в песочницах и ошибка двойной эмбеддинговой обработки.

  • Added: Максимальный размер файла теперь настраивается через переменную SEMBLE_MAX_FILE_BYTES с предупреждением при пропуске.
  • Fixed: Исправлены проблемы с правами доступа в песочницах (sandboxes).
  • Fixed: Устранена ошибка двойного прохода эмбеддинга при создании нового индекса.
v0.5.5minor
🕐 1 мес назад · релиз на GitHub ↗

В Semble v0.5.5 добавлена фильтрация контента для MCP и обновлена документация с альтернативными моделями.

  • Added: Добавлена фильтрация контента в MCP.
  • Обновлено описание README с указанием альтернативных моделей.
v0.5.4patch
🕐 1 мес назад · релиз на GitHub ↗

В Semble v0.5.4 добавлена команда для очистки орфанов и исправлены проблемы с консолью на Windows.

  • Added: Добавлена команда clear orphans для удаления орфанов.
  • Fixed: Исправлены проблемы с работой консоли в Windows.
v0.5.3minor
🕐 1 мес назад · релиз на GitHub ↗

Релиз v0.5.3: добавлен флаг --version, обновлена конфигурация Zed MCP, внедрены новые грамматики и расширен список бенчмарков.

  • Added: Добавлен флаг --version для команды semble и интеграции MCP.
  • Added: Переключение на пакет semble-grammars для обработки грамматики.
  • Added: Расширен список бенчмарков: добавлены codebase-memory-mcp, cs и ck.
  • Added: Обновлена конфигурация MCP для редактора Zed.
  • Обновлена документация проекта.
v0.5.0minor
🕐 2 мес назад · релиз на GitHub ↗

В Semble v0.5.0 базовая модель обновлена до potion-code-v2.

  • Added: Модель по умолчанию изменена на potion-code-v2.
v0.4.2minor
🕐 2 мес назад · релиз на GitHub ↗

В Semble v0.4.2 добавлена поддержка zcode и реализована установка без взаимодействия с пользователем.

  • Added: Добавлена поддержка zcode.
  • Added: Реализована автоматическая установка (unattended install).
v0.4.1minorbreaking
🕐 3 мес назад · релиз на GitHub ↗

Добавлена поддержка Codex subagent, репозиторий теперь обязателен, исправлена валидация кэша MCP.

  • Added: Добавлена поддержка Codex subagent.
  • Breaking: Параметр repo теперь обязателен, удалены значения по умолчанию для source и ref.
  • Fixed: Исправлена валидация кэшированных MCP-индексов при запросе.