mini-swe-agent — The minimal AI software engineering agent

Princeton/Stanford 계열 SWE-bench / SWE-agent 팀이 만든, 100줄 수준의 단순한 AI 소프트웨어 엔지니어링 에이전트.

한 줄 요약

mini-swe-agent도구 스캐폴딩을 최소화하고, bash와 선형 메시지 히스토리만으로도 고성능 SWE 작업을 수행할 수 있는지를 보여주는 경량 기준선이다.

핵심 주장

README에서 강조하는 포인트는 다음과 같다.

  • 매우 단순함: 핵심 agent class가 대략 100줄 수준
  • bash only: 별도 tool-calling 인터페이스 없이 bash만 사용
  • 선형 히스토리: 매 단계가 메시지에 누적되어 디버깅과 튜닝이 쉬움
  • 독립 실행: 각 action을 subprocess.run으로 별도 수행
  • 배포 유연성: local, docker/podman, singularity/apptainer, bubblewrap, contree 지원
  • 모델 호환성: litellm, openrouter, portkey 등과 연결 가능
  • 벤치마크: SWE-bench verified에서 74%+를 주장

왜 중요한가

이 프로젝트는 “에이전트가 복잡해야만 잘 작동한다”는 가정을 흔든다. 오히려:

  • 모델 자체의 능력을 더 전면에 두고
  • scaffold를 줄이며
  • 실제 사용과 연구 둘 다 가능한 baseline을 만든다.

즉, moc-claude-code 같은 강한 상용 코딩 도구를 평가할 때도 비교축으로 쓸 만하다.

메모

  • README에는 v2 마이그레이션 가이드가 강조되어 있다.
  • mini-swe-agent는 “연구용 baseline”과 “실무용 hackable tool”을 동시에 노린다.
  • swe-benchswe-agent 계열을 읽을 때 기준선으로 두기 좋다.