Настройка LLM

TaigaReport работает с любым OpenAI-совместимым endpoint: облачные API напрямую, LiteLLM или другой прокси, локальные серверы. Приоритет настроек фиксирован:

дефолты → ~/.config/taigareport/config.json → переменные окружения → CLI-флаги

Минимальная настройка через env

export LLM_BASE_URL=http://127.0.0.1:4000   # OpenAI-совместимый endpoint
export LLM_API_KEY=...
export LLM_MODEL=...

Проверка одним пробным вызовом — команда напечатает, откуда взялось каждое поле:

./dist/taigareport llm test

Ключ и модель задаются вместе: неполный конфиг — ошибка конфигурации (exit 3).

config.json

Постоянные настройки — в ~/.config/taigareport/config.json (env их перекрывает):

{
  "base_url": "http://127.0.0.1:4000",
  "model": "gpt-4o-mini",
  "api_key_cmd": "op read 'op://Vault/taigareport/key'"
}
  • api_key — ключ прямо в файле; api_key_cmd — shell-команда, чей stdout и есть ключ (например, 1Password CLI): ключ не хранится на диске, запрашивается в момент прогона
  • language — язык отчёта; по умолчанию — язык данных (русские данные → русский отчёт, включая заголовки «Содержание» и «Качество данных»)
  • out_dir — директория для отчётов (поддерживает ~), open — открывать ли браузер

Полный состав полей с дефолтами — в справочнике настроек.

Диагностика

ИнструментЧто показывает
taigareport llm testИсточник каждого поля конфигурации + один пробный вызов
--debugРазмеры payload, детали retry и валидации, бюджетные предупреждения, причины деградаций
exit-коды0 успех, 1 внутренняя ошибка, 2 входные данные, 3 конфигурация LLM, 4 сбой LLM-фазы без fallback, 5 ошибка записи

Сбои LLM в дефолтном треке не роняют запуск: viz-brief упал — страница строится без него; фаза страницы упала — отчёт строится эвристиками (exit 0 с предупреждением). В --deep любая фаза после ретраев — честный exit 4.


Проверено на TaigaReport v0.50.4, октябрь 2026.