AgentIndex icon
AgentIndex
ToolsCategoriesTrendingNewCompareGuides
Submit Tool
ToolsCategoriesTrendingNewCompareGuides
Home/
Code Assistant/
mini-swe-agent
mini-swe-agent logo

mini-swe-agent

Active·★ 8.3k·MIT·Updated 2026-10-06
★ Trending★ Hidden Gem

mini-swe-agent is a deliberately minimal AI software-engineering agent from the Princeton and Stanford team behind SWE-bench and SWE-agent. The core agent class is around 100 lines of Python, and the agent has no tools other than bash: it does not even use the model's tool-calling interface, so it works with essentially any model.

It suits researchers who need a simple, transparent baseline for coding-agent experiments and benchmarks, and developers who want a lightweight agent that solves GitHub issues or helps in the terminal. Despite its size, the project reports scores above 74% on SWE-bench Verified, and it is used by organisations including Meta, NVIDIA, IBM, Princeton and Stanford. It runs in local environments as well as Docker or Podman, Singularity/Apptainer and other sandboxes, and supports models through LiteLLM, OpenRouter, Portkey and more. Version 2 is current; a migration guide covers changes from v1.

Getting started: run it without installing via `uvx mini-swe-agent` or `pipx run mini-swe-agent`, or install with `pip install mini-swe-agent`, then configure a model key.

#AI Agent#Python#Software Engineering#Benchmarking#Minimalist#Coding
$ Install
$ pip install mini-swe-agent
↗ Visit site★ GitHub
01

Features

01Minimal code (approx. 100 lines of Python)
02High performance (>74% on SWE-bench verified benchmark)
03Easy deployment and sandboxing (Docker, Podman, Singularity)
04Utilizes only Bash tools, avoiding complex tool-calling interfaces
05Linear history for simplified debugging and fine-tuning
02

Why choose it

+Tiny, readable codebase that makes agent behaviour easy to understand and modify.
+Bash-only design works with any model, without tool-calling support.
+Strong benchmark results and wide adoption in research and industry.
+Many sandbox options; MIT licensed.
03

Trade-offs

!An agent that runs arbitrary bash commands should be sandboxed, especially when running unattended.
!Minimal by design: no IDE integration, rich UI or plugin ecosystem.
!Version 2 changed APIs, so older scripts need the migration guide.
04

Compatibility

Local Environment
Native
Verified via docs
Docker
Supported
Verified via docs
Podman
Supported
Verified via docs
Singularity
Supported
Verified via docs
Apptainer
Supported
Verified via docs
Large Language Models
Via LiteLLM
Verified via docs
05

Quick start

1
$ pip install mini-swe-agent
06

Use cases

↳Researchers for benchmarking, fine-tuning, or RL experiments without bloat
↳Developers who want to own, understand, and modify their AI tools
↳Engineers needing a trivial-to-sandbox and deployable solution anywhere
07

How it compares

≈vs SWE-agent: the same team's earlier, tool-rich agent; mini-swe-agent shows that a much simpler agent can perform nearly as well.
≈vs learn-claude-code: a course that builds a harness step by step; mini-swe-agent is a working minimal agent used for research.
≈vs Claude Code or Codex: full-featured commercial agents; mini-swe-agent is a transparent baseline you can fully read.
08

Alternatives

Context7 logo
Context7★ 62.8k
MCP Server that provides up-to-date code documentation for LLMs and AI code editors.
Gemini CLI logo
Gemini CLI★ 107.3k
An open-source AI agent that brings the power of Gemini directly into your terminal. Supports native MCP.
ragflow logo
ragflow★ 91.9k
RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine that fuses cutting-edge RAG with Agent capabilities to create a superior context layer for LLMs
GitHub MCP Server logo
GitHub MCP Server★ 33.5k
GitHub's official MCP Server. Allows AI agents to interact directly with your GitHub repositories (read files, search code, issues).
n8n logo
n8n★ 206.7k
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
Microsoft AutoGen logo
Microsoft AutoGen★ 61.3k
A framework that enables the development of LLM applications using multiple agents that can converse with each other to solve tasks.
CrewAI logo
CrewAI★ 59.5k
Framework for orchestrating role-playing, autonomous AI agents. By working together, your Crew can tackle complex tasks.
ToolJet logo
ToolJet★ 41.1k
ToolJet is the open-source foundation of ToolJet AI - the AI-native platform for building internal tools, dashboard, business applications, workflows and AI agents 🚀
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Compatibility05Quick start06Use cases07How it compares08Alternatives
Stats
GitHub Stars★ 8.3k
Last commit3d ago
StatusActive
LicenseMIT
CategoryCode Assistant
Trend (30d)
+0.3k↑ 4.3%
Links
Documentation↗Discussion↗Issues↗Releases↗

Deploy on DigitalOcean — Get $200 Free Credit

Ad
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
AboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

Code AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.