mini-SWE-agent
100줄로 SWE-bench 74% 를 넘는 에이전트
pip install mini-swe-agentSWE-bench 와 SWE-agent 를 만든 프린스턴·스탠퍼드 팀이 다시 만든 최소 구현 에이전트입니다. 에이전트 클래스가 100줄 남짓인데 SWE-bench verified 에서 74% 를 넘습니다. 원조 SWE-agent 는 README 에서 스스로 이 프로젝트로 옮기라고 권하고 있습니다.
판단
이럴 때 씁니다
- 깃허브 이슈를 자동으로 고치는 작업을 벤치마크와 함께 재현하고 싶을 때
- 에이전트 루프 내부를 읽고 고쳐 가며 실험할 때
- 여러 모델을 갈아 끼우며 성능을 비교할 때
- 도커나 아파테이너 같은 격리 환경에서 에이전트를 돌려야 할 때
이럴 땐 쓰지 마세요
- 대화형 IDE 통합이나 다중 파일 편집 UI 가 필요할 때
- 도구와 인터페이스를 세밀하게 설계해야 하는 제품을 만들 때
- 벤치마크가 아니라 일상 개발 보조가 목적일 때는 일반 코딩 에이전트가 맞습니다
차별점
- 에이전트 클래스가 100줄 남짓인데 SWE-bench verified 에서 74% 를 넘습니다.
- SWE-bench 와 SWE-agent 를 만든 프린스턴·스탠퍼드 팀이 개발합니다.
- litellm 을 통해 사실상 모든 모델을 지원합니다.
- 로컬·도커·싱귤래리티·버블랩 등 실행 환경 선택지가 넓습니다.
워크플로
- 01pip install mini-swe-agent 로 설치합니다.
- 02litellm 이 지원하는 모델 중 하나를 고르고 키를 넣습니다.
- 03로컬·도커·아파테이너 중 실행 환경을 정합니다.
- 04이슈나 과제를 주고 에이전트 루프를 돌립니다.
- 05필요하면 100줄 남짓한 에이전트 클래스를 직접 고쳐 동작을 바꿉니다.
주요 명령
| 명령 | 설명 |
|---|---|
pip install mini-swe-agent | 패키지를 설치합니다. |
pip install uv && uvx mini-swe-agent | 설치 없이 일회성으로 실행합니다. |
pipx run mini-swe-agent | 격리된 환경에서 실행합니다. |
함정
설치 전에 확인하세요
- 현재 v2 이고 v1 과 구조가 다릅니다. 기존 설정이 있으면 마이그레이션 문서를 먼저 봐야 합니다.
- 원조 SWE-agent 저장소가 이 프로젝트로 옮기라고 권합니다. 이름이 비슷해 헷갈리기 쉽습니다.
- PyPI 의 sweagent 패키지는 0.0.1 자리표시자입니다. 원조를 쓰려면 소스에서 설치해야 합니다.
- 의도적으로 최소 구현이라 도구와 인터페이스가 얇습니다. 제품용 기능을 기대하면 안 됩니다.
비교
원조 SWE-agent 는 도구와 전용 인터페이스를 정교하게 설계하는 방향이었습니다. 모델이 좋아지면서 그 상당 부분이 필요 없어졌다는 것이 이 프로젝트의 전제입니다. 지금 새로 시작한다면 원조보다 이쪽이고, 원조 README 도 같은 권고를 하고 있습니다.
최근 변경
2026-07-23 v2.4.6 에서 파싱에 실패한 호출도 과금 대상이면 비용 한도에 계산하도록 고쳤습니다. 실패한 호출이 한도 밖으로 새던 문제입니다.