mini-SWE-agent: как пользоваться агентом - Artem Denisov | Gen AI, vibecode, no-code automation & Design

mini-SWE-agent — это минимальный AI coding-агент в терминале: модель пишет bash-действия, вы подтверждаете шаги, агент правит код локально или в sandbox. Официальная дока — mini-swe-agent.com, пакет — mini-swe-agent на PyPI, CLI — mini. Команда SWE-agent рекомендует mini вместо классического SWE-agent для большинства задач.

Соседи: OpenCode, Claude Code, Aider, Codex CLI. Pillar — n8n / автоматизация.

Для кого mini

Берите mini, если нужен прозрачный агент без тяжёлого UI: понятный control flow, bash-only, удобно для локальных задач и бенчмарков. Если нужен IDE с графическим diff — смотрите Cursor/PearAI. Если нужен богатый набор tools и yaml-эксперименты — смотрите классический SWE-agent (maintenance-only).

Контур	Команда / путь	Деньги (мягко)*	Кому
Установка pip	`pip install mini-swe-agent`	0 ₽ за пакет	обычный Python env
uvx / pipx	`uvx mini-swe-agent`	0 ₽ за пакет	изолированный CLI
CLI mini	`mini` / `mini -t "…"`	плата за API модели	ежедневные задачи
Конфиг	`mini-extra config setup`	—	модель и ключи
Sandbox	docker/podman/singularity и др.	ваши ресурсы	безопасный прогон

*По mini-swe-agent.com (срез август 2026): агент open-source. Стоимость = API выбранной модели через litellm/OpenRouter/и др. Версия пакета на PyPI на момент проверки — 2.x. ₽ не фиксируем.

Как пользоваться: маршрут на 1 вечер

Установите: pip install mini-swe-agent или uvx mini-swe-agent.
Настройте модель: при первом запуске мастер, либо mini-extra config setup. Имя модели с провайдером: anthropic/…, openai/….
Зайдите в репозиторий и запустите mini (или mini -t "задача").
Режим confirm: читайте каждое действие, Enter = ок, отказ = короткий комментарий.
Узкая задача: один баг/тест/доки — не «перепиши архитектуру».
Проверьте итог тестами (pytest и т.п.) до merge.

# Установка
pip install mini-swe-agent
# или: uvx mini-swe-agent

# Настройка модели/ключей
mini-extra config setup

# Запуск в репозитории
cd /path/to/project
mini -t "Найди падающие тесты и почини минимальным diff. В конце прогони pytest."

# Полезные флаги
# mini -y          # yolo: без подтверждений (осторожно)
# mini -m anthropic/claude-...
# mini -c mini.yaml

Сильные стороны по доке

Около 100 строк ядра: легко читать и форкать под research/FT.
Только bash: не нужен tool-calling и установка пакетов агента внутри sandbox.
Линейная история = trajectory совпадает с промптом модели.
Независимые subprocess.run действия — стабильнее, чем «вечная» shell-сессия.
Сильные цифры на SWE-bench verified (в доке заявлены высокие scores; сверяйте leaderboard).

Типичные ошибки

Сразу включать yolo на проде без бэкапа/ветки.
Путать mini (рекомендуемый default) с legacy SWE-agent.
Указывать модель без префикса провайдера.
Давать агенту секреты в промпте вместо env.
Ждать GUI-diff как в Cursor — это терминальный REPL.

FAQ: mini-SWE-agent

Что такое mini-SWE-agent?

mini-SWE-agent (пакет mini-swe-agent, CLI mini) — минимальный coding-агент от команды Princeton/Stanford (SWE-bench/SWE-agent). Официальная дока — mini-swe-agent.com. Агент использует bash и линейную историю сообщений.

Чем mini отличается от SWE-agent?

Команда рекомендует mini как default: проще, быстрее стартует, без сложного tool-calling. Классический SWE-agent — в maintenance-only, если нужны кастомные tools и history processors. FAQ: mini-swe-agent.com/latest/faq/.

Как установить mini-SWE-agent?

pip install mini-swe-agent, либо uvx mini-swe-agent / pipx install mini-swe-agent, либо git clone + pip install -e . Затем команды mini и mini-extra. Источник: quickstart в доке.

Сколько стоит mini-SWE-agent?

Сам агент open-source и ставится бесплатно (PyPI). Платите только за API выбранной модели (OpenAI, Anthropic, OpenRouter и др. через litellm). ₽ и тарифы провайдеров в статье не выдумываем — сверяйте кабинет провайдера.

Какой режим безопаснее для новичка?

confirm (/c): модель предлагает действие, вы подтверждаете Enter или отклоняете с комментарием. yolo (/y) — без подтверждений, только если понимаете риск. Дока: usage/mini.

Какую модель ставить?

В quickstart команда рекомендует свежие Anthropic/OpenAI модели с префиксом провайдера (например anthropic/…). Точные имена моделей меняются — смотрите leaderboard и mini-extra config setup.

Вывод

mini-SWE-agent — простой и сильный CLI-агент: install → config → mini в confirm → узкая задача → тесты. OpenCode/Claude Code/Aider — соседи, если нужен другой UX.

Артём Денисов — эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Помогает выбрать: mini-SWE-agent vs Claude Code vs Aider.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Тех-pillar — n8n для начинающих.