Лучшие фреймворки с открытым исходным кодом для агентов локальных LLM в 2026 году
Агент — это модель и оболочка. Оболочка запускает инструменты, хранит состояние, управляет разрешениями и передаёт контекст обратно модели. При использовании локальной модели оболочка имеет ещё большее значение. Небольшие окна контекста и менее надёжный вызов инструментов выявляют каждый недостаток конструкции.
В этом руководстве 11 оболочек с открытым исходным кодом ранжируются по качеству документации локального вывода. Все сведения о репозиториях были взяты из GitHub 18 сентября 2026 года. При составлении рейтинга учитывались 4 фактора: лицензия, одобренная OSI, документированные локальные среды выполнения, состояние поддержки и средства безопасности.
3 правила, применимые к каждой оболочке
1. Сначала увеличьте окно контекста: согласно документации Ollama об объёме контекста, значения по умолчанию зависят от объёма VRAM: 4k при объёме менее 24 ГиБ, 32k при объёме от 24 до 48 ГиБ и 256k при объёме 48 ГиБ или более. На той же странице сказано, что агентам и инструментам для программирования следует выделять не менее 64 000 токенов. Исправление занимает одну строку: OLLAMA_CONTEXT_LENGTH=64000 ollama serve.
2. Выбирайте модель с поддержкой вызова инструментов: в документации Goose по провайдерам говорится, что модели без поддержки вызова инструментов могут выполнять только дополнение чата. В случае llama.cpp документация Pi отмечает, что флаг --jinja включает совместимые шаблоны чата и вызов инструментов.
3. Честно оценивайте объём памяти: руководство Cline по локальному запуску сопоставляет 16–32 ГБ ОЗУ с небольшими квантованными моделями, 32–64 ГБ — с моделями среднего размера для программирования, а 64 ГБ или более — с крупными моделями. На странице Ollama о Hermes указано, что gemma4 требуется около 16 ГБ VRAM, а qwen3.6 — около 24 ГБ VRAM.
1. OpenCode
OpenCode документирует 3 локальных варианта в собственной документации по провайдерам: Ollama, LM Studio и llama-server из llama.cpp. Каждый использует пакет @ai-sdk/openai-compatible с локальным baseURL. В целом документация заявляет о поддержке более 75 провайдеров.
Настройка может выполняться одной командой. На странице Ollama об OpenCode показана команда ollama launch opencode. Рекомендуется окно контекста не менее 64k токенов. В собственной документации OpenCode есть практический совет: если вызовы инструментов завершаются ошибкой, увеличьте num_ctx примерно до 16k–32k.
В поставку входят 2 встроенных агента. build имеет полный доступ. plan работает только в режиме чтения и запрашивает подтверждение перед выполнением команд bash.
Лучше всего подходит: разработчикам, которым нужна самая широкая документированная локальная настройка в одном терминальном инструменте.
2. Pi
Pi — минималистичный вариант. В его README модели доступны 4 инструмента: read, write, edit и bash. Он намеренно не включает MCP, субагентов, режим планирования и всплывающие окна с запросами разрешений. Эти функции добавляются с помощью расширений и пакетов TypeScript.
Pi изначально поддерживает сервер маршрутизации llama.cpp. Маршрутизатор обнаруживает несколько файлов GGUF и загружает их по мере необходимости. Управлять моделями внутри Pi можно с помощью команды /llama. Ollama также поддерживает его. Команда ollama launch pi устанавливает Pi, настраивает провайдера и открывает сеанс.
Для локального использования важно помнить об одном ограничении. В Pi нет встроенной системы разрешений. Он работает с разрешениями вашего пользователя. В README рекомендуются Docker, расширение для микро-ВМ или изолированная среда с политиками.
Старая ссылка badlogic/pi-mono теперь перенаправляет на earendil-works/pi. Earendil приобрела Pi в апреле 2026 года, а создатель проекта Марио Цехнер присоединился к компании. The Pragmatic Engineer сообщает, что Pi лежит в основе OpenClaw.
Лучше всего подходит: небольшим локальным моделям, которым короткий список инструментов оставляет больше контекста для кода.
3. Goose
Goose документирует больше локальных сред выполнения, чем любая другая представленная здесь оболочка. В его документации по провайдерам перечислены Ollama, LM Studio, Docker Model Runner, Ramalama и Atomic Chat. vLLM и KServe работают через совместимого с OpenAI провайдера. Пользовательские провайдеры могут не требовать ключ API для локальных серверов.
Управление проектом — важное отличие. Linux Foundation создала Agentic AI Foundation 9 декабря 2025 года, при этом Block внесла в фонд goose. Теперь репозиторий находится по адресу aaif-goose/goose. Goose написан на Rust и поставляется в виде настольного приложения, CLI и API. В README упоминается более 70 расширений MCP.
Настройка Ollama занимает немного времени. Запустите goose configure, выберите Ollama и введите название модели.
Лучше всего подходит: для общей автоматизации за пределами программирования под управлением нейтрального фонда.
4. Cline
Cline — самый сильный вариант среди решений на базе редакторов. В его руководстве по локальному запуску прежде всего рекомендуется включить параметр «Use Compact Prompt» для локального вывода. Также советуется сосредотачиваться на конкретных задачах и начинать новые сеансы при увеличении контекста.
По умолчанию каждое изменение файла и каждая команда требуют подтверждения. Автоматическое подтверждение можно включить дополнительно. Режимы Plan и Act разделяют стратегию и выполнение.
Стоит обратить внимание на одну деталь лицензирования. В собственном README Cline сообщает, что плагины для JetBrains не имеют открытого исходного кода. Расширение для VS Code, CLI и SDK находятся в репозитории под лицензией Apache-2.0.
Лучше всего подходит: пользователям VS Code, которым нужны подтверждения действий человеком при работе с локальной моделью.
5. OpenHands
OpenHands публикует самые конкретные рекомендации по локальному запуску. Его руководство по локальным LLM по состоянию на 21 мая 2026 года рекомендует в первую очередь попробовать Qwen3.6-35B-A3B. Требования к оборудованию сформулированы прямо. Для квантованных вариантов нужно как минимум 24 ГБ VRAM либо Mac на Apple Silicon с 64 ГБ объединённой памяти.
Рекомендации по контексту столь же однозначны. Установите длину контекста не менее 22 000 токенов, при этом рекомендуется 32 768. В руководстве предупреждается, что значение Ollama по умолчанию — 4 096 — не позволяет вместить даже системный промпт.
Пользователи Linux сталкиваются с одной особенностью. LM Studio по умолчанию привязывается к 127.0.0.1, поэтому OpenHands в Docker не может подключиться к нему. Включение параметра «Serve on Local Network» решает проблему.
Лучше всего подходит: для контейнеризованных длительных задач на рабочей станции или сервере с GPU.
6. Aider
Aider иначе справляется со слабыми возможностями вызова инструментов. В его форматах редактирования модель возвращает изменения в виде текста. Формат whole возвращает целые файлы. Формат diff возвращает блоки поиска и замены. Aider также отправляет карту репозитория с ключевыми символами при каждом запросе.
В его документации по Ollama отмечена реальная опасность. Ollama незаметно отбрасывает контекст, выходящий за пределы окна. Aider противодействует этому, рассчитывая размер окна для каждого запроса и добавляя 8k токенов для ответа. Обратите внимание, что на странице всё ещё упоминается устаревшее значение Ollama по умолчанию — 2k.
Вызывает вопросы состояние поддержки. На странице PyPI указана версия 0.86.2 от 12 февраля 2026 года. Предыдущий выпуск состоялся 13 августа 2025 года.
Лучше всего подходит: для парного программирования в стиле Git с моделями, которым сложно вызывать функции.
7. Codex CLI
Codex CLI распространяется под лицензией Apache-2.0 и поставляется с 2 встроенными локальными провайдерами. В исходном коде определены ollama на порту 11434 и lmstudio на порту 1234. Согласно странице Ollama о Codex, команда codex --oss по умолчанию использует gpt-oss:20b. Флаг -m позволяет выбрать другую модель.
Есть одно жёсткое ограничение. Теперь Codex работает только с Responses API по адресу /v1/responses. Исходный код отклоняет wire_api = "chat" и ссылается на это обсуждение. Локальный сервер должен предоставлять этот эндпоинт.
В репозитории есть отдельные пакеты песочницы для Linux и Windows.
Лучше всего подходит: командам, стандартизировавшим работу с gpt-oss и желающим получить встроенную песочницу.
8. Qwen Code
В README Qwen Code перечислены протоколы OpenAI, Anthropic, Gemini и Qwen. Для локальных моделей указаны Ollama и vLLM. Проект начинался на основе Google Gemini CLI v0.8.2. Синхронизация с исходным проектом прекратилась на версии v0.1. Для установки через npm требуется Node.js 22 или новее.
Лучше всего подходит: для использования моделей Qwen с открытыми весами и оболочкой, настроенной той же лабораторией.
9. Kilo Code
В README Kilo сказано, что Kilo CLI является форком OpenCode. Kilo сообщает, что проект начался как форк Roo в 2025 году. 2 апреля 2026 года был выпущен переработанный плагин для VS Code. В его документации по локальным моделям рассматриваются Ollama, LM Studio и Atomic Chat. На той же странице предупреждается, что локальным моделям часто недоступны кэширование промптов и управление компьютером.
Лучше всего подходит: бывшим пользователям Roo Code, которым нужен поддерживаемый вариант с поддержкой локальных моделей.
10. Hermes Agent
Hermes Agent от Nous Research — это агент общего назначения, а не инструмент для программирования. В его README описывается цикл обучения, в котором навыки создаются на основе опыта. Ollama сообщает, что в поставку входят более 70 навыков и память между сеансами. Для настройки Hermes используется адрес http://127.0.0.1:11434/v1, а длина контекста может определяться автоматически. Среди шлюзов обмена сообщениями — Telegram, Discord, Slack, WhatsApp, Signal и Email.
Лучше всего подходит: для постоянного персонального агента на локальных моделях.
11. OpenClaw
OpenClaw — проект с наибольшим числом звёзд в этом руководстве. Ollama описывает его как персонального помощника, который через центральный шлюз связывает сервисы обмена сообщениями с ИИ-агентами. Для локальных моделей Ollama рекомендует окно контекста не менее 64k. При первом запуске отображается уведомление о безопасности с объяснением рисков доступа к инструментам. Отнеситесь к нему серьёзно. Эта оболочка подключается к вашим аккаунтам обмена сообщениями.
Лучше всего подходит: для помощников, ориентированных прежде всего на обмен сообщениями, если пользователь готов управлять поверхностью безопасности.
Ключевые выводы
- OpenCode документирует больше всего локальных вариантов среди оболочек для программирования: Ollama, LM Studio и llama.cpp.
- Установите контекст в 64 000 токенов, прежде чем обвинять оболочку или модель.
- Конструкция Pi с 4 инструментами подходит небольшим моделям, но требует предоставленной вами песочницы.
- Codex CLI работает локально только через серверы, предоставляющие Responses API.
- Проверяйте лицензии каждого компонента: Crush распространяется под FSL, а плагин Cline для JetBrains является закрытым.
Переведено автоматически с английского. Оригинал статьи — по ссылке ниже.