docs: explain OpenRouter vs Ollama choice

README: add comparison table section
solve_task.py: add comment in LLM template explaining model choice

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

README.md

@@ -22,6 +22,20 @@ AI-агент для автоматического выполнения зад
 - Gitea REST API (git.brojs.ru)
 - BroJS Journal MCP (platform.brojs.ru)
 
+## Почему OpenRouter, а не Ollama
+
+Все решения используют **OpenRouter** (`https://openrouter.ai/api/v1`) с моделью `openai/gpt-oss-20b:free` через стандартный `langchain_openai.ChatOpenAI`.
+
+| Критерий | OpenRouter | Ollama (локальная) |
+|---|---|---|
+| Требования к железу | Нет (облако) | GPU / 8–16 GB RAM |
+| Совместимость с LangChain | Полная (OpenAI-совместимый API) | Требует отдельного провайдера |
+| Смена модели | Одна строка в коде | Скачать новую модель (~GB) |
+| CI / автоматизация | Работает из любой среды | Нужен локальный сервер |
+| Стоимость | Бесплатный тир (`gpt-oss-20b:free`) | Бесплатно, но ресурсоёмко |
+
+Ключ хранится в `.env` как `OPENAI_API_KEY=sk-or-v1-...` — формат совместим с OpenAI SDK, поэтому смена провайдера (OpenAI, Azure, Ollama) не требует изменений в коде, только `.env`.
+
 ## Установка
 
 ```bash

solve_task.py

@@ -215,6 +215,11 @@ _PROMPT = '''\
 ```python
 import os
 from langchain_openai import ChatOpenAI
+
+# Используем OpenRouter вместо Ollama: облачный API не требует локального GPU,
+# совместим с OpenAI SDK «из коробки» (только base_url), легко масштабируется.
+# Модель gpt-oss-20b:free — бесплатный тир OpenRouter для учебных задач.
+# Ключ OPENAI_API_KEY=sk-or-v1-... хранится в .env (не в репозитории).
 llm = ChatOpenAI(
     model="openai/gpt-oss-20b:free",
     base_url="https://openrouter.ai/api/v1",