@iola_adm/iola-cli 0.1.113 → 0.2.1

package/README.md

@@ -131,7 +131,37 @@ CLI использует модель `iola-router:qwen3-1.7b-v4-q8` из GGUF-
 /model
 ```
 
-В интерактивном CLI команда `/model` переключает локальную модель IOLA, API-профили OpenAI/OpenRouter и Codex CLI. Для OpenRouter выбор устроен так: сначала выбирается разработчик моделей, затем CLI показывает до 30 самых свежих моделей для текстовой работы с датой релиза и размером контекста. В списке моделей `0` возвращает к выбору разработчика.
+В интерактивном CLI команда `/model` переключает локальные модели, российские AI-провайдеры YandexGPT/GigaChat, API-профили OpenAI/OpenRouter и Codex CLI. Российские провайдеры вызываются напрямую, без gateway/proxy. Для OpenRouter выбор устроен так: сначала выбирается разработчик моделей, затем CLI показывает до 30 самых свежих моделей для текстовой работы с датой релиза и размером контекста. В списке моделей `0` возвращает к выбору разработчика.
+
+В локальном выборе доступны:
+
+- штатная модель IOLA `iola-router:qwen3-1.7b-v4-q8`;
+- установленные и рекомендуемые модели Ollama;
+- ручной ввод имени любой Ollama-модели, например `qwen3:4b` или `llama3.2:3b`.
+
+Если выбранная Ollama-модель еще не скачана, CLI предложит выполнить `ollama pull`.
+
+Российские AI:
+
+- Yandex AI Studio / YandexGPT: документация `https://yandex.cloud/ru/docs/foundation-models/`, аутентификация `https://yandex.cloud/ru/docs/ai-studio/api-ref/authentication`, тарифы `https://yandex.cloud/ru/docs/foundation-models/pricing`;
+- GigaChat: документация `https://developers.sber.ru/docs/ru/gigachat/overview`, получение токена `https://developers.sber.ru/docs/ru/gigachat/api/reference/rest/post-token`, тарифы `https://developers.sber.ru/docs/ru/gigachat/tariffs`.
+
+```bash
+iola ai key set yandexgpt
+iola ai setup yandexgpt --model yandexgpt-lite/latest
+
+iola ai key set gigachat
+iola ai setup gigachat --model GigaChat-2
+```
+
+У GigaChat для физических лиц есть Freemium-лимит на токены; для больших объемов используются платные пакеты. У YandexGPT тарификация идет через Yandex Cloud по токенам и квотам аккаунта, актуальные бесплатные гранты или лимиты нужно проверять в консоли Yandex Cloud.
+
+Зарубежные API-ключи:
+
+- OpenAI Platform: регистрация `https://platform.openai.com/`, ключи `https://platform.openai.com/api-keys`;
+- OpenRouter: регистрация `https://openrouter.ai/`, ключи `https://openrouter.ai/settings/keys`.
+
+Ключи сохраняются локально командой `iola ai key set openai` или `iola ai key set openrouter`. Важно: оплата российскими банковскими картами для OpenAI Platform и OpenRouter может быть невозможна. Перед настройкой платных API проверьте доступный способ оплаты в личном кабинете сервиса.
 
 Ollama остается опциональным runtime:
 
@@ -170,7 +200,7 @@ iola version --check
 - интеграция с публичным MCP-сервером Йошкар-Олы;
 - поиск и выгрузка открытых данных;
 - локальная SQLite-БД, история, сессии и FTS-поиск;
-- AI-профили для IOLA local, Ollama, OpenAI, OpenRouter и Codex CLI;
+- AI-профили для IOLA local, Ollama, YandexGPT, GigaChat, OpenAI, OpenRouter и Codex CLI;
 - локальный tool-agent для модели IOLA с tools `search_data`, `search_entities`, `resolve_entity_field`, `get_card`, `export_report`, `file_read`, `browser_open`;
 - ленивые skills, toolsets, permissions, memory, hooks и готовые agents;
 - subagents, skill bundles, layered settings, usage/budget accounting и trajectory export;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iola_adm/iola-cli",
-  "version": "0.1.113",
+  "version": "0.2.1",
   "description": "CLI и AI-агент городского округа Йошкар-Ола.",
   "license": "MIT",
   "homepage": "https://github.com/adm-iola/iola-cli#readme",

package/src/cli.js

@@ -4,6 +4,7 @@ import { createServer } from "node:http";
 import { appendFile, copyFile, cp, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
+import { randomUUID } from "node:crypto";
 import { emitKeypressEvents } from "node:readline";
 import readline from "node:readline/promises";
 import { Readable } from "node:stream";
@@ -164,6 +165,20 @@ const DEFAULT_AI_CONFIG = {
         baseUrl: "https://openrouter.ai/api/v1",
         networkMode: "gateway",
       },
+      yandexgpt: {
+        provider: "yandexgpt",
+        model: "yandexgpt-lite/latest",
+        baseUrl: "https://llm.api.cloud.yandex.net/foundationModels/v1",
+        networkMode: "direct",
+      },
+      gigachat: {
+        provider: "gigachat",
+        model: "GigaChat-2",
+        baseUrl: "https://gigachat.devices.sberbank.ru/api/v1",
+        authUrl: "https://ngw.devices.sberbank.ru:9443/api/v2/oauth",
+        scope: "GIGACHAT_API_PERS",
+        networkMode: "direct",
+      },
       codex: {
         provider: "codex",
         model: "gpt-5.5",
@@ -611,21 +626,25 @@ Usage:
   iola update
   iola ask TEXT [--profile NAME] [--model MODEL] [--tools] [--files] [--plan] [--trace] [--reasoning fast|verify|vote] [--output FILE] [--schema json|table] [--events] [--no-history] [--bare] [--quiet] [--no-color] [--fail-on-empty]
   iola data LAYER [--limit 10] [--search TEXT] [--where FIELD=VALUE] [--columns a,b,c] [--format table|json|csv]
-  iola ai ask TEXT [--provider iola|ollama|openai|openrouter] [--model MODEL]
+  iola ai ask TEXT [--provider iola|ollama|yandexgpt|gigachat|openai|openrouter] [--model MODEL]
   iola ai context TEXT [--json]
+  iola ai key set yandexgpt
+  iola ai key set gigachat
   iola ai key set openai
   iola ai key set openrouter
   iola ai key status
-  iola ai key delete openai|openrouter
+  iola ai key delete yandexgpt|gigachat|openai|openrouter
   iola ai profiles
   iola ai profile add NAME --provider PROVIDER --model MODEL
   iola ai profile use NAME
   iola ai profile delete NAME
-  iola ai models iola|ollama|openai|openrouter|codex [--search TEXT]
+  iola ai models iola|ollama|yandexgpt|gigachat|openai|openrouter|codex [--search TEXT]
   iola ai doctor [--json]
   iola ai setup
   iola ai setup iola [--yes] [--force]
   iola ai setup ollama [--yes] [--model MODEL]
+  iola ai setup yandexgpt [--model MODEL]
+  iola ai setup gigachat [--model MODEL]
   iola health [--json]
   iola layers [--json]
   iola schools [--limit 10] [--search TEXT] [--where FIELD=VALUE] [--columns a,b,c] [--format table|json|csv]
@@ -753,9 +772,14 @@ async function getAiReadiness() {
   const iola = await hasUsableIolaModel();
   const openai = Boolean(process.env.OPENAI_API_KEY || secrets.openai?.apiKey);
   const openrouter = Boolean(process.env.OPENROUTER_API_KEY || secrets.openrouter?.apiKey);
+  const yandexgpt = Boolean((process.env.YANDEXGPT_API_KEY || process.env.YANDEX_CLOUD_API_KEY || secrets.yandexgpt?.apiKey)
+    && (process.env.YANDEXGPT_FOLDER_ID || process.env.YANDEX_CLOUD_FOLDER_ID || secrets.yandexgpt?.folderId));
+  const gigachat = Boolean(process.env.GIGACHAT_AUTH_KEY || process.env.GIGACHAT_API_KEY || secrets.gigachat?.apiKey);
   const providerReady = {
     iola,
     ollama,
+    yandexgpt,
+    gigachat,
     openai,
     openrouter,
     codex,
@@ -765,10 +789,12 @@ async function getAiReadiness() {
     activeProfile: activeProfileName,
     activeProvider: activeProfile.provider || "-",
     activeModel: activeProfile.model || "-",
-    anyReady: Boolean(iola || ollama || openai || openrouter || codex),
+    anyReady: Boolean(iola || ollama || yandexgpt || gigachat || openai || openrouter || codex),
     profiles: config.ai.profiles || {},
     iola,
     ollama,
+    yandexgpt,
+    gigachat,
     openai,
     openrouter,
     codex,
@@ -776,7 +802,7 @@ async function getAiReadiness() {
 }
 
 function getFallbackAiProfile(readiness) {
-  const priority = ["iola", "openai", "openrouter", "codex", "ollama"];
+  const priority = ["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"];
   for (const provider of priority) {
     if (!readiness[provider]) continue;
     const entry = Object.entries(readiness.profiles || {}).find(([, profile]) => profile.provider === provider);
@@ -1612,6 +1638,8 @@ function buildAgentStatusLine(state) {
   const kind = {
     iola: "IOLA local",
     ollama: "локальная",
+    yandexgpt: "YandexGPT",
+    gigachat: "GigaChat",
     openai: "API",
     openrouter: "API",
     codex: "Codex",
@@ -2051,6 +2079,8 @@ async function initCli(args = []) {
     console.log("Для настройки AI используйте:");
     console.log("  iola ai setup iola --yes");
     console.log("  iola ai setup ollama");
+    console.log("  iola ai key set yandexgpt");
+    console.log("  iola ai key set gigachat");
     console.log("  iola ai key set openai");
     console.log("  iola ai setup openai --model gpt-4.1-mini");
     return;
@@ -2073,21 +2103,25 @@ async function handleAi(args) {
   if (subcommand === "help") {
     await showBanner();
     console.log(`AI-команды:
-  iola ai ask TEXT [--provider iola|ollama|openai|openrouter] [--model MODEL]
+  iola ai ask TEXT [--provider iola|ollama|yandexgpt|gigachat|openai|openrouter] [--model MODEL]
   iola ai context TEXT [--json]
+  iola ai key set yandexgpt
+  iola ai key set gigachat
   iola ai key set openai
   iola ai key set openrouter
   iola ai key status
-  iola ai key delete openai|openrouter
+  iola ai key delete yandexgpt|gigachat|openai|openrouter
   iola ai profiles
-  iola ai profile add NAME --provider iola|ollama|openai|openrouter|codex --model MODEL
+  iola ai profile add NAME --provider iola|ollama|yandexgpt|gigachat|openai|openrouter|codex --model MODEL
   iola ai profile use NAME
   iola ai profile delete NAME
-  iola ai models iola|ollama|openai|openrouter|codex [--search TEXT]
+  iola ai models iola|ollama|yandexgpt|gigachat|openai|openrouter|codex [--search TEXT]
   iola ai doctor [--json]
   iola ai setup
   iola ai setup iola [--yes] [--force]
   iola ai setup ollama [--yes] [--model MODEL]
+  iola ai setup yandexgpt [--model MODEL]
+  iola ai setup gigachat [--model MODEL]
   iola ai setup openai [--model MODEL]
   iola ai setup openrouter [--model MODEL]
 
@@ -4187,9 +4221,14 @@ async function aiSetup(args) {
     return;
   }
 
-  if (provider === "openai" || provider === "openrouter") {
+  if (provider === "openai" || provider === "openrouter" || provider === "yandexgpt" || provider === "gigachat") {
     const options = parseOptions(args.slice(1));
-    const model = options.model || (provider === "openai" ? "gpt-4.1-mini" : "openai/gpt-4.1-mini");
+    const model = options.model || {
+      openai: "gpt-4.1-mini",
+      openrouter: "openai/gpt-4.1-mini",
+      yandexgpt: "yandexgpt-lite/latest",
+      gigachat: "GigaChat-2",
+    }[provider];
     const profileName = options.name || provider;
     const profile = buildProfileFromOptions(provider, { ...options, model });
     const config = await loadConfig();
@@ -4208,7 +4247,13 @@ async function aiSetup(args) {
     });
     console.log(`AI-профиль ${profileName} сохранен и выбран в ${CONFIG_FILE}`);
     console.log(`Ключ сохраните командой: iola ai key set ${provider}`);
-    console.log(`Также можно использовать переменную окружения ${provider === "openai" ? "OPENAI_API_KEY" : "OPENROUTER_API_KEY"}.`);
+    const envHint = {
+      openai: "OPENAI_API_KEY",
+      openrouter: "OPENROUTER_API_KEY",
+      yandexgpt: "YANDEXGPT_API_KEY и YANDEXGPT_FOLDER_ID",
+      gigachat: "GIGACHAT_AUTH_KEY",
+    }[provider];
+    console.log(`Также можно использовать переменную окружения ${envHint}.`);
     return;
   }
 
@@ -4259,10 +4304,12 @@ async function handleAiKey(args) {
   }
 
   throw new Error(`Unknown key command. Use:
+  iola ai key set yandexgpt
+  iola ai key set gigachat
   iola ai key set openai
   iola ai key set openrouter
   iola ai key status
-  iola ai key delete openai|openrouter`);
+  iola ai key delete yandexgpt|gigachat|openai|openrouter`);
 }
 
 async function handleAiProfile(args) {
@@ -4304,8 +4351,8 @@ async function aiModels(args) {
   const [provider] = args;
   const options = parseOptions(args.slice(1));
 
-  if (!["iola", "ollama", "openai", "openrouter", "codex"].includes(provider)) {
-    throw new Error("Провайдер обязателен: iola ai models iola|ollama|openai|openrouter|codex");
+  if (!["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"].includes(provider)) {
+    throw new Error("Провайдер обязателен: iola ai models iola|ollama|yandexgpt|gigachat|openai|openrouter|codex");
   }
 
   const models = await listAiModels(provider);
@@ -4412,6 +4459,23 @@ async function listAiModels(provider) {
       .sort((left, right) => left.id.localeCompare(right.id));
   }
 
+  if (provider === "yandexgpt") {
+    return [
+      { id: "yandexgpt-lite/latest", provider: "yandexgpt", note: "быстрая и недорогая модель" },
+      { id: "yandexgpt/latest", provider: "yandexgpt", note: "YandexGPT Pro, latest" },
+      { id: "yandexgpt/rc", provider: "yandexgpt", note: "YandexGPT Pro, release candidate" },
+    ];
+  }
+
+  if (provider === "gigachat") {
+    return [
+      { id: "GigaChat-2", provider: "gigachat", note: "основная модель" },
+      { id: "GigaChat-2-Pro", provider: "gigachat", note: "повышенное качество" },
+      { id: "GigaChat-2-Max", provider: "gigachat", note: "максимальное качество" },
+      { id: "GigaChat", provider: "gigachat", note: "legacy/fallback" },
+    ];
+  }
+
   const version = await getCommandVersion("codex", ["--version"]);
   return [
     { id: "gpt-5.5", provider: "codex", note: version },
@@ -4562,7 +4626,7 @@ async function printAiProfiles() {
     baseUrl: profile.baseUrl || "-",
     mode: profile.provider === "codex"
       ? `sandbox=${profile.sandbox || "read-only"}, approval=${profile.approval || "never"}`
-      : (profile.provider === "openai" || profile.provider === "openrouter" ? `network=${getAiNetworkMode(profile)}` : "-"),
+      : (profile.provider === "openai" || profile.provider === "openrouter" || profile.provider === "yandexgpt" || profile.provider === "gigachat" ? `network=${getAiNetworkMode(profile)}` : "-"),
   }));
 
   printTable(rows, [
@@ -4595,8 +4659,8 @@ async function addAiProfile(name, args) {
   const options = parseOptions(args);
   const provider = options.provider;
 
-  if (!["iola", "ollama", "openai", "openrouter", "codex"].includes(provider)) {
-    throw new Error("Провайдер должен быть iola, ollama, openai, openrouter или codex.");
+  if (!["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"].includes(provider)) {
+    throw new Error("Провайдер должен быть iola, ollama, yandexgpt, gigachat, openai, openrouter или codex.");
   }
 
   const profile = buildProfileFromOptions(provider, options);
@@ -4676,6 +4740,7 @@ async function deleteAiProfile(name) {
 
 function buildProfileFromOptions(provider, options) {
   const defaults = DEFAULT_AI_CONFIG.ai.profiles[provider === "ollama" || provider === "iola" ? "local" : provider];
+  if (!defaults) throw new Error(`Неизвестный AI-провайдер: ${provider}`);
   const profile = {
     ...defaults,
     provider,
@@ -4724,13 +4789,15 @@ async function useAiProvider(args) {
 
   const provider = providerOrProfile;
 
-  if (provider !== "iola" && provider !== "ollama" && provider !== "openai" && provider !== "openrouter" && provider !== "codex") {
-    throw new Error("Провайдер должен быть iola, ollama, openai, openrouter, codex или именем AI-профиля.");
+  if (!["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"].includes(provider)) {
+    throw new Error("Провайдер должен быть iola, ollama, yandexgpt, gigachat, openai, openrouter, codex или именем AI-профиля.");
   }
 
   const defaultModel = {
     iola: IOLA_LOCAL_MODEL,
     ollama: config.ai.provider === "ollama" ? config.ai.model : IOLA_LOCAL_OLLAMA_MODEL,
+    yandexgpt: config.ai.provider === "yandexgpt" ? config.ai.model : "yandexgpt-lite/latest",
+    gigachat: config.ai.provider === "gigachat" ? config.ai.model : "GigaChat-2",
     openai: config.ai.provider === "openai" ? config.ai.model : "gpt-4.1-mini",
     openrouter: config.ai.provider === "openrouter" ? config.ai.model : "openai/gpt-4.1-mini",
     codex: config.ai.provider === "codex" ? config.ai.model : "gpt-5.5",
@@ -4775,6 +4842,7 @@ function normalizeModelMenuTarget(value = "") {
   const normalized = String(value || "").trim().toLocaleLowerCase("ru-RU");
   if (!normalized) return "";
   if (["local", "локальная", "локально", "iola", "иола", "ollama"].includes(normalized)) return "local";
+  if (["ru", "rus", "russian", "российские", "российская", "россия", "яндекс", "yandex", "yandexgpt", "gigachat", "гигачат"].includes(normalized)) return normalized === "yandexgpt" || normalized === "яндекс" || normalized === "yandex" ? "yandexgpt" : normalized === "gigachat" || normalized === "гигачат" ? "gigachat" : "russian";
   if (["api", "апи"].includes(normalized)) return "api";
   if (normalized === "openai") return "openai";
   if (normalized === "openrouter" || normalized === "router") return "openrouter";
@@ -4784,19 +4852,20 @@ function normalizeModelMenuTarget(value = "") {
 
 async function chooseModelTarget() {
   console.log("Выберите AI-подключение:");
-  console.log("  1. Локальная модель IOLA");
-  console.log("  2. API (OpenAI/OpenRouter)");
-  console.log("  3. Codex CLI");
+  console.log("  1. Локальные модели");
+  console.log("  2. Российские AI (YandexGPT/GigaChat)");
+  console.log("  3. API (OpenAI/OpenRouter)");
+  console.log("  4. Codex CLI");
   console.log("  0. Отмена");
 
   const answer = await askText("Номер: ");
-  return { 1: "local", 2: "api", 3: "codex" }[answer.trim()] || "";
+  return { 1: "local", 2: "russian", 3: "api", 4: "codex" }[answer.trim()] || "";
 }
 
 async function openModelTargetMenu(target) {
   if (target === "local") {
-    const model = await chooseAiModel("iola");
-    if (model) await switchModelTarget("local", model);
+    const selection = await chooseLocalModel();
+    if (selection?.model) await switchModelTarget(selection.provider, selection.model);
     return;
   }
 
@@ -4812,6 +4881,20 @@ async function openModelTargetMenu(target) {
     return;
   }
 
+  if (target === "yandexgpt" || target === "gigachat") {
+    const model = await chooseAiModel(target);
+    if (model) await switchModelTarget(target, model);
+    return;
+  }
+
+  if (target === "russian") {
+    const provider = await chooseRussianProvider();
+    if (!provider) return;
+    const model = await chooseAiModel(provider);
+    if (model) await switchModelTarget(provider, model);
+    return;
+  }
+
   const provider = await chooseApiProvider();
   if (!provider) return;
   const model = await chooseAiModel(provider);
@@ -4837,6 +4920,25 @@ async function chooseApiProvider() {
   return choices[answer - 1]?.id || "";
 }
 
+async function chooseRussianProvider() {
+  const config = await loadConfig();
+  const russianProfiles = Object.entries(config.ai.profiles || {})
+    .filter(([, profile]) => profile.provider === "yandexgpt" || profile.provider === "gigachat")
+    .map(([name, profile]) => ({ id: profile.provider, label: `${name}: ${profile.provider} (${profile.model || "-"})` }));
+  const choices = [
+    ...russianProfiles,
+    { id: "yandexgpt", label: "YandexGPT API" },
+    { id: "gigachat", label: "GigaChat API" },
+  ].filter((item, index, array) => array.findIndex((candidate) => candidate.id === item.id) === index);
+
+  console.log("Выберите российское AI-подключение:");
+  choices.forEach((item, index) => console.log(`  ${index + 1}. ${item.label}`));
+  console.log("  0. Отмена");
+
+  const answer = Number(await askText("Номер: "));
+  return choices[answer - 1]?.id || "";
+}
+
 async function getDefaultApiProviderForModelSwitch() {
   const config = await loadConfig();
   const activeProfile = config.ai.profiles?.[getActiveProfileName(config)];
@@ -4845,12 +4947,43 @@ async function getDefaultApiProviderForModelSwitch() {
   return apiProfile?.provider || "openai";
 }
 
+async function chooseLocalModel() {
+  const models = await listAiModels("ollama");
+  const choices = [
+    { id: IOLA_LOCAL_MODEL, provider: "iola", label: `${IOLA_LOCAL_MODEL} - IOLA local router` },
+    ...models
+      .filter((model) => model.id !== IOLA_LOCAL_MODEL)
+      .map((model) => ({
+        id: model.id,
+        provider: "ollama",
+        label: `${model.id}${model.note ? ` - ${model.note}` : ""}`,
+      })),
+    { id: "__manual__", provider: "ollama", label: "Другая Ollama-модель: ввести имя вручную" },
+  ].filter((item, index, array) => array.findIndex((candidate) => candidate.id === item.id) === index);
+
+  console.log("Выберите локальную модель:");
+  choices.forEach((choice, index) => console.log(`  ${index + 1}. ${choice.label}`));
+  console.log("  0. Отмена");
+
+  const answer = Number(await askText("Номер: "));
+  const selected = choices[answer - 1];
+  if (!selected) return null;
+
+  if (selected.id === "__manual__") {
+    const model = (await askText("Имя Ollama-модели, например qwen3:4b: ")).trim();
+    if (!model) return null;
+    return { provider: "ollama", model };
+  }
+
+  return { provider: selected.provider, model: selected.id };
+}
+
 async function chooseAiModel(provider) {
   if (provider === "openrouter") {
     return chooseOpenRouterModel();
   }
 
-  if (provider === "openai") {
+  if (provider === "openai" || provider === "yandexgpt" || provider === "gigachat") {
     const ready = await ensureApiKeyForModelSelection(provider);
     if (!ready) return "";
   }
@@ -4955,9 +5088,14 @@ async function chooseOpenRouterModel() {
 }
 
 async function ensureApiKeyForModelSelection(provider) {
-  if (provider !== "openai" && provider !== "openrouter") return true;
-  if (await getApiKey(provider)) return true;
-  const label = provider === "openai" ? "OpenAI" : "OpenRouter";
+  if (!["openai", "openrouter", "yandexgpt", "gigachat"].includes(provider)) return true;
+  if (await getApiKey(provider) && (provider !== "yandexgpt" || await getYandexFolderId())) return true;
+  const label = {
+    openai: "OpenAI",
+    openrouter: "OpenRouter",
+    yandexgpt: "YandexGPT",
+    gigachat: "GigaChat",
+  }[provider];
   console.log(`${label} API key не найден. Введите ключ, чтобы получить список моделей.`);
   try {
     await setAiKey(provider);
@@ -4988,7 +5126,9 @@ async function switchModelTarget(target, model) {
     if (!ready) return;
   }
   const profileName = provider === "ollama" || provider === "iola" ? "local" : provider;
-  const currentProfile = config.ai.profiles?.[profileName] || buildProfileFromOptions(provider, { model });
+  const currentProfile = (provider === "ollama" || provider === "iola")
+    ? buildProfileFromOptions(provider, { model })
+    : (config.ai.profiles?.[profileName] || buildProfileFromOptions(provider, { model }));
   const profile = {
     ...currentProfile,
     provider,
@@ -5081,7 +5221,12 @@ async function setAiKey(provider) {
     throw new Error("Для сохранения ключа запустите команду в интерактивном терминале.");
   }
 
-  const envName = provider === "openai" ? "OPENAI_API_KEY" : "OPENROUTER_API_KEY";
+  const envName = {
+    openai: "OPENAI_API_KEY",
+    openrouter: "OPENROUTER_API_KEY",
+    yandexgpt: "YANDEXGPT_API_KEY",
+    gigachat: "GIGACHAT_AUTH_KEY",
+  }[provider];
   const key = (await askText(`Введите ${envName}: `)).trim();
 
   if (!key) {
@@ -5089,23 +5234,44 @@ async function setAiKey(provider) {
   }
 
   const secrets = await loadSecrets();
-  secrets[provider] = { apiKey: key };
+  if (provider === "yandexgpt") {
+    const folderId = (await askText("Введите YANDEXGPT_FOLDER_ID / ID каталога Yandex Cloud: ")).trim();
+    if (!folderId) throw new Error("Folder ID пустой, сохранение отменено.");
+    secrets[provider] = { apiKey: key, folderId };
+  } else if (provider === "gigachat") {
+    const scope = (await askText("Scope [GIGACHAT_API_PERS]: ")).trim() || "GIGACHAT_API_PERS";
+    secrets[provider] = { apiKey: key, scope };
+  } else {
+    secrets[provider] = { apiKey: key };
+  }
   await saveSecrets(secrets);
   console.log(`Ключ ${provider} сохранен локально: ${SECRETS_FILE}`);
 }
 
 async function printAiKeyStatus() {
   const secrets = await loadSecrets();
-  const rows = ["openai", "openrouter"].map((provider) => ({
-    provider,
-    env: provider === "openai" ? (process.env.OPENAI_API_KEY ? "yes" : "no") : (process.env.OPENROUTER_API_KEY ? "yes" : "no"),
-    local: secrets[provider]?.apiKey ? "yes" : "no",
-  }));
+  const rows = ["yandexgpt", "gigachat", "openai", "openrouter"].map((provider) => {
+    const env = {
+      openai: process.env.OPENAI_API_KEY,
+      openrouter: process.env.OPENROUTER_API_KEY,
+      yandexgpt: process.env.YANDEXGPT_API_KEY || process.env.YANDEX_CLOUD_API_KEY,
+      gigachat: process.env.GIGACHAT_AUTH_KEY || process.env.GIGACHAT_API_KEY,
+    }[provider];
+    return {
+      provider,
+      env: env ? "yes" : "no",
+      local: secrets[provider]?.apiKey ? "yes" : "no",
+      extra: provider === "yandexgpt"
+        ? ((process.env.YANDEXGPT_FOLDER_ID || process.env.YANDEX_CLOUD_FOLDER_ID || secrets.yandexgpt?.folderId) ? "folder ok" : "folder missing")
+        : (provider === "gigachat" && secrets.gigachat?.scope ? `scope ${secrets.gigachat.scope}` : ""),
+    };
+  });
 
   printTable(rows, [
     ["provider", "Провайдер"],
     ["env", "Env"],
     ["local", "Локально"],
+    ["extra", "Дополнительно"],
   ]);
 }
 
@@ -6360,26 +6526,30 @@ function toCsv(rows) {
 }
 
 function assertKeyProvider(provider) {
-  if (provider !== "openai" && provider !== "openrouter") {
-    throw new Error("Провайдер должен быть openai или openrouter.");
+  if (!["openai", "openrouter", "yandexgpt", "gigachat"].includes(provider)) {
+    throw new Error("Провайдер должен быть yandexgpt, gigachat, openai или openrouter.");
   }
 }
 
 async function chooseAiProvider() {
   console.log("Выберите режим AI:");
   console.log("1. Локальная модель IOLA");
-  console.log("2. OpenAI API");
-  console.log("3. OpenRouter API");
-  console.log("4. Codex/MCP");
-  console.log("5. Ollama");
+  console.log("2. Ollama");
+  console.log("3. YandexGPT API");
+  console.log("4. GigaChat API");
+  console.log("5. OpenAI API");
+  console.log("6. OpenRouter API");
+  console.log("7. Codex/MCP");
 
   const answer = (await askText("Введите номер [1]: ")).trim() || "1";
   return {
     1: "iola",
-    2: "openai",
-    3: "openrouter",
-    4: "codex",
-    5: "ollama",
+    2: "ollama",
+    3: "yandexgpt",
+    4: "gigachat",
+    5: "openai",
+    6: "openrouter",
+    7: "codex",
   }[answer] || "iola";
 }
 
@@ -7967,6 +8137,14 @@ async function callAiProvider(config, messages) {
     return callOpenAiCompatible(config, messages, await getApiKey("openrouter"), "OpenRouter");
   }
 
+  if (config.provider === "yandexgpt") {
+    return callYandexGpt(config, messages);
+  }
+
+  if (config.provider === "gigachat") {
+    return callGigaChat(config, messages);
+  }
+
   if (config.provider === "codex") {
     return callCodex(config, messages);
   }
@@ -8444,6 +8622,96 @@ async function callAiRelayModels(config, apiKey, providerName) {
   return response.json();
 }
 
+async function callYandexGpt(config, messages) {
+  const apiKey = await getApiKey("yandexgpt");
+  const folderId = await getYandexFolderId();
+  if (!apiKey || !folderId) {
+    throw new Error("YandexGPT API key или folder ID не найден. Выполните iola ai key set yandexgpt или задайте YANDEXGPT_API_KEY и YANDEXGPT_FOLDER_ID.");
+  }
+
+  const model = config.model || "yandexgpt-lite/latest";
+  const modelUri = model.startsWith("gpt://") ? model : `gpt://${folderId}/${model}`;
+  const response = await fetch(`${String(config.baseUrl || "https://llm.api.cloud.yandex.net/foundationModels/v1").replace(/\/+$/, "")}/completion`, {
+    method: "POST",
+    headers: {
+      authorization: `Api-Key ${apiKey}`,
+      "content-type": "application/json",
+    },
+    body: JSON.stringify({
+      modelUri,
+      completionOptions: {
+        stream: false,
+        temperature: Number(config.temperature ?? 0.2),
+        maxTokens: String(config.maxTokens || 2000),
+      },
+      messages: messages.map((message) => ({
+        role: message.role === "assistant" ? "assistant" : message.role === "system" ? "system" : "user",
+        text: message.content,
+      })),
+    }),
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`YandexGPT request failed: ${response.status} ${response.statusText}\n${sanitizeSecretFromText(text, apiKey)}`);
+  }
+
+  const payload = await response.json();
+  return payload.result?.alternatives?.[0]?.message?.text || "";
+}
+
+async function callGigaChat(config, messages) {
+  const authKey = await getApiKey("gigachat");
+  if (!authKey) {
+    throw new Error("GigaChat authorization key не найден. Выполните iola ai key set gigachat или задайте GIGACHAT_AUTH_KEY.");
+  }
+
+  const token = await getGigaChatAccessToken(config, authKey);
+  const response = await fetch(`${String(config.baseUrl || "https://gigachat.devices.sberbank.ru/api/v1").replace(/\/+$/, "")}/chat/completions`, {
+    method: "POST",
+    headers: {
+      authorization: `Bearer ${token}`,
+      "content-type": "application/json",
+    },
+    body: JSON.stringify({
+      model: config.model || "GigaChat-2",
+      messages,
+      temperature: Number(config.temperature ?? 0.2),
+    }),
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`GigaChat request failed: ${response.status} ${response.statusText}\n${sanitizeSecretFromText(text, token)}`);
+  }
+
+  const payload = await response.json();
+  return payload.choices?.[0]?.message?.content || "";
+}
+
+async function getGigaChatAccessToken(config, authKey) {
+  const secrets = await loadSecrets();
+  const scope = process.env.GIGACHAT_SCOPE || secrets.gigachat?.scope || config.scope || "GIGACHAT_API_PERS";
+  const response = await fetch(config.authUrl || "https://ngw.devices.sberbank.ru:9443/api/v2/oauth", {
+    method: "POST",
+    headers: {
+      authorization: `Basic ${authKey}`,
+      "content-type": "application/x-www-form-urlencoded",
+      RqUID: randomUUID(),
+    },
+    body: new URLSearchParams({ scope }).toString(),
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`GigaChat token request failed: ${response.status} ${response.statusText}\n${sanitizeSecretFromText(text, authKey)}`);
+  }
+
+  const payload = await response.json();
+  if (!payload.access_token) throw new Error("GigaChat не вернул access_token.");
+  return payload.access_token;
+}
+
 function getAiNetworkMode(config = {}) {
   return validateAiNetworkMode(AI_NETWORK_MODE || config.networkMode || "gateway");
 }
@@ -8474,10 +8742,26 @@ async function getApiKey(provider) {
     return process.env.OPENROUTER_API_KEY;
   }
 
+  if (provider === "yandexgpt" && (process.env.YANDEXGPT_API_KEY || process.env.YANDEX_CLOUD_API_KEY)) {
+    return process.env.YANDEXGPT_API_KEY || process.env.YANDEX_CLOUD_API_KEY;
+  }
+
+  if (provider === "gigachat" && (process.env.GIGACHAT_AUTH_KEY || process.env.GIGACHAT_API_KEY)) {
+    return process.env.GIGACHAT_AUTH_KEY || process.env.GIGACHAT_API_KEY;
+  }
+
   const secrets = await loadSecrets();
   return secrets[provider]?.apiKey || "";
 }
 
+async function getYandexFolderId() {
+  if (process.env.YANDEXGPT_FOLDER_ID || process.env.YANDEX_CLOUD_FOLDER_ID) {
+    return process.env.YANDEXGPT_FOLDER_ID || process.env.YANDEX_CLOUD_FOLDER_ID;
+  }
+  const secrets = await loadSecrets();
+  return secrets.yandexgpt?.folderId || "";
+}
+
 async function listLayers(args) {
   const options = parseOptions(args);
   const info = await fetchJson(`${await getMcpBaseUrl()}/mcp-version`);
@@ -8735,6 +9019,20 @@ async function onboard(args = []) {
       await chooseAndSaveApiModel("openrouter");
     }
   }
+  if (components.includes("yandexgpt")) {
+    await aiSetup(["yandexgpt"]);
+    if (process.stdin.isTTY) {
+      await setAiKey("yandexgpt");
+      await chooseAndSaveApiModel("yandexgpt");
+    }
+  }
+  if (components.includes("gigachat")) {
+    await aiSetup(["gigachat"]);
+    if (process.stdin.isTTY) {
+      await setAiKey("gigachat");
+      await chooseAndSaveApiModel("gigachat");
+    }
+  }
   if (components.includes("codex")) {
     await installCodexIfMissing();
     await aiSetup(["codex"]);
@@ -8773,14 +9071,16 @@ async function chooseOnboardComponents(status = null) {
       1: "workspace",
       2: "policy",
       3: "iola",
-      4: "openai",
-      5: "openrouter",
-      6: "codex",
-      7: "codex-mcp",
-      8: "archive",
-      9: "index",
-      10: "browser",
-      11: "ollama",
+      4: "yandexgpt",
+      5: "gigachat",
+      6: "openai",
+      7: "openrouter",
+      8: "codex",
+      9: "codex-mcp",
+      10: "archive",
+      11: "index",
+      12: "browser",
+      13: "ollama",
     };
     return [...selected].map((item) => map[item] || item).filter(Boolean);
   } finally {
@@ -8808,6 +9108,8 @@ async function getOnboardComponentStatus() {
     policy: policyReady,
     iola: Boolean(readiness.iola),
     ollama: Boolean(ollamaVersion && readiness.ollama),
+    yandexgpt: Boolean(readiness.yandexgpt),
+    gigachat: Boolean(readiness.gigachat),
     openai: Boolean(readiness.openai),
     openrouter: Boolean(readiness.openrouter),
     codex: Boolean(codexVersion !== "не найден" && readiness.codex),
@@ -8823,14 +9125,16 @@ function onboardComponentRows(status) {
     ["1", "workspace", "workspace и контекст", "рабочая папка, IOLA.md и .iola/context.md"],
     ["2", "policy", "policy analyst", "разрешения и профиль аналитика"],
     ["3", "iola", "IOLA локальная модель", "локальная модель найдена"],
-    ["4", "openai", "OpenAI API", "API-ключ сохранен или есть в env"],
-    ["5", "openrouter", "OpenRouter API", "API-ключ сохранен или есть в env"],
-    ["6", "codex", "Codex CLI", "CLI установлен и авторизация найдена"],
-    ["7", "codex-mcp", "MCP для Codex", "можно переустановить/обновить"],
-    ["8", "archive", "7-Zip / архивы", "архиватор найден"],
-    ["9", "index", "Индекс локальных документов", "настраивается под выбранную папку"],
-    ["10", "browser", "Browser runtime", "Playwright/Chromium установлен"],
-    ["11", "ollama", "Ollama", "опциональный локальный runtime"],
+    ["4", "yandexgpt", "YandexGPT API", "ключ и folder ID сохранены или есть в env"],
+    ["5", "gigachat", "GigaChat API", "authorization key сохранен или есть в env"],
+    ["6", "openai", "OpenAI API", "API-ключ сохранен или есть в env"],
+    ["7", "openrouter", "OpenRouter API", "API-ключ сохранен или есть в env"],
+    ["8", "codex", "Codex CLI", "CLI установлен и авторизация найдена"],
+    ["9", "codex-mcp", "MCP для Codex", "можно переустановить/обновить"],
+    ["10", "archive", "7-Zip / архивы", "архиватор найден"],
+    ["11", "index", "Индекс локальных документов", "настраивается под выбранную папку"],
+    ["12", "browser", "Browser runtime", "Playwright/Chromium установлен"],
+    ["13", "ollama", "Ollama", "опциональный локальный runtime"],
   ];
   return rows.map(([number, key, title, hint]) => ({ number, key, title, hint, status: status[key] ? "готово" : "не настроено" }));
 }
@@ -8840,12 +9144,12 @@ function defaultOnboardSelection(status) {
   if (!status.workspace) defaults.push("1");
   if (!status.policy) defaults.push("2");
   if (!status.iola) defaults.push("3");
-  if (!status.archive) defaults.push("8");
+  if (!status.archive) defaults.push("10");
   return defaults.length ? defaults : ["1", "2"];
 }
 
 function defaultOnboardComponents(status) {
-  const map = { 1: "workspace", 2: "policy", 3: "iola", 4: "openai", 5: "openrouter", 6: "codex", 7: "codex-mcp", 8: "archive", 9: "index", 10: "browser", 11: "ollama" };
+  const map = { 1: "workspace", 2: "policy", 3: "iola", 4: "yandexgpt", 5: "gigachat", 6: "openai", 7: "openrouter", 8: "codex", 9: "codex-mcp", 10: "archive", 11: "index", 12: "browser", 13: "ollama" };
   return defaultOnboardSelection(status).map((item) => map[item]).filter(Boolean);
 }
 
@@ -10821,6 +11125,9 @@ function sanitizeConfig(config) {
     if (profile?.provider === "openai" || profile?.provider === "openrouter") {
       profile.networkMode = profile.networkMode || "gateway";
     }
+    if (profile?.provider === "yandexgpt" || profile?.provider === "gigachat") {
+      profile.networkMode = profile.networkMode || "direct";
+    }
   }
   return next;
 }
@@ -10833,7 +11140,7 @@ function validateConfig(config) {
   if (!config.ai?.profiles || typeof config.ai.profiles !== "object") errors.push("ai.profiles обязателен");
   if (config.ai?.activeProfile && !config.ai.profiles?.[config.ai.activeProfile]) errors.push(`ai.activeProfile не найден в profiles: ${config.ai.activeProfile}`);
   for (const [name, profile] of Object.entries(config.ai?.profiles || {})) {
-    if (!["iola", "ollama", "openai", "openrouter", "codex"].includes(profile.provider)) errors.push(`ai.profiles.${name}.provider неизвестен`);
+    if (!["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"].includes(profile.provider)) errors.push(`ai.profiles.${name}.provider неизвестен`);
     if (profile.provider !== "codex" && profile.provider !== "iola" && !profile.baseUrl) errors.push(`ai.profiles.${name}.baseUrl обязателен`);
     if (profile.networkMode && !["direct", "gateway", "auto"].includes(profile.networkMode)) errors.push(`ai.profiles.${name}.networkMode должен быть direct, gateway или auto`);
   }
@@ -10852,7 +11159,7 @@ function configSchema() {
     required: ["api", "ai"],
     properties: {
       api: { required: ["baseUrl", "mcpBaseUrl"] },
-      ai: { required: ["activeProfile", "profiles"], providers: ["iola", "ollama", "openai", "openrouter", "codex"] },
+      ai: { required: ["activeProfile", "profiles"], providers: ["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"] },
       permissions: { localTools: ALL_LOCAL_TOOLS, runtime: ["readFiles", "writeFiles", "editFiles", "deleteFiles", "sync", "externalApi", "externalAi", "codex"] },
       toolsets: { available: Object.keys(TOOLSETS) },
       files: { modes: ["locked", "read-only", "workspace-write", "full-access"], approvals: ["never", "on-write", "on-danger", "always"] },

package/test/smoke-test.js

@@ -55,6 +55,8 @@ assertIncludes(cliSource, "\\x1b[1m$1\\x1b[22m", "AI answer renderer should supp
 assertIncludes(cliSource, "ensureApiKeyForModelSelection", "API model selection should prompt for missing provider keys");
 assertIncludes(cliSource, "isOpenAiTextGenerationModel", "OpenAI model selection should filter technical and legacy models");
 assertIncludes(cliSource, "dedupeDatedOpenAiModels", "OpenAI model selection should hide dated duplicates when aliases exist");
+assertIncludes(cliSource, "chooseLocalModel", "Local model selection should support IOLA and Ollama models");
+assertIncludes(cliSource, "Другая Ollama-модель", "Local model selection should allow manual Ollama model names");
 
 const commands = await runCli(["commands"]);
 assertIncludes(commands, "iola browser status|install|open|text|html|screenshot|pdf|click|type|eval", "commands");

package/wiki/AI-/320/277/321/200/320/276/321/204/320/270/320/273/320/270.md

@@ -10,22 +10,103 @@ iola ai profile use local
 iola ask "найди школы на Петрова"
 ```
 
+В интерактивном агенте команда `/model` открывает выбор локальной модели. В локальном меню доступны:
+
+- штатная модель IOLA `iola-router:qwen3-1.7b-v4-q8`;
+- установленные и рекомендуемые модели Ollama;
+- ручной ввод имени любой Ollama-модели.
+
+Если выбранная Ollama-модель еще не установлена, CLI предложит скачать ее через `ollama pull`. При выборе сторонней Ollama-модели профиль `local` сохраняется как `provider: ollama`; при выборе штатной модели IOLA профиль `local` возвращается к `provider: iola`.
+
+## Российские AI
+
+Российские провайдеры вынесены в отдельный блок `/model` и вызываются напрямую, без gateway/proxy:
+
+```text
+/model
+2. Российские AI (YandexGPT/GigaChat)
+```
+
+### YandexGPT
+
+Официальные страницы:
+
+- документация Foundation Models: `https://yandex.cloud/ru/docs/foundation-models/`;
+- аутентификация API: `https://yandex.cloud/ru/docs/ai-studio/api-ref/authentication`;
+- тарифы: `https://yandex.cloud/ru/docs/foundation-models/pricing`.
+
+Для CLI нужны API key и ID каталога Yandex Cloud:
+
+```bash
+iola ai key set yandexgpt
+iola ai setup yandexgpt --model yandexgpt-lite/latest
+```
+
+CLI также понимает env-переменные `YANDEXGPT_API_KEY` или `YANDEX_CLOUD_API_KEY`, а для каталога - `YANDEXGPT_FOLDER_ID` или `YANDEX_CLOUD_FOLDER_ID`.
+
+### GigaChat
+
+Официальные страницы:
+
+- документация GigaChat: `https://developers.sber.ru/docs/ru/gigachat/overview`;
+- получение OAuth-токена: `https://developers.sber.ru/docs/ru/gigachat/api/reference/rest/post-token`;
+- тарифы: `https://developers.sber.ru/docs/ru/gigachat/tariffs`.
+
+Для CLI нужен authorization key:
+
+```bash
+iola ai key set gigachat
+iola ai setup gigachat --model GigaChat-2
+```
+
+CLI также понимает env-переменные `GIGACHAT_AUTH_KEY` или `GIGACHAT_API_KEY`. По умолчанию используется scope `GIGACHAT_API_PERS`; при необходимости его можно задать через `GIGACHAT_SCOPE`.
+
+По тарифам: у GigaChat для физических лиц есть Freemium-лимит на токены; для больших объемов используются платные пакеты. У YandexGPT тарификация идет через Yandex Cloud по токенам и квотам аккаунта, поэтому актуальные бесплатные гранты или лимиты нужно проверять в консоли Yandex Cloud.
+
 ## OpenAI
 
+Получение ключа OpenAI Platform:
+
+1. Зарегистрируйтесь или войдите в OpenAI Platform: `https://platform.openai.com/`.
+2. Откройте страницу API-ключей: `https://platform.openai.com/api-keys`.
+3. Выберите нужный project или создайте новый project.
+4. Нажмите `Create new secret key`.
+5. Скопируйте ключ сразу после создания. Повторно посмотреть полный ключ обычно нельзя.
+6. В CLI сохраните ключ:
+
 ```bash
 iola ai key set openai
 iola ai setup openai --model gpt-4.1-mini
 iola ask "найди школу 29" --profile openai
 ```
 
+Важно: OpenAI API Platform и ChatGPT Plus/Pro - разные продукты. Подписка ChatGPT не заменяет API-биллинг. Для работы API обычно нужно отдельно настроить billing в OpenAI Platform.
+
 ## OpenRouter
 
+Получение ключа OpenRouter:
+
+1. Зарегистрируйтесь или войдите в OpenRouter: `https://openrouter.ai/`.
+2. Откройте страницу ключей: `https://openrouter.ai/settings/keys`.
+3. Нажмите создание нового API key.
+4. Задайте имя ключа и при необходимости лимит расходов.
+5. Скопируйте ключ сразу после создания. Храните его как секрет.
+6. В CLI сохраните ключ:
+
 ```bash
 iola ai key set openrouter
 iola ai setup openrouter --model openai/gpt-4.1-mini
 iola ai models openrouter --search qwen
 ```
 
+OpenRouter удобен тем, что через один ключ можно выбирать модели разных разработчиков: OpenAI, Anthropic, Google, Qwen / Alibaba, DeepSeek, Meta / Llama, Mistral AI и других.
+
+## Оплата
+
+Важно: оплата российскими банковскими картами для OpenAI Platform и OpenRouter может быть невозможна. Перед настройкой платных API заранее проверьте доступный способ оплаты и пополнения баланса в личном кабинете выбранного сервиса.
+
+Ключи YandexGPT, GigaChat, OpenAI и OpenRouter сохраняются локально на устройстве пользователя в `~/.iola/secrets.json`. CLI не публикует ключи в репозиторий и не записывает их в документацию.
+
 В интерактивном CLI модели удобнее выбирать через slash-команду:
 
 ```text
@@ -56,4 +137,4 @@ iola ai profile use local
 iola ai profile use openrouter
 ```
 
-В интерактивном агенте можно использовать `/model`, чтобы выбрать подключение и модель без ручного ввода id модели.
+В интерактивном агенте можно использовать `/model`, чтобы выбрать подключение и модель без ручного ввода id модели. Порядок меню: локальные модели, российские AI, зарубежные API, Codex CLI.

package/wiki/Home.md

@@ -10,7 +10,7 @@
 - проверка качества данных;
 - выгрузка CSV/JSON;
 - работа с локальной моделью Ollama;
-- работа с OpenAI, OpenRouter и Codex CLI;
+- работа с YandexGPT, GigaChat, OpenAI, OpenRouter и Codex CLI;
 - подключение публичного MCP-сервера.
 
 Быстрый старт:

package/wiki//320/234/320/260/321/201/321/202/320/265/321/200-/320/275/320/260/321/201/321/202/321/200/320/276/320/271/320/272/320/270.md

@@ -28,33 +28,47 @@ iola master
 
 Если модель уже скачана и доступна, пункт показывается как `готово`.
 
-### 4. OpenAI API
+После настройки локальную модель можно менять в интерактивном агенте через `/model`. Помимо штатной IOLA-модели можно выбрать установленную или рекомендуемую Ollama-модель, либо вручную ввести имя любой модели из библиотеки Ollama.
+
+### 4. YandexGPT API
+
+Настраивает профиль YandexGPT и сохраняет API key плюс folder ID локально у пользователя.
+
+Российский провайдер вызывается напрямую, без gateway/proxy.
+
+### 5. GigaChat API
+
+Настраивает профиль GigaChat и сохраняет authorization key локально у пользователя.
+
+Российский провайдер вызывается напрямую, без gateway/proxy.
+
+### 6. OpenAI API
 
 Настраивает профиль OpenAI и сохраняет API-ключ локально у пользователя.
 
 После сохранения ключа мастер предлагает выбрать модель из доступного списка.
 
-### 5. OpenRouter API
+### 7. OpenRouter API
 
 Настраивает профиль OpenRouter и сохраняет API-ключ локально у пользователя.
 
 После сохранения ключа мастер предлагает выбрать разработчика моделей OpenRouter, а затем одну из свежих моделей для текстовой работы. В списке моделей `0` возвращает к выбору разработчика.
 
-### 6. Codex CLI
+### 8. Codex CLI
 
 Проверяет наличие Codex CLI и авторизации. Если Codex уже установлен и вход выполнен, пункт показывается как `готово`.
 
-### 7. MCP для Codex
+### 9. MCP для Codex
 
 Добавляет MCP-сервер открытых данных Йошкар-Олы в Codex. Этот пункт можно запускать повторно для обновления подключения.
 
-### 8. 7-Zip / архивы
+### 10. 7-Zip / архивы
 
 Проверяет 7-Zip. Если архиватор не найден, мастер устанавливает его.
 
 Нужен для чтения, распаковки, сборки и индексирования архивов.
 
-### 9. Индекс локальных документов
+### 11. Индекс локальных документов
 
 Готовит режим чтения файлов и подсказывает команду индексирования локальной папки:
 
@@ -62,10 +76,14 @@ iola master
 iola index folder ./docs
 ```
 
-### 10. Browser runtime
+### 12. Browser runtime
 
 Проверяет Playwright/Chromium runtime. Нужен для браузерного агента.
 
+### 13. Ollama
+
+Опциональный локальный runtime для выбора сторонних моделей из библиотеки Ollama.
+
 Если runtime уже установлен, пункт показывается как `готово`.
 
 ## Повторный запуск

package/wiki//320/240/320/265/321/210/320/265/320/275/320/270/320/265-/320/277/321/200/320/276/320/261/320/273/320/265/320/274.md

@@ -24,14 +24,27 @@ ollama serve
 iola ai doctor
 ```
 
-## OpenAI/OpenRouter key не найден
+## 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