mini-swe-agent
The 100 line AI agent that solves GitHub issues or helps you in your command line. Radically simple, no huge configs, no giant monorepo—but scores >74% on SWE-b
What is mini-swe-agent?
The 100 line AI agent that solves GitHub issues or helps you in your command line. Radically simple, no huge configs, no giant monorepo—but scores >74% on SWE-bench verified!
Overview of mini-swe-agent
What it is
mini-swe-agent is a minimal AI software engineering agent, described as approximately 100 lines of Python for the agent class. It is designed to solve GitHub issues or assist in the command line. The project is built by the Princeton and Stanford team behind SWE-bench and SWE-agent. It is version 2 (v2) of mini-swe-agent.
Key features
- Minimal: roughly 100 lines of Python for the agent class, with no fancy dependencies.
- Performant: scores >74% on the SWE-bench verified benchmark and starts faster than Claude Code.
- Deployable: supports local environments, Docker/Podman, Singularity/Apptainer, Bubblewrap, Contree, and more.
- Compatible: supports all models via litellm, openrouter, portkey, and more; supports /completion and /response endpoints and interleaved thinking.
- No tools other than bash: does not use the tool-calling interface of language models; every action is executed with subprocess.run.
- Completely linear history: every step appends to the messages, making debugging and fine-tuning straightforward.
- Widely adopted: used by Meta, NVIDIA, Essential AI, IBM, Nebius, Anyscale, Princeton University, Stanford University, and others.
Use cases
- Solving GitHub issues directly from the command line.
- Quick local command-line tool for daily workflows.
- Baseline system for research, especially for fine-tuning or reinforcement learning without overfitting to a specific scaffold.
- Sandboxed evaluations using Docker, Podman, or other container runtimes.
Getting started
Three installation options are provided in the repository: Option 1 (anonymous virtual environment): bash pip install uv && uvx mini-swe-agent # or pip install pipx && pipx ensurepath && pipx run mini-swe-agent Option 2 (install CLI and Python bindings in current environment): bash pip install mini-swe-agent mini # run the CLI Option 3 (install from source): bash git clone https://github.com/SWE-agent/mini-swe-agent.git cd mini-swe-agent && pip install -e . mini # run the CLI
License and pricing
The project is open source under the MIT license. No pricing information is stated; it is free to use.
Based on the project's public README and repository metadata.