Возможности

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-фаз прогона: при исчерпании честная деградация вместо зависания

Подробнее — в документации: установка, первый отчёт, справочник настроек.