Vizb CLI
CLI превращает CSV, JSON и вывод бенчмарков в интерактивные графики ECharts и статистику в одном файле HTML для людей и агентов
- 91 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Программа читает файлы и ответы API, которые вы ей передаете, и пишет файлы HTML, а API в образе Docker не имеет аутентификации.
Установка
- Работает в
Ручная установка
npx skills add goptics/skills --skill vizbСкилл для агентов, после установки работает команда `/vizb`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Программа читает файлы и ответы API, которые вы ей передаете, и пишет файлы HTML, а API в образе Docker не имеет аутентификации.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Vizb — движок визуализации табличных данных. Он берет CSV, JSON или вывод бенчмарков, превращает числовые колонки в интерактивные графики Apache ECharts и описательную статистику и записывает все в один самодостаточный файл HTML: сервер, зависимости и сборка не нужны. Тип графика задается командой, например `vizb bar data.csv -o out.html`. Данные группируются и отбираются флагами. `--group` и `--group-pattern` режут поле по осям, например дату на год, месяц и день для трехмерного графика, `--json-path` достает вложенный массив из ответа API, `--select` оставляет и переименовывает колонки, `--stat` добавляет панель статистики, `--output` задает файл. Пример из README строит трехмерный график вкладов на GitHub одним конвейером из `curl` и `vizb`. Для агентов есть скилл: `npx skills add goptics/skills --skill vizb`, после чего команда `/vizb` работает в Claude Code, Cursor, Codex и других агентах. Для автоматизации предусмотрены образ Docker с HTTP API, действие GitHub для CI и установка скриптом, бинарником или через Docker.
Для кого. Разработчикам и аналитикам, которым нужно быстро показать результаты бенчмарков или таблицу как интерактивный график, не поднимая сервер.
Подходит, если
- Нужен график из результатов бенчмарка Go или другого вывода, который можно открыть в браузере и выложить как файл
- Агент должен построить диаграмму по CSV или ответу API одной командой `/vizb`
- Данные лежат во вложенном JSON, и нужно достать массив через `--json-path` и переименовать колонки
- Дату надо разложить на год, месяц и день и показать трехмерным сгруппированным графиком
- Отчет по производительности нужно строить в CI с помощью действия GitHub и сохранять как HTML
Не подходит, если
- Нужна живая панель с обновлением данных: Vizb создает статичный файл HTML
- Нужен сложный BI-отчет с подключением к базам: инструмент работает с файлами и потоками
- Нужна публичная служба с входом: HTTP API в образе Docker не имеет встроенной аутентификации
Пример запроса к агенту
/vizb как bar: возьми data.csv, сгруппируй по месяцам, покажи статистику и сохрани результат в report.html.Ограничения
Результат остается статичным файлом HTML, диаграммы строятся из числовых колонок, и для нестандартной структуры данных приходится подбирать `--group`, `--json-path` и `--select`. HTTP API в образе Docker не имеет встроенной аутентификации: его держат во внутренней сети или ставят перед ним аутентификацию, TLS и контроль доступа. Установочные скрипты запускаются через `curl | bash` и `irm | iex`, их стоит прочитать перед запуском, либо взять готовый бинарник со страницы релизов. Для сборки из исходников нужен Go версии 1.26. Скилл для агента опирается на менеджер `npx skills`.
Как отключить. Удалите бинарник `vizb` и скилл из каталога скиллов агента. Остановите контейнер командой `docker stop` и удалите образ `goptics/vizb`. Созданные файлы HTML остаются на диске.
Частые вопросы
Как поставить Vizb для агента?
Выполните `npx skills add goptics/skills --skill vizb`. После этого команда `/vizb` работает в Grok, Claude Code, Cursor, Codex и других агентах, которые поддерживает менеджер `npx skills`.
Какие форматы данных поддерживаются?
CSV, JSON и вывод бенчмарков. Для вложенного JSON служит флаг `--json-path`, а `--select` оставляет нужные колонки.
Нужен ли сервер для просмотра результата?
Нет. Результат записывается в один файл HTML с графиками и статистикой, его открывают в браузере.
Как запустить через Docker?
Для CLI выполните `docker run --rm -v "$PWD:/data" -w /data goptics/vizb bar data.csv -o out.html`. Для HTTP API выполните `docker run -d --rm -p 8080:8080 goptics/vizb`, у него нет встроенной аутентификации.
Какие типы графиков есть?
Команда принимает тип графика первым аргументом, например `bar`. Полный список лежит в разделе Charts документации.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыBI как код: дашборды в YAML, семантический слой и локальный MCP-сервер, через который агент черновит графики.
FlexViz строит интерактивные дашборды на 100 млн строк, а агент отдает ссылку и читает, что вы выделили на графиках.
VisActor Skills — графики, дашборды и постеры
VisActor Skills
Девять скиллов VisActor: бизнес-графики, истории из данных, дашборды с картами и постеры, которые собирает агент
VisiData открывает таблицы разных форматов в терминале и помогает исследовать и упорядочивать данные через клавиатуру.
Скилл визуализации данных для агентов: превращает данные в аккуратные интерактивные HTML-графики и целые отчеты с единым визуальным языком
Скилл подбирает научный график под цель и данные CSV или Excel из почти сотни шаблонов и выдает PNG, SVG, PDF и код на Python.
Коротко о README
В README перечислены способы установки (скилл для агента, скрипты, бинарник, Docker), пример с графиком вкладов GitHub, список использованных флагов, предупреждение про API без аутентификации и ссылки на документацию.