mini-swe-agent 1.16.0__py3-none-any.whl

mini_swe_agent-1.16.0.dist-info/METADATA

@@ -0,0 +1,314 @@
+Metadata-Version: 2.4
+Name: mini-swe-agent
+Version: 1.16.0
+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.16.0.dist-info/RECORD

@@ -0,0 +1,62 @@
+mini_swe_agent-1.16.0.dist-info/licenses/LICENSE.md,sha256=D3luWPkdHAe7LBsdD4vzqDAXw6Xewb3G-uczss0uh1s,1094
+minisweagent/__init__.py,sha256=UdcN4hUoziBEob35FnOM4pf5nSD9dGt_-bv_QTWRBKY,2016
+minisweagent/__main__.py,sha256=FIyAOiw--c3FQ2g240FOM1FdL0lk_PxSpixu0pQ7WFo,194
+minisweagent/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+minisweagent/agents/__init__.py,sha256=cpjJLzg1IGxLM-tZpoMJV9S33ye13XtdBO0x7DU_Lrk,48
+minisweagent/agents/default.py,sha256=M-cnJwLgAGwgFSUyKdf2nkE8xNr24ffcJHKuItLOoBg,5701
+minisweagent/agents/interactive.py,sha256=NBeNamRuqww9ZRhOg1q8xPO9ziUw2gpAVV6hCPbpBxU,7470
+minisweagent/agents/interactive_textual.py,sha256=yUDMkuvhhnZAP8LtiBWmt5J5WzfWBeR0zNlJbdbEGa0,18153
+minisweagent/config/README.md,sha256=ABd9anA4aRWtx7Oh37z36Wv6ARvcxD2w9lPUE24R2mY,435
+minisweagent/config/__init__.py,sha256=0KzHaaIqWgRy2zbwIzhrg6BJPDzOvYi3jb4eBNY4sAU,823
+minisweagent/config/default.yaml,sha256=iVNFs-FHrjc81RAiaTjGk5435G6V7OPjbXECu6RxJPU,5129
+minisweagent/config/github_issue.yaml,sha256=qbjj3vmdukxz36_EY7e64vhNn1g2-_NrdNx5xgMOUAI,4569
+minisweagent/config/mini.tcss,sha256=fmAP9cYAp2n7Ps2Dw3e-ZOGEF2E8JcwTgK1LDcis-x4,1141
+minisweagent/config/mini.yaml,sha256=-3c4eKeCysFAfKJX3whUuBI6wbQgt8vrlcTFp_pcdyY,5145
+minisweagent/config/mini_no_temp.yaml,sha256=g1Y5goNTYZlDcSuBgKWJUdMkoK09w_5vheASZg1yYYI,5190
+minisweagent/config/extra/__init__.py,sha256=e1MoAlDn_wc9HnXNoncf1P-B4DQ-iRf6n7Q_txjZGRI,52
+minisweagent/config/extra/swebench.yaml,sha256=opFzxJPeMYY6oIpB6oUViXiax3ei7UTOlP0Lz1LbFss,7750
+minisweagent/config/extra/swebench_roulette.yaml,sha256=8O7PvO8tPGJN-mYuBGhWUlAzsjMPnbf3_i6Sn5v7RQ4,7813
+minisweagent/config/extra/swebench_xml.yaml,sha256=dWXAqzXgw167hgiKqoqOryPHwAgDV2JbgoiDABdEznY,7827
+minisweagent/environments/__init__.py,sha256=x80Ulx0UK21GAwg5jSTkOFeiZ7CQsGBP8cI_5BhazAo,1266
+minisweagent/environments/docker.py,sha256=hsKOPGAP2kjgEwA_2HQz_nCrr25qmR4fB8u5Ob6UbzY,4370
+minisweagent/environments/local.py,sha256=sOM-8Hc-bmGW6NEMebKz47vFR2Nb0xqvm1Daj6A_mPY,1278
+minisweagent/environments/singularity.py,sha256=HSwRTWef7cMCgBiGAh5DIrxW8HkZ9C9ZGtwn0ktD_cw,3675
+minisweagent/environments/extra/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+minisweagent/environments/extra/bubblewrap.py,sha256=G12Dm63N30qByfLb1SKNsI4G4gLyKBfomnOIsPqRNZk,3662
+minisweagent/environments/extra/swerex_docker.py,sha256=WPYbohT_vqTHkde9cxpbV6chLXCpLl0PDAcgMbZsV0M,1707
+minisweagent/models/__init__.py,sha256=RGJgMPeF8W2Ix8_xwvHjjDCD9I6ygirz4v8Ps1KG6dI,4435
+minisweagent/models/anthropic.py,sha256=4p-LxQ_RYQUX1rBsffAj3T1bBb2uMRhA4IyKfDcMpgo,1517
+minisweagent/models/litellm_model.py,sha256=ph2j2gDwxl10p9NRUhldNJt-FAwYIyjfnNiaF8A0ThU,4280
+minisweagent/models/litellm_response_api_model.py,sha256=BJzDGE-rn9P_TVX60-8YJXS6SIgOTJAGgBszuHNKzEI,2916
+minisweagent/models/openrouter_model.py,sha256=dsVl8pnZ9M6nZ5DpLy69v1bizMR73mixXdVZVNzvknc,4712
+minisweagent/models/portkey_model.py,sha256=6HMOsmHd6Q6WdLUDa_1XFCrU0BaCUP5RqI3h6L8AxJQ,7223
+minisweagent/models/portkey_response_api_model.py,sha256=knIKR88u5YP-FqE27ZEopsuTSchzslq8CDjyxsMHtbU,2908
+minisweagent/models/requesty_model.py,sha256=Dqr0cLNSstj3VrzYhf-Sqsju8OvJrRPK2mctajgRnNs,3781
+minisweagent/models/test_models.py,sha256=ItCA6ddntzkYA7dzSuUEaLMV-AE8TBuXBFP8CzpiO3U,1351
+minisweagent/models/extra/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+minisweagent/models/extra/roulette.py,sha256=idteU0pGvmmipNr0s-42GAbVkmKE20hY2LTFxbkAgoI,2048
+minisweagent/models/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+minisweagent/models/utils/cache_control.py,sha256=zgi9e_72Y1pc0qNirW8_rMyi8RcLonGJNtfavqGX5_I,1917
+minisweagent/models/utils/key_per_thread.py,sha256=4YZXATIw-Fozi7M-1i-wyjIBf-GtQM71kkOHxSPkwrE,748
+minisweagent/models/utils/openai_utils.py,sha256=3OEOR65gFeVCTpcLJyMkzbFL_B-k8ftmcgvPK1EvqAw,1314
+minisweagent/run/__init__.py,sha256=WIoYgHVl7iZF2YncrfV3IttupG6P5KogroKHKECka3A,38
+minisweagent/run/github_issue.py,sha256=35mZoPLc4JV6XXJKRv55lnuKbXf5lDftd51N89-x9J0,3192
+minisweagent/run/hello_world.py,sha256=erLnEwNmPFLxq3-8zyv66Vy1kIqMqQf97vISX7LrQXg,959
+minisweagent/run/inspector.py,sha256=QnY3oYzm-yq3w9Jzs112Lco2Rg84vSocAWrQRVz_1lc,7127
+minisweagent/run/mini.py,sha256=N3ZvTQmKHNJ9bEaiz5YHjJT4Arg0WtjxGLBTtj8-T0E,4922
+minisweagent/run/mini_extra.py,sha256=ecA1PnTWElpO60G9RktvVLtUOf3bZ_ESmnSttS6izhQ,1465
+minisweagent/run/extra/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+minisweagent/run/extra/config.py,sha256=KDMwg6eQCxbwI6P1phosCwaLQhJQXB4ti65M_HoxU-g,3892
+minisweagent/run/extra/swebench.py,sha256=sO3LnjLXdU6Zbo409YhxVdizU8LaQcJUdcD8Tj6saMw,11741
+minisweagent/run/extra/swebench_single.py,sha256=KmoUkD6UQ1P0MY_73-OtYuQAsNPmOLlZIZSYKZGs5MQ,3699
+minisweagent/run/extra/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+minisweagent/run/extra/utils/batch_progress.py,sha256=xhJ7FmsaTBGz-yh8pzYl4yMoUGjn7GA24eYrP-nHj60,6804
+minisweagent/run/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+minisweagent/run/utils/save.py,sha256=bokvblZ1SaIvCXimkRQqgvERKmVM0jn8SF7UoHBeerQ,2546
+minisweagent/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+minisweagent/utils/log.py,sha256=ruDMNKMrVC9NPvCeHwO3QYz5jsVNUGQB2dRAEAPAWp8,996
+mini_swe_agent-1.16.0.dist-info/METADATA,sha256=wzWaGbiiRE2CaTxf3kxyfMscOMAJdAZ6I4x3NFWE2S4,14851
+mini_swe_agent-1.16.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mini_swe_agent-1.16.0.dist-info/entry_points.txt,sha256=d1_yRbTaGjs1UXHa6JQK0sKDGBIVGm8oeW0k2kfbJgQ,182
+mini_swe_agent-1.16.0.dist-info/top_level.txt,sha256=zKF4t8bFpV87fdVABZt2Da-vnb4Vkh_CxkwQx5YT4Ew,13
+mini_swe_agent-1.16.0.dist-info/RECORD,,

mini_swe_agent-1.16.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mini_swe_agent-1.16.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+mini = minisweagent.run.mini:app
+mini-e = minisweagent.run.mini_extra:main
+mini-extra = minisweagent.run.mini_extra:main
+mini-swe-agent = minisweagent.run.mini:app

mini_swe_agent-1.16.0.dist-info/licenses/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.16.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+minisweagent

minisweagent/__init__.py

@@ -0,0 +1,83 @@
+"""
+This file provides:
+
+- Path settings for global config file & relative directories
+- Version numbering
+- Protocols for the core components of mini-swe-agent.
+  By the magic of protocols & duck typing, you can pretty much ignore them,
+  unless you want the static type checking.
+"""
+
+__version__ = "1.16.0"
+
+import os
+from pathlib import Path
+from typing import Any, Protocol
+
+import dotenv
+from platformdirs import user_config_dir
+from rich.console import Console
+
+from minisweagent.utils.log import logger
+
+package_dir = Path(__file__).resolve().parent
+
+global_config_dir = Path(os.getenv("MSWEA_GLOBAL_CONFIG_DIR") or user_config_dir("mini-swe-agent"))
+global_config_dir.mkdir(parents=True, exist_ok=True)
+global_config_file = Path(global_config_dir) / ".env"
+
+if not os.getenv("MSWEA_SILENT_STARTUP"):
+    Console().print(
+        f"👋 This is [bold green]mini-swe-agent[/bold green] version [bold green]{__version__}[/bold green].\n"
+        f"Loading global config from [bold green]'{global_config_file}'[/bold green]"
+    )
+dotenv.load_dotenv(dotenv_path=global_config_file)
+
+
+# === Protocols ===
+# You can ignore them unless you want static type checking.
+
+
+class Model(Protocol):
+    """Protocol for language models."""
+
+    config: Any
+    cost: float
+    n_calls: int
+
+    def query(self, messages: list[dict[str, str]], **kwargs) -> dict: ...
+
+    def get_template_vars(self) -> dict[str, Any]: ...
+
+
+class Environment(Protocol):
+    """Protocol for execution environments."""
+
+    config: Any
+
+    def execute(self, command: str, cwd: str = "") -> dict[str, str]: ...
+
+    def get_template_vars(self) -> dict[str, Any]: ...
+
+
+class Agent(Protocol):
+    """Protocol for agents."""
+
+    model: Model
+    env: Environment
+    messages: list[dict[str, str]]
+    config: Any
+
+    def run(self, task: str, **kwargs) -> tuple[str, str]: ...
+
+
+__all__ = [
+    "Agent",
+    "Model",
+    "Environment",
+    "package_dir",
+    "__version__",
+    "global_config_file",
+    "global_config_dir",
+    "logger",
+]

minisweagent/__main__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+"""This is what happens when you do `python -m minisweagent` or `pipx run mini-swe-agent`."""
+
+from minisweagent.run.mini import app
+
+if __name__ == "__main__":
+    app()

minisweagent/agents/__init__.py

@@ -0,0 +1 @@
+"""Agent implementations for mini-SWE-agent."""

minisweagent/agents/default.py

@@ -0,0 +1,131 @@
+"""Basic agent class. See https://mini-swe-agent.com/latest/advanced/control_flow/ for visual explanation."""
+
+import re
+import subprocess
+from dataclasses import asdict, dataclass
+
+from jinja2 import StrictUndefined, Template
+
+from minisweagent import Environment, Model
+
+
+@dataclass
+class AgentConfig:
+    # The default settings are the bare minimum to run the agent. Take a look at the config files for improved settings.
+    system_template: str = "You are a helpful assistant that can do anything."
+    instance_template: str = (
+        "Your task: {{task}}. Please reply with a single shell command in triple backticks. "
+        "To finish, the first line of the output of the shell command must be 'COMPLETE_TASK_AND_SUBMIT_FINAL_OUTPUT'."
+    )
+    timeout_template: str = (
+        "The last command <command>{{action['action']}}</command> timed out and has been killed.\n"
+        "The output of the command was:\n <output>\n{{output}}\n</output>\n"
+        "Please try another command and make sure to avoid those requiring interactive input."
+    )
+    format_error_template: str = "Please always provide EXACTLY ONE action in triple backticks."
+    action_observation_template: str = "Observation: {{output}}"
+    action_regex: str = r"```bash\s*\n(.*?)\n```"
+    step_limit: int = 0
+    cost_limit: float = 3.0
+
+
+class NonTerminatingException(Exception):
+    """Raised for conditions that can be handled by the agent."""
+
+
+class FormatError(NonTerminatingException):
+    """Raised when the LM's output is not in the expected format."""
+
+
+class ExecutionTimeoutError(NonTerminatingException):
+    """Raised when the action execution timed out."""
+
+
+class TerminatingException(Exception):
+    """Raised for conditions that terminate the agent."""
+
+
+class Submitted(TerminatingException):
+    """Raised when the LM declares that the agent has finished its task."""
+
+
+class LimitsExceeded(TerminatingException):
+    """Raised when the agent has reached its cost or step limit."""
+
+
+class DefaultAgent:
+    def __init__(self, model: Model, env: Environment, *, config_class: type = AgentConfig, **kwargs):
+        self.config = config_class(**kwargs)
+        self.messages: list[dict] = []
+        self.model = model
+        self.env = env
+        self.extra_template_vars = {}
+
+    def render_template(self, template: str, **kwargs) -> str:
+        template_vars = asdict(self.config) | self.env.get_template_vars() | self.model.get_template_vars()
+        return Template(template, undefined=StrictUndefined).render(
+            **kwargs, **template_vars, **self.extra_template_vars
+        )
+
+    def add_message(self, role: str, content: str, **kwargs):
+        self.messages.append({"role": role, "content": content, **kwargs})
+
+    def run(self, task: str, **kwargs) -> tuple[str, str]:
+        """Run step() until agent is finished. Return exit status & message"""
+        self.extra_template_vars |= {"task": task, **kwargs}
+        self.messages = []
+        self.add_message("system", self.render_template(self.config.system_template))
+        self.add_message("user", self.render_template(self.config.instance_template))
+        while True:
+            try:
+                self.step()
+            except NonTerminatingException as e:
+                self.add_message("user", str(e))
+            except TerminatingException as e:
+                self.add_message("user", str(e))
+                return type(e).__name__, str(e)
+
+    def step(self) -> dict:
+        """Query the LM, execute the action, return the observation."""
+        return self.get_observation(self.query())
+
+    def query(self) -> dict:
+        """Query the model and return the response."""
+        if 0 < self.config.step_limit <= self.model.n_calls or 0 < self.config.cost_limit <= self.model.cost:
+            raise LimitsExceeded()
+        response = self.model.query(self.messages)
+        self.add_message("assistant", **response)
+        return response
+
+    def get_observation(self, response: dict) -> dict:
+        """Execute the action and return the observation."""
+        output = self.execute_action(self.parse_action(response))
+        observation = self.render_template(self.config.action_observation_template, output=output)
+        self.add_message("user", observation)
+        return output
+
+    def parse_action(self, response: dict) -> dict:
+        """Parse the action from the message. Returns the action."""
+        actions = re.findall(self.config.action_regex, response["content"], re.DOTALL)
+        if len(actions) == 1:
+            return {"action": actions[0].strip(), **response}
+        raise FormatError(self.render_template(self.config.format_error_template, actions=actions))
+
+    def execute_action(self, action: dict) -> dict:
+        try:
+            output = self.env.execute(action["action"])
+        except subprocess.TimeoutExpired as e:
+            output = e.output.decode("utf-8", errors="replace") if e.output else ""
+            raise ExecutionTimeoutError(
+                self.render_template(self.config.timeout_template, action=action, output=output)
+            )
+        except TimeoutError:
+            raise ExecutionTimeoutError(self.render_template(self.config.timeout_template, action=action, output=""))
+        self.has_finished(output)
+        return output
+
+    def has_finished(self, output: dict[str, str]):
+        """Raises Submitted exception with final output if the agent has finished its task."""
+        lines = output.get("output", "").lstrip().splitlines(keepends=True)
+        if lines and lines[0].strip() in ["MINI_SWE_AGENT_FINAL_OUTPUT", "COMPLETE_TASK_AND_SUBMIT_FINAL_OUTPUT"]:
+            raise Submitted("".join(lines[1:]))