SWE-agent/mini-swe-agent

这是什么？

核心功能

• 01智能体核心约 100 行 Python，没有沉重的依赖。
• 02只使用 bash 作为工具，不要求模型支持工具调用。
• 03每个动作通过 subprocess.run 独立执行，可借助 Docker、Podman、Apptainer 或 Bubblewrap 进行沙箱隔离。
• 04通过 LiteLLM、OpenRouter、Portkey 接入各类模型。
• 05提供命令行工具、Python 绑定、SWE-bench 批量推理和轨迹浏览器。

适用场景

• 在终端中用 AI 助手快速处理本地项目的编码任务。
• 把极简、易改造的智能体用作智能体或模型研究的基线。
• 用仅依赖 bash 的框架在 SWE-bench 上评测语言模型。
• 在容器沙箱中运行智能体，更安全地自动修改代码。

快速上手

1. 1

   使用 uv 在隔离环境中安装并试用命令行工具

   pip install uv && uvx mini-swe-agent
2. 2

   或者在当前环境中安装命令行工具和 Python 绑定

   pip install mini-swe-agent
3. 3

   运行命令行工具

   mini

使用前须知

• !使用模型需要 API 密钥或兼容的模型端点，README 中对此说明较少。
• !完整的 SWE-bench 式运行以及沙箱环境需要额外配置，例如 Docker、Podman 或 Apptainer。

标签

常见问题

mini-swe-agent 是什么？

一个极简的 AI 软件工程智能体，可解决 GitHub Issue 或在命令行中辅助工作，核心仅约 100 行 Python。 mini-swe-agent 是一个用于软件工程任务的小型 AI 智能体，既可以处理 GitHub Issue，也可以作为命令行助手使用。其智能体核心类约 100 行 Python 代码，不依赖繁重的框架。

mini-swe-agent 可以免费使用吗？用的什么许可证？

mini-swe-agent 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

mini-swe-agent 还在维护吗？

活跃维护中。mini-swe-agent 最近一次提交是在 2026年10月19日。

mini-swe-agent 适合用来做什么？

在终端中用 AI 助手快速处理本地项目的编码任务。 把极简、易改造的智能体用作智能体或模型研究的基线。 用仅依赖 bash 的框架在 SWE-bench 上评测语言模型。 在容器沙箱中运行智能体，更安全地自动修改代码。

mini-swe-agent 怎么安装和运行？

使用 uv 在隔离环境中安装并试用命令行工具: pip install uv && uvx mini-swe-agent 或者在当前环境中安装命令行工具和 Python 绑定: pip install mini-swe-agent 运行命令行工具: mini

在哪里获取 mini-swe-agent？

源代码和安装说明在 GitHub 上：https://github.com/SWE-agent/mini-swe-agent