mini-swe-agent의 개요
mini-swe-agent는 SWE-bench와 SWE-agent를 만든 Princeton과 Stanford 팀이 일부러 아주 작게 만든 코딩 에이전트입니다. 에이전트 클래스는 약 100줄의 Python이고, 도구는 bash 하나뿐이며, 모든 동작이 새 서브프로세스로 실행됩니다. 그래서 어떤 모델과도 동작하고, 호출 하나만 바꾸면 Docker, Podman, Singularity, bubblewrap, Modal 샌드박스에 들어갑니다.
팀은 이제 유지보수 전용 모드인 SWE-agent보다 이것을 권장합니다. 현재 버전 2이며(v1 설정에는 마이그레이션 가이드가 필요합니다), 최신 릴리스는 2026년 7월의 v2.4.6이고, README는 사용자로 Meta, NVIDIA, IBM, Anyscale을 꼽습니다. 프로젝트는 SWE-bench Verified에서 74%가 넘는 점수를 보고합니다.
mini-swe-agent, 쓸 만한 가치가 있습니까?
mini-swe-agent는 코딩 에이전트를 위한 가장 깔끔한 기준 하네스이고, 실무 도우미로는 부족한 대체재입니다. GitHub 스타는 약 8,800개이며, 2026년 7월 v2.4.6을 냈고 10월 19일까지도 커밋이 있었습니다. bash 외에 도구가 없어 모델의 도구 호출 인터페이스조차 필요하지 않으므로, 셸 명령을 쓸 수 있는 모델이면 같은 조건에서 비교할 수 있습니다.
연구자들이 이것을 쓰는 이유가 그 중립성입니다. SWE-bench bash-only 순위표는 모든 모델을 이것으로 돌리고, Ramp의 SWE-Bench도 이것 위에 만들어졌으며, 2026년 DeepSWE 논문은 작은 표본에서 여러 업체의 자체 하네스와 같거나 더 나은 결과를 냈다고 밝혔습니다. 다만 저자들은 차이가 오차 범위 안이었다고 덧붙입니다. 기록이 선형이라 궤적이 곧 모델이 본 그대로이므로, 실행을 디버깅하기 쉽고 파인튜닝이나 RL 데이터로 쓰기에도 편합니다.
기본값에는 주의가 필요합니다. 대화형 mini 명령은 샌드박스가 아니라 로컬 셸에서 실행됩니다. 확인 모드로 시작해 동작마다 묻지만, -y 플래그를 주면 yolo 모드로 바뀌고 허용 목록의 명령은 확인을 건너뜁니다. SWE-bench 실행기는 기본적으로 x86 Linux 이미지로 Docker를 쓰고, 작업마다 모델 비용 $3와 250단계로 제한하며, 환경 변수로 전체 비용 한도를 걸 수 있습니다.
일상 업무에서는 미니멀리즘이 발목을 잡습니다. MCP도, IDE 연동도, 지속되는 셸도 없어서 cd나 export한 변수가 다음 단계까지 남지 않습니다. SWE-agent는 사용자 정의 도구 인터페이스를 실험하거나 예전 EnIGMA 보안 결과를 재현할 때만 더 나은 도구로 남아 있습니다. 거의 아무것도 더하지 않는 하네스는 실험의 대조군으로는 알맞지만, OpenHands나 OpenCode 사용자라면 바로 그 점이 한 시간도 안 돼 아쉬울 것입니다.
제 역할을 하는 곳
SWE-bench Verified에서 프런티어 모델 세 개를 비교하는 ML 연구자
스캐폴드가 변수가 되지 않는 점수 얻기
Docker가 있는 x86 Linux 장비에서 mini-extra swebench --subset verified --workers 4를 실행하고, 보통 20분 안에 결과를 돌려주는 sb-cli로 채점합니다. 작업당 기본 한도 $3이면 500개 작업 세트는 모델당 API 요금이 최대 $1,500이고, 실제 실행은 대개 한도보다 적게 듭니다.
파인튜닝이나 RL용 에이전트 궤적을 만드는 사후 학습팀
깔끔하고 재생 가능한 에이전트 실행을 대규모로 수집하기
각 단계는 메시지 목록에 덧붙기만 하므로 저장된 궤적이 재구성 없이 그대로 학습 예제가 됩니다. Singularity나 Apptainer 환경으로 Docker 없이 HPC 클러스터에서 돌릴 수 있습니다. 소프트웨어는 MIT로 무료이고, 비용은 모델 토큰과 연산입니다.
사내 에이전트의 표준 모델 제공사를 고르는 엔지니어링 매니저
계약 전에 팀의 실제 버그 백로그로 모델 비교하기
Python 바인딩을 실제 이슈 표본에 연결하고 각 모델을 같은 100줄 루프로 돌리면, 차이는 업체 하네스가 아니라 모델을 반영합니다. 비용은 API 토큰뿐이고 유료 등급은 없습니다.
도입 전 확인할 점
- 설정
- Python 3.10 이상에서 pip install mini-swe-agent를 하고 MSWEA_MODEL_NAME과 API 키를 설정한 뒤 mini를 실행합니다. 첫 작업은 몇 분이면 됩니다. 배치 평가에는 x86 Linux의 Docker가 필요합니다.
- 연동
- /completion과 /response 엔드포인트를 포함해 LiteLLM, OpenRouter, Portkey를 통한 모델. 로컬, Docker, Podman, Singularity/Apptainer, bubblewrap, contree, Modal 환경. Python 바인딩과 궤적 브라우저.
- 데이터와 개인정보
- 프로젝트는 호스팅 서비스를 운영하지 않으며, 프롬프트와 저장소 내용은 설정한 모델 제공사로 갑니다. 로컬 모드에서는 모델의 명령이 사용자의 기기에서 실행되며 확인 모드만이 이를 막습니다. 문서에는 텔레메트리 언급이 없고 GitHub 코드 검색에서도 텔레메트리 코드가 나오지 않습니다. MIT 라이선스이며 저장소에 공개된 보안 권고는 없습니다.
- 대규모 사용 시 비용
- 무료이며 모델 사용료만 냅니다. 기본 설정은 실행마다 $3로 제한하고, MSWEA_GLOBAL_COST_LIMIT과 MSWEA_GLOBAL_CALL_LIMIT으로 배치 전체의 상한을 정합니다.
- 제한
- 명령마다 새 서브셸에서 실행되므로 디렉터리와 환경 변경이 유지되지 않음. MCP나 IDE 연결 없음. 열린 이슈와 풀 리퀘스트 약 112개. SWE-bench 이미지는 x86 전용.
좋은 점
- 한 번에 읽을 수 있는 약 100줄의 에이전트 루프
- bash 전용 설계로 도구 호출 없이 어떤 모델과도 동작
- 배치 실행용 작업별, 전체 비용 한도
- SWE-bench bash-only 순위표의 하네스로 사용됨
아쉬운 점
- 대화형 모드는 샌드박스가 아닌 호스트 셸에서 실행
- MCP, IDE 연동, 지속되는 셸 상태 없음
- SWE-bench 이미지는 x86 Linux 전제
- v2가 v1 설정을 깨뜨림
추천 대상
모델을 벤치마크하거나 코딩 에이전트의 동작 원리를 배우려는 연구자와 엔지니어.
mini-swe-agent 대안
mini-swe-agent: 자주 묻는 질문
- mini-swe-agent, 쓸 만한 가치가 있습니까?
- 결과가 모델 자체를 측정할 만큼 단순한 벤치마크 하네스입니다. 바로 그 때문에 일상 코딩 도구로는 빈약하게 느껴집니다. 평점은 5점 만점에 4.0점입니다.
- mini-swe-agent의 가격은 얼마입니까?
- MIT의 무료 오픈소스입니다. 모델 제공사 비용만 냅니다.
- mini-swe-agent의 단점은 무엇입니까?
- 대화형 모드는 샌드박스가 아닌 호스트 셸에서 실행; MCP, IDE 연동, 지속되는 셸 상태 없음; SWE-bench 이미지는 x86 Linux 전제; v2가 v1 설정을 깨뜨림.
- mini-swe-agent에 적합한 사람은 누구입니까?
- 모델을 벤치마크하거나 코딩 에이전트의 동작 원리를 배우려는 연구자와 엔지니어.
- 팀이나 프로덕션 환경에서 mini-swe-agent의 비용은 얼마입니까?
- 무료이며 모델 사용료만 냅니다. 기본 설정은 실행마다 $3로 제한하고, MSWEA_GLOBAL_COST_LIMIT과 MSWEA_GLOBAL_CALL_LIMIT으로 배치 전체의 상한을 정합니다.
- mini-swe-agent에 회사 데이터를 맡겨도 안전합니까?
- 프로젝트는 호스팅 서비스를 운영하지 않으며, 프롬프트와 저장소 내용은 설정한 모델 제공사로 갑니다. 로컬 모드에서는 모델의 명령이 사용자의 기기에서 실행되며 확인 모드만이 이를 막습니다. 문서에는 텔레메트리 언급이 없고 GitHub 코드 검색에서도 텔레메트리 코드가 나오지 않습니다. MIT 라이선스이며 저장소에 공개된 보안 권고는 없습니다.
- mini-swe-agent의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 OpenHands 및 OpenCode입니다.
답변 확인일: 2026년 10월 26일.
mini-swe-agent 개발사입니까? 이 평점을 사이트에 표시하십시오
