OrionBelt Semantic Layer CLI
CLI obsl проверяет YAML-модель метрик и собирает из нее SQL под восемь диалектов, чтобы агент не писал соединения фактов вручную.
- 104 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Команда `execute` отправляет сгенерированный SQL в подключенное хранилище и читает данные.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/orionbelt-semantic-layerОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команда `execute` отправляет сгенерированный SQL в подключенное хранилище и читает данные.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OrionBelt описывает измерения, меры и связи таблиц в YAML-модели, а компилятор превращает запрос «выручка по странам» в SQL нужного диалекта. Планировщик составных фактов блокирует пути соединения, из-за которых суммы завышаются в разы. Команда `obsl` работает локально: `validate` проверяет модель, `compile` печатает SQL, `describe` показывает состав, `lineage` выводит происхождение метрики. `execute` и `rules evaluate` обращаются к развернутому серверу или хранилищу. MCP-сервер вынесен в отдельный репозиторий и ходит в REST API.
Для кого. Аналитикам и инженерам данных, которые поручают агенту считать метрики по звездообразной схеме и хотят единые определения вместо сгенерированных соединений.
Подходит, если
- Агент пишет SQL по звездообразной схеме, и выручка выходит завышенной из-за соединения двух таблиц фактов.
- Метрики компании описаны в одном YAML, и их проверяют в CI командой `obsl validate`.
- Один запрос выполняют на Snowflake и DuckDB, поэтому SQL нужен под каждый диалект.
- Перед отчетом надо показать, из каких таблиц и колонок собрана мера (`obsl lineage`).
Не подходит, если
- Дашборды с высокой конкурентной нагрузкой: для них README сам советует Cube.
- Одноразовый запрос к одной таблице без метрик и соединений.
- Проект ограничен лицензиями Apache или MIT: код выходит под BUSL-1.1.
Пример запроса к агенту
Проверь модель tpcds.obml.yml командой obsl validate и покажи SQL для запроса Q98.yml под DuckDB.Ограничения
Лицензия BUSL-1.1: исходники открыты, коммерческое использование регулируют ее условия, а переход на Apache 2.0 заявлен позже. Локально работают `validate`, `compile`, `describe` и `lineage`; для `execute` нужны развернутый сервер или подключение к хранилищу. Нужен Python 3.12 или новее, а модель в формате OBML пишут заранее вместе с описанием физических таблиц. MCP-сервер ставят отдельно, и в Docker он по stdio не работает.
Как отключить. Удалите пакет командой `pip uninstall orionbelt-semantic-layer` и файлы моделей из репозитория. Если запускали `orionbelt-api` или контейнер, остановите их.
Частые вопросы
Нужен ли запущенный сервер?
Для проверки и компиляции нет: `validate`, `compile` и `describe` работают в процессе. Для `execute` укажите `--server` с адресом развернутой модели.
Какие диалекты поддерживает компилятор?
README называет восемь SQL-диалектов. Точный список печатает `obsl dialects`.
Как подключить MCP?
MCP-сервер лежит в репозитории `orionbelt-semantic-layer-mcp` и запускается через `uvx orionbelt-semantic-layer-mcp`. Он обращается к REST API основного проекта.
Какая лицензия у проекта?
BUSL-1.1 с заявленным переходом на Apache 2.0. Бесплатный дистрибутив рассчитан на самостоятельное размещение, а условия коммерческого использования читайте в файле LICENSE.
Что делает `obsl lineage`?
Показывает, из чего построена мера или запрос. Вывод доступен в Mermaid, Markdown, JSON и Turtle.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер строит онтологию из схемы базы данных и проверяет SQL агента до запуска: PostgreSQL, Snowflake, ClickHouse и другие
Плагин с двумя скиллами и семантическим слоем метрик: агент описывает модели в YAML и считает их в SQL.
Open Ontologies
open-ontologies
Планирование изменений онтологий OWL: оценка последствий, откат и проверяемое доказательство для рецензента. Один бинарь на Rust для узкой аудитории
Анализ отзывов клиентов на своем сервере: персональные данные скрыты до модели, а MCP-сервер и скилл отдают агенту цитаты из отзывов
Семантический слой NVIDIA Auto Ontology как MCP-сервер: запросы к базам проходят проверку, а факты ложатся в личную базу знаний.
CLI выбирает и меняет значения в JSON, YAML и других форматах, чтобы агент преобразовывал данные единым языком запросов.
Коротко о README
В README семантический слой представлен как система с компилятором в SQL, планировщиком составных фактов и движком бизнес-правил. Модель задают в YAML. К ней подключаются по протоколу PostgreSQL, Arrow Flight SQL, REST, MCP и CLI. Лицензия BUSL-1.1 с переходом на Apache 2.0.