Sidemantic — плагин
Плагин с двумя скиллами и семантическим слоем метрик: агент описывает модели в YAML и считает их в SQL.
- 139 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Запросы идут в вашу базу данных, а сервер `serve` открывает данные по сети.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/sidemanticОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запросы идут в вашу базу данных, а сервер `serve` открывает данные по сети.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Sidemantic — открытый семантический слой, где метрики задаются один раз и считаются одинаково из SQL, CLI, Python, HTTP, клиентов PostgreSQL, блокнотов и агентов. Модели пишутся на YAML, семантическом SQL или Python, а готовые описания импортируются из Cube, dbt MetricFlow, LookML, Power BI, Malloy и других форматов. Запросы идут в DuckDB, BigQuery, Snowflake, ClickHouse, Databricks и другие хранилища. Для агентов репозиторий содержит плагин для Claude Code и Codex с двумя скиллами: `modeler` строит и проверяет модели, `webapp-builder` собирает веб-приложение. Команда `sidemantic serve` поднимает веб-интерфейс, HTTP API и MCP на одном порту.
Для кого. Аналитики данных и инженеры, которые хотят вести единые определения метрик и поручать агенту их моделирование.
Подходит, если
- Метрики разошлись между BI-системами, и нужен один источник определений.
- Существующий проект Cube или MetricFlow надо перенести в другой формат.
- Агент должен отвечать на вопросы по данным через проверенные метрики, а не через произвольный SQL.
- Схему базы нужно превратить в модели с измерениями и связями.
Не подходит, если
- Нужна готовая BI-панель с графиками без настройки моделей.
- Лицензия AGPL-3.0 не подходит для вашего продукта.
- Данных мало, и обычного SQL достаточно.
Пример запроса к агенту
Создай модель orders из CSV, опиши метрики revenue и order_count, проверь через `sidemantic validate` и покажи запрос по статусам.Ограничения
Лицензия AGPL-3.0 накладывает обязательства на встраивание в закрытые продукты. Агентская часть невелика: два скилла, основная ценность в самом слое метрик. Подключение к облачному хранилищу требует своих учетных данных, а сервер `serve` открывает доступ к данным по сети, его стоит закрыть аутентификацией. Часть расширений подключается отдельно. Проект быстро развивается: форматы импорта и расширения меняются между релизами, поэтому закрепляйте версию в рабочих проектах. Демонстрационный сайт скачивает данные объемом более 50 МБ.
Как отключить. Удалите плагин через менеджер плагинов Claude Code или Codex. Остановите процесс `sidemantic serve`, если запускали его.
Частые вопросы
Как быстро попробовать?
Выполните `uvx sidemantic demo`: команда создаст демо-проект с данными DuckDB и запустит первый запрос.
Как поставить плагин в Claude Code?
`claude plugin marketplace add sidequery/sidemantic && claude plugin install sidemantic@sidequery`. Для Codex есть похожая пара команд `codex plugin`.
Какие форматы импортируются?
Cube, dbt MetricFlow, LookML, Power BI TMDL/DAX, Hex, Rill, Superset, Omni, Malloy и другие. Полный перечень есть в руководстве по адаптерам.
Есть ли MCP?
Да. `sidemantic serve` поднимает веб-интерфейс, HTTP API и MCP на одном порту.
Какие хранилища поддерживаются?
DuckDB, MotherDuck, PostgreSQL, BigQuery, Snowflake, ClickHouse, Databricks, Spark SQL и источники ADBC.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин Semantica: 17 скиллов и 3 агента для графов знаний, рассуждений и происхождения данных в Claude Code, Cursor и Codex.
Плагин UModel дает агенту три скилла для чтения сущностей и топологии из графа и разбора причин сбоя поверх локального сервиса.
Marketplace плагинов для Claude Code и GitHub Copilot по Power BI и Microsoft Fabric: семантические модели, DAX, TMDL, отчеты
MCP-сервер text-to-SQL: агент спрашивает базу словами, получает SQL и трассу ответа, а при нехватке данных отказ с причиной.
Три плагина для Claude Code: запросы к открытым датасетам OpenData, готовые диаграммы и таблицы OpenChart, SVG-графика.
Плагин для Claude Code и Codex строит онтологию по вашим таблицам и файлам и дорабатывает ее по истории работы агента
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Sidemantic (эта карточка) | нет | 139 | ||
| dbt Agent Skills | да | 754 | скиллы для работы с dbt; Sidemantic держит собственный слой метрик и импортирует определения из dbt MetricFlow, Cube и LookML | |
| dbt MCP | да | API-ключ | 617 | MCP-сервер для проектов dbt; Sidemantic дает слой метрик с SQL, HTTP и MCP и плагин с двумя скиллами |
Коротко о README
README начинается с описания слоя метрик и быстрого запуска за минуту, затем разбирает пути использования, форматы импорта, хранилища, Docker и раздел о плагине для агентов с командами установки.