v0.7.2patch
Исправлена валидация YAML-описания навыков для корректной обработки.
- Fixed: Исправлена ошибка, из-за которой описание навыков могло не проходить валидацию YAML.
MinishLab/semble
Быстрый и точный поиск кода для агентов. Использует на ~98% меньше токенов, чем grep+read
Агенты⭐ 6 363Pythonпоследний релиз: v0.7.2
Что это за инструмент
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.7.1minor
В Semble v0.7.1 добавлена новая Skill, опциональный HTTP-транспорт для MCP-сервера и улучшены сообщения об ошибках загрузки моделей.
- Added: Добавлена новая Skill для Semble.
- Added: Реализован опциональный HTTP-транспорт для MCP-сервера.
- Fixed: Улучшено сообщение об ошибке при невозможности загрузки модели с Hub.
v0.7.0minor
Версия 0.7.0: ускорение работы, параллельная чанкинг, пакетные эмбеддинги и обновление MCP SDK до 2.x.
- Added: Добавлена команда file-types для управления типами файлов.
- Added: Реализована параллельная обработка чанков (chunking) для повышения производительности.
- Added: Внедрены пакетные эмбеддинги и обновлена библиотека model2vec.
- Added: Выполнен апгрейд до MCP SDK 2.x.
- Fixed: Исправлено использование имен инструментов MCP в инструкциях агента.
- Оптимизация: хранение постингов BM25 в numpy-массивах, ускорение теплых запросов и использование os.scandir.
v0.6.2patch
Исправлена валидация кэша через mtime манифеста и улучшено корректное завершение MCP-сервера при EOF или SIGTERM.
- Fixed: Исправлена валидация кэша: теперь используются mtime манифеста.
- Fixed: MCP-сервер теперь немедленно завершает работу при получении EOF по stdin или сигнала SIGTERM.
- Workflow-действия релиза зафиксированы по commit SHA для стабильности.
v0.6.1minor
Добавлена поддержка установщиков Grok Build, Qwen Code, Cline и Kilo Code, а также оптимизировано кэширование MCP.
- Added: Добавлена поддержка установщиков Grok Build, Qwen Code, Cline и Kilo Code.
- Added: В кэш индекса MCP добавлен тайм-аут неактивности (idle TTL).
- Added: В бенчмарки добавлен инструмент zvec-grep.
- Fixed: Скрыто предупреждение об аутентификации Hugging Face.
- Упрощена обработка переменной SEMBLE_MAX_FILE_BYTES и настройка логирования CLI.
v0.6.0minor
Релиз v0.6.0: добавлена поддержка поиска по нескольким репозиториям, прогресс-бар для CLI и исправлено удаление максимальной длины.
- Added: Добавлена поддержка поиска по нескольким репозиториям одновременно.
- Added: В интерфейс командной строки внедрены прогресс-бар и форматированный вывод.
- Fixed: Исправлено удаление параметра максимальной длины (max length).
- Fixed: Устранены ошибки в аннотациях, указывающих на устаревшие или несуществующие файлы.
- Added: Добавлена опция бенчмарка только для Semble и исправлен подсчёт строк в чанках.
v0.5.6minor
В Semble v0.5.6 добавлена настройка лимита размера файлов, исправлены права доступа в песочницах и ошибка двойной эмбеддинговой обработки.
- Added: Максимальный размер файла теперь настраивается через переменную SEMBLE_MAX_FILE_BYTES с предупреждением при пропуске.
- Fixed: Исправлены проблемы с правами доступа в песочницах (sandboxes).
- Fixed: Устранена ошибка двойного прохода эмбеддинга при создании нового индекса.
v0.5.5minor
В Semble v0.5.5 добавлена фильтрация контента для MCP и обновлена документация с альтернативными моделями.
- Added: Добавлена фильтрация контента в MCP.
- Обновлено описание README с указанием альтернативных моделей.
v0.5.4patch
В Semble v0.5.4 добавлена команда для очистки орфанов и исправлены проблемы с консолью на Windows.
- Added: Добавлена команда clear orphans для удаления орфанов.
- Fixed: Исправлены проблемы с работой консоли в Windows.
v0.5.3minor
Релиз 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
В Semble v0.5.0 базовая модель обновлена до potion-code-v2.
- Added: Модель по умолчанию изменена на potion-code-v2.
v0.4.2minor
В Semble v0.4.2 добавлена поддержка zcode и реализована установка без взаимодействия с пользователем.
- Added: Добавлена поддержка zcode.
- Added: Реализована автоматическая установка (unattended install).
v0.4.1minorbreaking
Добавлена поддержка Codex subagent, репозиторий теперь обязателен, исправлена валидация кэша MCP.
- Added: Добавлена поддержка Codex subagent.
- Breaking: Параметр repo теперь обязателен, удалены значения по умолчанию для source и ref.
- Fixed: Исправлена валидация кэшированных MCP-индексов при запросе.