Настройка 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.