# Troubleshooting

## Команда iola не найдена

Проверьте глобальную установку:

```bash
npm install -g @iola_adm/iola-cli
npm bin -g
```

## Нужна новая версия Node.js

```bash
node --version
iola init --upgrade-node
```

## Ollama недоступна

```bash
ollama --version
ollama serve
iola ai doctor
```

## YandexGPT/GigaChat/OpenAI/OpenRouter key не найден

```bash
iola ai key status
iola ai key set yandexgpt
iola ai key set gigachat
iola ai key set openai
iola ai key set openrouter
```

Где получить ключ:

- YandexGPT: `https://yandex.cloud/ru/docs/ai-studio/api-ref/authentication`
- GigaChat: `https://developers.sber.ru/docs/ru/gigachat/overview`
- OpenAI Platform: `https://platform.openai.com/api-keys`
- OpenRouter: `https://openrouter.ai/settings/keys`

Для YandexGPT нужен не только API key, но и folder ID каталога Yandex Cloud. Для GigaChat нужен authorization key; CLI сам получает OAuth-токен перед запросом.

Важно: оплата российскими банковскими картами для OpenAI Platform и OpenRouter может быть невозможна. Если API-запросы не проходят после сохранения ключа, проверьте не только ключ, но и billing/баланс в личном кабинете сервиса.

## Нет локальных данных

```bash
iola sync
iola sync status
iola search "школа" --local
```

## Нужен подробный лог

```bash
iola --debug --debug-file iola-debug.log doctor
```
