Website & Demo  |   Documentation  |   Discord  |   Preprint

👋 Overview

SWE-agent turns LMs (e.g. GPT-4) into software engineering agents that can fix bugs and issues in real GitHub repositories.

On SWE-bench, SWE-agent resolves 12.29% of issues, achieving the state-of-the-art performance on the full test set.

We accomplish our results by designing simple LM-centric commands and feedback formats to make it easier for the LM to browse the repository, view, edit and execute code files. We call this an 🤖 Agent-Computer Interface (ACI). Read more about it in our paper!

SWE-agent is built and maintained by researchers from Princeton University.

If you found this work helpful, please consider using the following citation:

@misc{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 Narasimhan and Ofir Press},
      year={2024},
}

✨ Why SWE-agent

I'm a dev who wants to use SWE-agent as a tool	I'm doing research on agents & benchmarks
✅ Easy installation, batteries included
✅ Fully documented
✅ Behavior can be modified by config files
✅ Graphical user interface in the browser	✅ First-class integration with SWE-bench
✅ Stable & tested

🚀 Get started!

All information is provided in our documentation:

• Installation
• Command line usage
• Using the web UI
• Benchmarking on SWE-bench

and many more topics.

💫 Contributions

• If you'd like to ask questions, learn about upcoming features, and participate in future development, join our Discord community!
• If you'd like to contribute to the codebase, we welcome issues and pull requests!
• If you'd like to see a post or tutorial about some topic, please let us know via an issue.

Contact person: John Yang and Carlos E. Jimenez (Email: {jy1682, carlosej}@princeton.edu).

🪪 License

MIT. Check LICENSE.

[](https://github.com/princeton-nlp/SWE-agent/actions/workflows/pytest.yaml) [](https://github.com/princeton-nlp/SWE-agent/actions/workflows/test_build_containers.yaml) [](https://github.com/princeton-nlp/SWE-agent/actions/workflows/build-docs.yaml) [](https://codecov.io/gh/princeton-nlp/SWE-agent) [](https://results.pre-commit.ci/latest/github/princeton-nlp/SWE-agent/main) [](https://github.com/princeton-nlp/SWE-agent/actions/workflows/check-links.yaml)