Возможности
TaigaReport — CLI-инструмент на Go: табличные данные или текст превращаются в самодостаточный HTML-отчёт с диаграммами Vega-Lite. Один бинарник, один выходной файл, работает offline.
Форматы входа
- CSV, JSON, Markdown-таблицы (GFM), YAML — файл-аргумент или stdin
- Свободный текст — логи, проза с цифрами: LLM-фаза извлекает из него датасеты, дальше обычный конвейер
- Кодировки: не-UTF-8 кириллица (cp1251, KOI8-R, cp866, ISO-8859-5, MacCyrillic) детектируется и перекодируется автоматически
Два трека отчёта
| Трек | Что делает | LLM-вызовов |
|---|---|---|
| По умолчанию — визуализация | Служебный анализ, дескриптивные заголовки, блок качества данных | 2 |
--deep — автономный анализ | Идентификация предметной области, самопостановка вопросов, EDA, утверждения с уровнями уверенности (факт/интерпретация/допущение) и условный вывод | 4 |
Политика честности: в --deep любая упавшая фаза после ретраев — ошибка, без тихих
деградаций; в дефолтном треке сбои LLM не роняют запуск — отчёт деградирует до эвристик
с предупреждением.
Страница секций
- Несколько диаграмм в одном отчёте, с заголовками и короткими заметками
- Мультиразрезность: из одного датасета строятся разные разрезы — тренды, top-N, распределения
- Типы диаграмм: bar, hbar, line, area, pie, scatter
- Обложка датасета с KPI-карточками и краткой сводкой (v0.50+)
- Оглавление с якорями, адаптивная сетка, стили печати
Честность и доказательность
- Блок качества данных — детерминированный, считается из исходных данных (пропуски, дубликаты, диапазоны); LLM его не авторит
- В
--deepутверждения снабжаются уровнями уверенности и ссылками на вычисленный реестр результатов - Агрегация (count/sum/avg/min/max, top-N) выполняется на стороне Go — сырые строки не раздувают отчёт
Конфигурация и диагностика
- Приоритет: дефолты →
~/.config/taigareport/config.json→ env → CLI-флаги - Ключ можно получать командой
api_key_cmd(например, из 1Password CLI) taigareport llm test— проверка конфигурации одним пробным вызовом- Язык отчёта: по умолчанию — язык данных (русские данные → русский отчёт), переопределяется
--lang
Без LLM и воспроизводимость
--no-llm— эвристический выбор диаграммы без API-ключа (для табличного входа)- Рядом с отчётом пишется артефакт прогона
.run.json;taigareport replayперерисовывает отчёт байт-в-байт без LLM --total-budget— общий бюджет всех LLM-фаз прогона: при исчерпании честная деградация вместо зависания
Подробнее — в документации: установка, первый отчёт, справочник настроек.