Agentless

不靠智能体,直接自动修 Bug 和写补丁

Agentless 是一个无需智能体(agent)即可自动解决软件开发问题的开源框架。它针对软件工程中的自动化问题修复和功能实现场景,采用分阶段流程:先定位问题相关代码,再生成补丁,最后验证修复。与传统依赖大模型调用工具链的智能体方案不同,Agentless 通过静态分析和提示工程直接驱动模型输出补丁,降低了复杂性和成本。核心能力包括:自动定位缺陷文件、生成候选补丁、基于测试反馈重排序,从而在 SWE-bench 等基准上达到与智能体方法相当的效果,但更简单、更透明。项目提供 Python 命令行接口,支持与 OpenAI 等模型集成,适合研究者和工程师快速复现或扩展。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 2114
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类开源模型
开发团队OpenAutoCoder
所属国家
官网地址
定价模式free
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agent,artificial-intelligence,llm,software-development
GitHub 星标★ 2114
30天Star增速
HF 下载量
上线时间2024-06-30 00:00:00
最近更新2026-09-22 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数4

使用教程

难度:进阶 约 15 分钟 部署方式:命令行工具 7 步

环境要求

  • 已安装 Git
  • 已安装 Conda(用于创建 Python 3.11 环境)
  • Python 3.11 环境
  • 可用的 OpenAI API Key(或兼容模型服务)

安装与启动步骤

  1. 1克隆项目仓库

    从 GitHub 拉取 Agentless 源码到本地,命令执行后当前目录会生成 Agentless 文件夹。

    git clone https://github.com/OpenAutoCoder/Agentless.git
    cd Agentless
  2. 2创建 Python 环境

    README 要求使用 conda 创建名为 agentless 的 Python 3.11 环境,版本不符可能装不上依赖。

    conda create -n agentless python=3.11
  3. 3激活环境

    激活刚创建的 agentless 环境,后续安装与运行都在该环境中进行。

    conda activate agentless
  4. 4安装依赖

    在项目根目录按 requirements.txt 安装全部 Python 依赖,耗时较长请保持网络畅通。

    pip install -r requirements.txt
  5. 5配置模块路径

    把当前项目根目录追加到 PYTHONPATH,保证项目内模块能被正确导入。

    export PYTHONPATH=$PYTHONPATH:$(pwd)
  6. 6配置模型密钥

    导出 OpenAI API Key 环境变量,把占位值替换成你自己的真实密钥。

    export OPENAI_API_KEY={key_here}
  7. 7开发者可选项

    仅参与贡献时需要:安装 pre-commit 钩子以统一代码风格,普通使用可跳过。

    pre-commit install

关键配置

配置项必填说明示例
OPENAI_API_KEY是调用 OpenAI 模型生成补丁所需的密钥sk-xxxxxxxxxxxxxxxx
PYTHONPATH是让项目内模块可被 Python 导入/your/path/Agentless

如何确认成功

conda activate agentless 能成功切换环境、pip install 无报错即安装完成;完整实验需按 README_swebench.md 运行。

常见问题

Q:必须使用 Conda 吗?

A:README 给出的步骤是 conda create -n agentless python=3.11,为保持与官方一致建议使用 Conda;若用其他方式也需保证 Python 3.11 并安装 requirements.txt。

Q:一定要用 OpenAI 的模型吗?

A:README 的 Setup 只给出 OPENAI_API_KEY 的配置方式;News 中提到已集成 Claude 3.5 Sonnet,如需换模型请参考仓库最新文档。

Q:如何复现论文里的 SWE-bench lite 实验?

A:README 明确指出完整复现需查看仓库中的 README_swebench.md,按其中的精确配置执行。

Q:为什么设置了 PYTHONPATH?

A:export PYTHONPATH=$PYTHONPATH:$(pwd) 把项目根目录加入模块搜索路径,避免运行时找不到内部模块报 ImportError。

注意事项

  • README 只提供了环境搭建说明,未给出具体运行命令,实际运行请参考 README_swebench.md。
  • API Key 属于敏感信息,不要写入代码或提交到版本库,建议仅在当前终端会话中 export。
  • 按官方数据,SWE-bench lite 上平均每个问题成本约 0.34 美元,跑实验前请留意用量与费用。
  • 如需参与贡献再执行 pre-commit install,普通使用者可省略该步。

核心亮点

  • 流程简单透明,无需管理复杂的智能体循环,易于理解和调试
  • 在 SWE-bench 上表现与智能体方法持平,但成本更低
  • 提供完整的分阶段流水线,可独立使用或集成到 CI

不足之处

  • 依赖静态定位,对跨文件或模糊问题可能定位不准
  • 文档/社区待观察

适用场景

  • 自动化修复 GitHub Issue 中的代码缺陷
  • 在 CI 中自动生成补丁并提交 PR
  • 用于研究软件工程自动化修复的基线对比

替代项目

AutoCodeRover、OpenHands、Aider

项目介绍

Agentless 是编程开发领域的开源项目,由 OpenAutoCoder 开发,2024 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(2,114)位列前 30%,在编程开发分类中处于中上游。

近 42 天,它的 GitHub 星标从 2,094 增加到 2,114,净增 20。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-22。MIT许可证,完全免费,可自行部署使用。

它主要面向的使用场景是:自动化修复GitHubIssue中的代码缺陷。同类可对比的替代方案包括 AutoCodeRover、OpenHands、Aider。

上一篇:llama.vim

下一篇:amazon-q-developer-cli

同类项目推荐

bolt.new 开源

想到啥说啥,网页应用当场生成直接能用

Prompt, run, edit, and deploy full-stack web applications. -- bolt.new -- Help Cente···

★ 16557 2026-08-09
fuzz4all 开源

用大模型自动生成测试输入,发现各种软件漏洞

️Fuzz4All: Universal Fuzzing with Large Language Models

★ 338 2026-08-09
superpowers-zh 开源

全套 AI 编程神技汉化好了,照着用就行。

AI 编程超能力 · 中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills···

★ 8188 2026-08-09
crystal 开源

多个 AI 同时写不同功能,互不干扰齐头并进。

(Crystal is now Nimbalyst) Run multiple Codex and Claude Code AI sessions in paralle···

★ 3121 2026-08-09