mini-swe-agent 1.17.1__tar.gz

mini_swe_agent-1.17.1/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kilian A. Lieret and Carlos E. Jimenez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mini_swe_agent-1.17.1/PKG-INFO

@@ -0,0 +1,314 @@
+Metadata-Version: 2.4
+Name: mini-swe-agent
+Version: 1.17.1
+Summary: Nano SWE Agent - A simple AI software engineering agent
+Author-email: Kilian Lieret <kilian.lieret@posteo.de>, "Carlos E. Jimenez" <carlosej@princeton.edu>
+License: MIT License
+        
+        Copyright (c) 2025 Kilian A. Lieret and Carlos E. Jimenez
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Documentation, https://mini-swe-agent.com/latest/
+Project-URL: Repository, https://github.com/SWE-agent/mini-SWE-agent
+Project-URL: Bug Tracker, https://github.com/SWE-agent/mini-SWE-agent/issues
+Keywords: nlp,agents,code
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: pyyaml
+Requires-Dist: requests
+Requires-Dist: jinja2
+Requires-Dist: litellm>=1.75.5
+Requires-Dist: tenacity
+Requires-Dist: rich
+Requires-Dist: python-dotenv
+Requires-Dist: typer
+Requires-Dist: platformdirs
+Requires-Dist: textual
+Requires-Dist: prompt_toolkit
+Requires-Dist: openai!=1.100.0,!=1.100.1
+Provides-Extra: full
+Requires-Dist: mini-swe-agent[dev]; extra == "full"
+Requires-Dist: swe-rex>=1.4.0; extra == "full"
+Provides-Extra: dev
+Requires-Dist: datasets; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-xdist; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mkdocs-include-markdown-plugin; extra == "dev"
+Requires-Dist: mkdocstrings[python]>=0.18; extra == "dev"
+Requires-Dist: mike; extra == "dev"
+Requires-Dist: mkdocs-material; extra == "dev"
+Requires-Dist: mkdocs-glightbox; extra == "dev"
+Requires-Dist: mkdocs-redirects; extra == "dev"
+Requires-Dist: portkey-ai; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+<a href="https://mini-swe-agent.com/latest/"><img src="https://github.com/SWE-agent/mini-swe-agent/raw/main/docs/assets/mini-swe-agent-banner.svg" alt="mini-swe-agent banner" style="height: 7em"/></a>
+</div>
+
+# The 100 line AI agent that solves GitHub issues & more
+
+📣 [Gemini 3 Pro reaches 74% on SWE-bench verified with mini-swe-agent!](https://x.com/KLieret/status/1991164693839270372)<br/>
+📣 [New blogpost: Randomly switching between GPT-5 and Sonnet 4 boosts performance](https://www.swebench.com/SWE-bench/blog/2025/08/19/mini-roulette/)
+
+[![Docs](https://img.shields.io/badge/Docs-green?style=for-the-badge&logo=materialformkdocs&logoColor=white)](https://mini-swe-agent.com/latest/)
+[![Slack](https://img.shields.io/badge/Slack-4A154B?style=for-the-badge&logo=slack&logoColor=white)](https://join.slack.com/t/swe-bench/shared_invite/zt-36pj9bu5s-o3_yXPZbaH2wVnxnss1EkQ)
+[![PyPI - Version](https://img.shields.io/pypi/v/mini-swe-agent?style=for-the-badge&logo=python&logoColor=white&labelColor=black&color=deeppink)](https://pypi.org/project/mini-swe-agent/)
+
+In 2024, [SWE-bench](https://github.com/swe-bench/SWE-bench) & [SWE-agent](https://github.com/swe-agent/swe-agent) helped kickstart the coding agent revolution.
+
+We now ask: **What if SWE-agent was 100x smaller, and still worked nearly as well?**
+
+`mini` is for
+
+- **Researchers** who want to **[benchmark](https://swe-bench.com), [fine-tune](https://swesmith.com/) or RL** without assumptions, bloat, or surprises
+- **Developers** who like their tools like their scripts: **short, sharp, and readable**
+- **Engineers** who want something **trivial to sandbox & to deploy anywhere**
+
+Here's some details:
+
+- **Minimal**: Just [100 lines of python](https://github.com/SWE-agent/mini-swe-agent/blob/main/src/minisweagent/agents/default.py) (+100 total for [env](https://github.com/SWE-agent/mini-swe-agent/blob/main/src/minisweagent/environments/local.py),
+[model](https://github.com/SWE-agent/mini-swe-agent/blob/main/src/minisweagent/models/litellm_model.py), [script](https://github.com/SWE-agent/mini-swe-agent/blob/main/src/minisweagent/run/hello_world.py)) — no fancy dependencies!
+- **Powerful:** Resolves >74% of GitHub issues in the [SWE-bench verified benchmark](https://www.swebench.com/) ([leaderboard](https://swe-bench.com/)).
+- **Convenient:** Comes with UIs that turn this into your daily dev swiss army knife!
+- **Deployable:** In addition to local envs, you can use **docker**, **podman**, **singularity**, **apptainer**, and more
+- **Tested:** [![Codecov](https://img.shields.io/codecov/c/github/swe-agent/mini-swe-agent?style=flat-square)](https://codecov.io/gh/SWE-agent/mini-swe-agent)
+- **Cutting edge:** Built by the Princeton & Stanford team behind [SWE-bench](https://swebench.com) and [SWE-agent](https://swe-agent.com).
+
+<details>
+
+<summary>More motivation (for research)</summary>
+
+[SWE-agent](https://swe-agent.com/latest/) jump-started the development of AI agents in 2024. Back then, we placed a lot of emphasis on tools and special interfaces for the agent.
+However, one year later, as LMs have become more capable, a lot of this is not needed at all to build a useful agent!
+In fact, mini-SWE-agent
+
+- **Does not have any tools other than bash** — it doesn't even use the tool-calling interface of the LMs.
+  This means that you can run it with literally any model. When running in sandboxed environments you also don't need to take care
+  of installing a single package — all it needs is bash.
+- **Has a completely linear history** — every step of the agent just appends to the messages and that's it.
+  So there's no difference between the trajectory and the messages that you pass on to the LM.
+  Great for debugging & fine-tuning.
+- **Executes actions with `subprocess.run`** — every action is completely independent (as opposed to keeping a stateful shell session running).
+  This makes it trivial to execute the actions in sandboxes (literally just switch out `subprocess.run` with `docker exec`) and to
+  scale up effortlessly. Seriously, this is [a big deal](https://mini-swe-agent.com/latest/faq/#why-no-shell-session), trust me.
+
+This makes it perfect as a baseline system and for a system that puts the language model (rather than
+the agent scaffold) in the middle of our attention.
+You can see the result on the [SWE-bench (bash only)](https://www.swebench.com/) leaderboard, that evaluates the performance of different LMs with `mini`.
+
+</details>
+
+<details>
+<summary>More motivation (as a tool)</summary>
+
+Some agents are overfitted research artifacts. Others are UI-heavy frontend monsters.
+
+`mini` wants to be a hackable tool, not a black box.
+
+- **Simple** enough to understand at a glance
+- **Convenient** enough to use in daily workflows
+- **Flexible** to extend
+
+Unlike other agents (including our own [swe-agent](https://swe-agent.com/latest/)), it is radically simpler, because it:
+
+- **Does not have any tools other than bash** — it doesn't even use the tool-calling interface of the LMs.
+  Instead of implementing custom tools for every specific thing the agent might want to do, the focus is fully on the LM utilizing the shell to its full potential.
+  Want it to do something specific like opening a PR?
+  Just tell the LM to figure it out rather than spending time to implement it in the agent.
+- **Executes actions with `subprocess.run`** — every action is completely independent (as opposed to keeping a stateful shell session running).
+  This is [a big deal](https://mini-swe-agent.com/latest/faq/#why-no-shell-session) for the stability of the agent, trust me.
+- **Has a completely linear history** — every step of the agent just appends to the messages that are passed to the LM in the next step and that's it.
+  This is great for debugging and understanding what the LM is prompted with.
+
+</details>
+
+<details>
+<summary>Should I use SWE-agent or mini-SWE-agent?</summary>
+
+You should use `mini-swe-agent` if
+
+- You want a quick command line tool that works locally
+- You want an agent with a very simple control flow
+- You want even faster, simpler & more stable sandboxing & benchmark evaluations
+- You are doing FT or RL and don't want to overfit to a specific agent scaffold
+
+You should use `swe-agent` if
+
+- You need specific tools or want to experiment with different tools
+- You want to experiment with different history processors
+- You want very powerful yaml configuration without touching code
+
+What you get with both
+
+- Excellent performance on SWE-Bench
+- A trajectory browser
+
+</details>
+
+<table>
+<tr>
+<td width="50%">
+<a href="https://mini-swe-agent.com/latest/usage/mini/"><strong>Simple UI</strong></a> (<code>mini</code>)
+</td>
+<td>
+<a href="https://mini-swe-agent.com/latest/usage/mini_v/"><strong>Visual UI</strong></a> (<code>mini -v</code>)
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+  ![mini](https://github.com/SWE-agent/swe-agent-media/blob/main/media/mini/gif/mini.gif?raw=true)
+
+</td>
+<td>
+
+  ![miniv](https://github.com/SWE-agent/swe-agent-media/blob/main/media/mini/gif/mini2.gif?raw=true)
+
+</td>
+</tr>
+<tr>
+  <td>
+    <a href="https://mini-swe-agent.com/latest/usage/swebench/"><strong>Batch inference</strong></a>
+  </td>
+  <td>
+    <a href="https://mini-swe-agent.com/latest/usage/inspector/"><strong>Trajectory browser</strong></a>
+  </td>
+<tr>
+<tr>
+
+<td>
+
+![swebench](https://github.com/SWE-agent/swe-agent-media/blob/main/media/mini/gif/swebench.gif?raw=true)
+
+</td>
+
+<td>
+
+![inspector](https://github.com/SWE-agent/swe-agent-media/blob/main/media/mini/gif/inspector.gif?raw=true)
+
+</td>
+
+</tr>
+<td>
+<a href="https://mini-swe-agent.com/latest/advanced/cookbook/"><strong>Python bindings</strong></a>
+</td>
+<td>
+<a href="https://mini-swe-agent.com"><strong>More in the docs</strong></a>
+</td>
+</tr>
+<tr>
+<td>
+
+```python
+agent = DefaultAgent(
+    LitellmModel(model_name=...),
+    LocalEnvironment(),
+)
+agent.run("Write a sudoku game")
+```
+</td>
+<td>
+
+* [Quick start](https://mini-swe-agent.com/latest/quickstart/)
+* [`mini`](https://mini-swe-agent.com/latest/usage/mini/)
+* [FAQ](https://mini-swe-agent.com/latest/faq/)
+* [Global configuration](https://mini-swe-agent.com/latest/advanced/global_configuration/)
+* [Yaml configuration files](https://mini-swe-agent.com/latest/advanced/yaml_configuration/)
+* [Power up](https://mini-swe-agent.com/latest/advanced/cookbook/)
+
+</td>
+</tr>
+</table>
+
+## Let's get started!
+
+**Option 1:** If you just want to try out the CLI (package installed in anonymous virtual environment)
+
+```bash
+pip install uv && uvx mini-swe-agent [-v]
+# or
+pip install pipx && pipx ensurepath && pipx run mini-swe-agent [-v]
+```
+
+**Option 2:** Install CLI & python bindings in current environment
+
+```bash
+pip install mini-swe-agent
+mini -v  # run the CLI
+```
+
+**Option 3:** Install from source (developer setup)
+
+```bash
+git clone https://github.com/SWE-agent/mini-swe-agent.git
+cd mini-swe-agent && pip install -e .
+mini [-v]  # run the CLI
+```
+
+Read more in our [documentation](https://mini-swe-agent.com/latest/):
+
+* [Quick start guide](https://mini-swe-agent.com/latest/quickstart/)
+* More on [`mini`](https://mini-swe-agent.com/latest/usage/mini/) and [`mini -v`](https://mini-swe-agent.com/latest/usage/mini_v/)
+* [Global configuration](https://mini-swe-agent.com/latest/advanced/global_configuration/)
+* [Yaml configuration files](https://mini-swe-agent.com/latest/advanced/yaml_configuration/)
+* [Power up with the cookbook](https://mini-swe-agent.com/latest/advanced/cookbook/)
+* [FAQ](https://mini-swe-agent.com/latest/faq/)
+* [Contribute!](https://mini-swe-agent.com/latest/contributing/)
+
+## Attribution
+
+If you found this work helpful, please consider citing the [SWE-agent paper](https://arxiv.org/abs/2405.15793) in your work:
+
+```bibtex
+@inproceedings{yang2024sweagent,
+  title={{SWE}-agent: Agent-Computer Interfaces Enable Automated Software Engineering},
+  author={John Yang and Carlos E Jimenez and Alexander Wettig and Kilian Lieret and Shunyu Yao and Karthik R Narasimhan and Ofir Press},
+  booktitle={The Thirty-eighth Annual Conference on Neural Information Processing Systems},
+  year={2024},
+  url={https://arxiv.org/abs/2405.15793}
+}
+```
+
+Our other projects:
+
+<div align="center">
+  <a href="https://github.com/SWE-agent/SWE-agent"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/sweagent_logo_text_below.svg" alt="SWE-agent" height="120px"></a>
+   &nbsp;&nbsp;
+  <a href="https://github.com/SWE-agent/SWE-ReX"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/swerex_logo_text_below.svg" alt="SWE-ReX" height="120px"></a>
+   &nbsp;&nbsp;
+  <a href="https://github.com/SWE-bench/SWE-bench"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/swebench_logo_text_below.svg" alt="SWE-bench" height="120px"></a>
+  &nbsp;&nbsp;
+  <a href="https://github.com/SWE-bench/SWE-smith"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/swesmith_logo_text_below.svg" alt="SWE-smith" height="120px"></a>
+  &nbsp;&nbsp;
+  <a href="https://github.com/codeclash-ai/codeclash"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/codeclash_logo_text_below.svg" alt="CodeClash" height="120px"></a>
+  &nbsp;&nbsp;
+  <a href="https://github.com/SWE-bench/sb-cli"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/sbcli_logo_text_below.svg" alt="sb-cli" height="120px"></a>
+</div>

mini_swe_agent-1.17.1/README.md

@@ -0,0 +1,243 @@
+<div align="center">
+<a href="https://mini-swe-agent.com/latest/"><img src="https://github.com/SWE-agent/mini-swe-agent/raw/main/docs/assets/mini-swe-agent-banner.svg" alt="mini-swe-agent banner" style="height: 7em"/></a>
+</div>
+
+# The 100 line AI agent that solves GitHub issues & more
+
+📣 [Gemini 3 Pro reaches 74% on SWE-bench verified with mini-swe-agent!](https://x.com/KLieret/status/1991164693839270372)<br/>
+📣 [New blogpost: Randomly switching between GPT-5 and Sonnet 4 boosts performance](https://www.swebench.com/SWE-bench/blog/2025/08/19/mini-roulette/)
+
+[![Docs](https://img.shields.io/badge/Docs-green?style=for-the-badge&logo=materialformkdocs&logoColor=white)](https://mini-swe-agent.com/latest/)
+[![Slack](https://img.shields.io/badge/Slack-4A154B?style=for-the-badge&logo=slack&logoColor=white)](https://join.slack.com/t/swe-bench/shared_invite/zt-36pj9bu5s-o3_yXPZbaH2wVnxnss1EkQ)
+[![PyPI - Version](https://img.shields.io/pypi/v/mini-swe-agent?style=for-the-badge&logo=python&logoColor=white&labelColor=black&color=deeppink)](https://pypi.org/project/mini-swe-agent/)
+
+In 2024, [SWE-bench](https://github.com/swe-bench/SWE-bench) & [SWE-agent](https://github.com/swe-agent/swe-agent) helped kickstart the coding agent revolution.
+
+We now ask: **What if SWE-agent was 100x smaller, and still worked nearly as well?**
+
+`mini` is for
+
+- **Researchers** who want to **[benchmark](https://swe-bench.com), [fine-tune](https://swesmith.com/) or RL** without assumptions, bloat, or surprises
+- **Developers** who like their tools like their scripts: **short, sharp, and readable**
+- **Engineers** who want something **trivial to sandbox & to deploy anywhere**
+
+Here's some details:
+
+- **Minimal**: Just [100 lines of python](https://github.com/SWE-agent/mini-swe-agent/blob/main/src/minisweagent/agents/default.py) (+100 total for [env](https://github.com/SWE-agent/mini-swe-agent/blob/main/src/minisweagent/environments/local.py),
+[model](https://github.com/SWE-agent/mini-swe-agent/blob/main/src/minisweagent/models/litellm_model.py), [script](https://github.com/SWE-agent/mini-swe-agent/blob/main/src/minisweagent/run/hello_world.py)) — no fancy dependencies!
+- **Powerful:** Resolves >74% of GitHub issues in the [SWE-bench verified benchmark](https://www.swebench.com/) ([leaderboard](https://swe-bench.com/)).
+- **Convenient:** Comes with UIs that turn this into your daily dev swiss army knife!
+- **Deployable:** In addition to local envs, you can use **docker**, **podman**, **singularity**, **apptainer**, and more
+- **Tested:** [![Codecov](https://img.shields.io/codecov/c/github/swe-agent/mini-swe-agent?style=flat-square)](https://codecov.io/gh/SWE-agent/mini-swe-agent)
+- **Cutting edge:** Built by the Princeton & Stanford team behind [SWE-bench](https://swebench.com) and [SWE-agent](https://swe-agent.com).
+
+<details>
+
+<summary>More motivation (for research)</summary>
+
+[SWE-agent](https://swe-agent.com/latest/) jump-started the development of AI agents in 2024. Back then, we placed a lot of emphasis on tools and special interfaces for the agent.
+However, one year later, as LMs have become more capable, a lot of this is not needed at all to build a useful agent!
+In fact, mini-SWE-agent
+
+- **Does not have any tools other than bash** — it doesn't even use the tool-calling interface of the LMs.
+  This means that you can run it with literally any model. When running in sandboxed environments you also don't need to take care
+  of installing a single package — all it needs is bash.
+- **Has a completely linear history** — every step of the agent just appends to the messages and that's it.
+  So there's no difference between the trajectory and the messages that you pass on to the LM.
+  Great for debugging & fine-tuning.
+- **Executes actions with `subprocess.run`** — every action is completely independent (as opposed to keeping a stateful shell session running).
+  This makes it trivial to execute the actions in sandboxes (literally just switch out `subprocess.run` with `docker exec`) and to
+  scale up effortlessly. Seriously, this is [a big deal](https://mini-swe-agent.com/latest/faq/#why-no-shell-session), trust me.
+
+This makes it perfect as a baseline system and for a system that puts the language model (rather than
+the agent scaffold) in the middle of our attention.
+You can see the result on the [SWE-bench (bash only)](https://www.swebench.com/) leaderboard, that evaluates the performance of different LMs with `mini`.
+
+</details>
+
+<details>
+<summary>More motivation (as a tool)</summary>
+
+Some agents are overfitted research artifacts. Others are UI-heavy frontend monsters.
+
+`mini` wants to be a hackable tool, not a black box.
+
+- **Simple** enough to understand at a glance
+- **Convenient** enough to use in daily workflows
+- **Flexible** to extend
+
+Unlike other agents (including our own [swe-agent](https://swe-agent.com/latest/)), it is radically simpler, because it:
+
+- **Does not have any tools other than bash** — it doesn't even use the tool-calling interface of the LMs.
+  Instead of implementing custom tools for every specific thing the agent might want to do, the focus is fully on the LM utilizing the shell to its full potential.
+  Want it to do something specific like opening a PR?
+  Just tell the LM to figure it out rather than spending time to implement it in the agent.
+- **Executes actions with `subprocess.run`** — every action is completely independent (as opposed to keeping a stateful shell session running).
+  This is [a big deal](https://mini-swe-agent.com/latest/faq/#why-no-shell-session) for the stability of the agent, trust me.
+- **Has a completely linear history** — every step of the agent just appends to the messages that are passed to the LM in the next step and that's it.
+  This is great for debugging and understanding what the LM is prompted with.
+
+</details>
+
+<details>
+<summary>Should I use SWE-agent or mini-SWE-agent?</summary>
+
+You should use `mini-swe-agent` if
+
+- You want a quick command line tool that works locally
+- You want an agent with a very simple control flow
+- You want even faster, simpler & more stable sandboxing & benchmark evaluations
+- You are doing FT or RL and don't want to overfit to a specific agent scaffold
+
+You should use `swe-agent` if
+
+- You need specific tools or want to experiment with different tools
+- You want to experiment with different history processors
+- You want very powerful yaml configuration without touching code
+
+What you get with both
+
+- Excellent performance on SWE-Bench
+- A trajectory browser
+
+</details>
+
+<table>
+<tr>
+<td width="50%">
+<a href="https://mini-swe-agent.com/latest/usage/mini/"><strong>Simple UI</strong></a> (<code>mini</code>)
+</td>
+<td>
+<a href="https://mini-swe-agent.com/latest/usage/mini_v/"><strong>Visual UI</strong></a> (<code>mini -v</code>)
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+  ![mini](https://github.com/SWE-agent/swe-agent-media/blob/main/media/mini/gif/mini.gif?raw=true)
+
+</td>
+<td>
+
+  ![miniv](https://github.com/SWE-agent/swe-agent-media/blob/main/media/mini/gif/mini2.gif?raw=true)
+
+</td>
+</tr>
+<tr>
+  <td>
+    <a href="https://mini-swe-agent.com/latest/usage/swebench/"><strong>Batch inference</strong></a>
+  </td>
+  <td>
+    <a href="https://mini-swe-agent.com/latest/usage/inspector/"><strong>Trajectory browser</strong></a>
+  </td>
+<tr>
+<tr>
+
+<td>
+
+![swebench](https://github.com/SWE-agent/swe-agent-media/blob/main/media/mini/gif/swebench.gif?raw=true)
+
+</td>
+
+<td>
+
+![inspector](https://github.com/SWE-agent/swe-agent-media/blob/main/media/mini/gif/inspector.gif?raw=true)
+
+</td>
+
+</tr>
+<td>
+<a href="https://mini-swe-agent.com/latest/advanced/cookbook/"><strong>Python bindings</strong></a>
+</td>
+<td>
+<a href="https://mini-swe-agent.com"><strong>More in the docs</strong></a>
+</td>
+</tr>
+<tr>
+<td>
+
+```python
+agent = DefaultAgent(
+    LitellmModel(model_name=...),
+    LocalEnvironment(),
+)
+agent.run("Write a sudoku game")
+```
+</td>
+<td>
+
+* [Quick start](https://mini-swe-agent.com/latest/quickstart/)
+* [`mini`](https://mini-swe-agent.com/latest/usage/mini/)
+* [FAQ](https://mini-swe-agent.com/latest/faq/)
+* [Global configuration](https://mini-swe-agent.com/latest/advanced/global_configuration/)
+* [Yaml configuration files](https://mini-swe-agent.com/latest/advanced/yaml_configuration/)
+* [Power up](https://mini-swe-agent.com/latest/advanced/cookbook/)
+
+</td>
+</tr>
+</table>
+
+## Let's get started!
+
+**Option 1:** If you just want to try out the CLI (package installed in anonymous virtual environment)
+
+```bash
+pip install uv && uvx mini-swe-agent [-v]
+# or
+pip install pipx && pipx ensurepath && pipx run mini-swe-agent [-v]
+```
+
+**Option 2:** Install CLI & python bindings in current environment
+
+```bash
+pip install mini-swe-agent
+mini -v  # run the CLI
+```
+
+**Option 3:** Install from source (developer setup)
+
+```bash
+git clone https://github.com/SWE-agent/mini-swe-agent.git
+cd mini-swe-agent && pip install -e .
+mini [-v]  # run the CLI
+```
+
+Read more in our [documentation](https://mini-swe-agent.com/latest/):
+
+* [Quick start guide](https://mini-swe-agent.com/latest/quickstart/)
+* More on [`mini`](https://mini-swe-agent.com/latest/usage/mini/) and [`mini -v`](https://mini-swe-agent.com/latest/usage/mini_v/)
+* [Global configuration](https://mini-swe-agent.com/latest/advanced/global_configuration/)
+* [Yaml configuration files](https://mini-swe-agent.com/latest/advanced/yaml_configuration/)
+* [Power up with the cookbook](https://mini-swe-agent.com/latest/advanced/cookbook/)
+* [FAQ](https://mini-swe-agent.com/latest/faq/)
+* [Contribute!](https://mini-swe-agent.com/latest/contributing/)
+
+## Attribution
+
+If you found this work helpful, please consider citing the [SWE-agent paper](https://arxiv.org/abs/2405.15793) in your work:
+
+```bibtex
+@inproceedings{yang2024sweagent,
+  title={{SWE}-agent: Agent-Computer Interfaces Enable Automated Software Engineering},
+  author={John Yang and Carlos E Jimenez and Alexander Wettig and Kilian Lieret and Shunyu Yao and Karthik R Narasimhan and Ofir Press},
+  booktitle={The Thirty-eighth Annual Conference on Neural Information Processing Systems},
+  year={2024},
+  url={https://arxiv.org/abs/2405.15793}
+}
+```
+
+Our other projects:
+
+<div align="center">
+  <a href="https://github.com/SWE-agent/SWE-agent"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/sweagent_logo_text_below.svg" alt="SWE-agent" height="120px"></a>
+   &nbsp;&nbsp;
+  <a href="https://github.com/SWE-agent/SWE-ReX"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/swerex_logo_text_below.svg" alt="SWE-ReX" height="120px"></a>
+   &nbsp;&nbsp;
+  <a href="https://github.com/SWE-bench/SWE-bench"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/swebench_logo_text_below.svg" alt="SWE-bench" height="120px"></a>
+  &nbsp;&nbsp;
+  <a href="https://github.com/SWE-bench/SWE-smith"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/swesmith_logo_text_below.svg" alt="SWE-smith" height="120px"></a>
+  &nbsp;&nbsp;
+  <a href="https://github.com/codeclash-ai/codeclash"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/codeclash_logo_text_below.svg" alt="CodeClash" height="120px"></a>
+  &nbsp;&nbsp;
+  <a href="https://github.com/SWE-bench/sb-cli"><img src="https://raw.githubusercontent.com/SWE-agent/swe-agent-media/refs/heads/main/media/logos_banners/sbcli_logo_text_below.svg" alt="sb-cli" height="120px"></a>
+</div>