From ec197b7e98b74ab38f34121c94697cedc65c0890 Mon Sep 17 00:00:00 2001 From: gleb Date: Thu, 4 Jun 2026 19:13:54 +0300 Subject: [PATCH] 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 --- README.md | 14 ++++++++++++++ solve_task.py | 5 +++++ 2 files changed, 19 insertions(+) diff --git a/README.md b/README.md index 0ccff4d..4eb8ddf 100644 --- a/README.md +++ b/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 diff --git a/solve_task.py b/solve_task.py index 35c6a65..47ce589 100644 --- a/solve_task.py +++ b/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",