질문을 계획하고 웹·로컬 자료를 수집해 인용이 포함된 보고서를 작성하는 오픈소스 자율 연구 에이전트
SWE-agent/mini-swe-agent
bash와 약 100줄의 핵심 Python 코드만 사용하는 최소한의 AI 소프트웨어 엔지니어링 에이전트로, GitHub 이슈를 해결하거나 CLI에서 작업을 돕습니다.
대체할 수 있는 제품:Claude Code
Codex
- 스타
- 8,664
- 포크
- 1,201
- 열린 이슈
- 100
- 마지막 커밋
- 10시간 전
어떤 프로젝트인가요?
mini-swe-agent는 소프트웨어 엔지니어링 작업을 위한 소형 AI 에이전트입니다. GitHub 이슈를 처리하거나 명령줄 도우미로 사용할 수 있습니다. 에이전트 클래스는 Python 약 100줄로 구성되어 있으며, 무거운 프레임워크에 의존하지 않습니다.
에이전트가 사용하는 도구는 bash뿐입니다. 모델의 tool-calling 인터페이스에 의존하지 않으므로 LiteLLM, OpenRouter 또는 Portkey에서 사용할 수 있는 모든 언어 모델과 함께 작동합니다. 각 작업은 subprocess.run을 통해 실행되므로 서로 독립적이며, 실행 호출을 바꾸는 것만으로 Docker, Podman, Singularity/Apptainer 또는 Bubblewrap 같은 샌드박스로 옮길 수 있습니다. 메시지 기록은 엄격한 선형 구조라 실행 과정을 디버깅하고 파인튜닝 데이터로 활용하기 쉽습니다.
이 프로젝트는 `mini` CLI, Python 바인딩, SWE-bench용 배치 추론 기능, 궤적 브라우저를 제공합니다. SWE-bench와 SWE-agent를 만든 Princeton 및 Stanford 팀이 개발했습니다.
핵심 기능
- 01에이전트 핵심 코드는 무거운 의존성 없이 Python 약 100줄로 구성됩니다.
- 02bash만 도구로 사용하며 모델의 tool-calling 지원이 필요하지 않습니다.
- 03각 작업을 subprocess.run으로 실행하므로 Docker, Podman, Apptainer 또는 Bubblewrap을 통해 샌드박스에서 실행할 수 있습니다.
- 04LiteLLM, OpenRouter, Portkey를 통해 모델을 사용할 수 있습니다.
- 05CLI, Python 바인딩, SWE-bench 배치 추론 기능, 궤적 브라우저를 포함합니다.
활용 사례
- 터미널에서 로컬 프로젝트를 대상으로 간편한 AI 코딩 도우미를 실행합니다.
- 에이전트 또는 모델 연구의 기준점으로 최소화되어 수정하기 쉬운 에이전트를 사용합니다.
- bash만 사용하는 스캐폴드를 통해 SWE-bench에서 언어 모델을 평가합니다.
- 더 안전하게 자동 코드 변경을 수행하기 위해 에이전트를 샌드박스 컨테이너에서 실행합니다.
빠른 시작
- 1
uv를 사용해 격리된 환경에 CLI를 설치하고 사용해 보세요
pip install uv && uvx mini-swe-agent - 2
또는 현재 환경에 CLI와 Python 바인딩을 설치하세요
pip install mini-swe-agent - 3
CLI를 실행하세요
mini
사용 전 알아둘 점
- 모델에 액세스하려면 API 키 또는 호환되는 모델 엔드포인트가 필요합니다. README에는 litellm 및 openrouter 지원 외의 세부 사항이 나와 있지 않습니다.
- 전체 SWE-bench 방식 실행과 샌드박스 환경에는 Docker, Podman, Apptainer 등의 추가 설정이 필요합니다.
토픽
자주 묻는 질문
- mini-swe-agent은(는) 무엇인가요?
- bash와 약 100줄의 핵심 Python 코드만 사용하는 최소한의 AI 소프트웨어 엔지니어링 에이전트로, GitHub 이슈를 해결하거나 CLI에서 작업을 돕습니다. mini-swe-agent는 소프트웨어 엔지니어링 작업을 위한 소형 AI 에이전트입니다. GitHub 이슈를 처리하거나 명령줄 도우미로 사용할 수 있습니다. 에이전트 클래스는 Python 약 100줄로 구성되어 있으며, 무거운 프레임워크에 의존하지 않습니다.
- mini-swe-agent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- mini-swe-agent은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- mini-swe-agent은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. mini-swe-agent의 마지막 커밋은 2026년 10월 19일입니다.
- mini-swe-agent은(는) 어디에 사용할 수 있나요?
- 터미널에서 로컬 프로젝트를 대상으로 간편한 AI 코딩 도우미를 실행합니다. 에이전트 또는 모델 연구의 기준점으로 최소화되어 수정하기 쉬운 에이전트를 사용합니다. bash만 사용하는 스캐폴드를 통해 SWE-bench에서 언어 모델을 평가합니다. 더 안전하게 자동 코드 변경을 수행하기 위해 에이전트를 샌드박스 컨테이너에서 실행합니다.
- mini-swe-agent는 어떻게 설치하나요?
- uv를 사용해 격리된 환경에 CLI를 설치하고 사용해 보세요: pip install uv && uvx mini-swe-agent 또는 현재 환경에 CLI와 Python 바인딩을 설치하세요: pip install mini-swe-agent CLI를 실행하세요: mini
- mini-swe-agent은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/SWE-agent/mini-swe-agent
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
JavaScript 및 Python SDK를 제공해 AI 생성 코드를 격리된 클라우드 샌드박스에서 실행하는 오픈소스 인프라입니다.
원하는 LLM에 연결하고 LSP와 MCP를 지원하며 프로젝트별 세션을 제공하는 터미널 기반 AI 코딩 에이전트입니다.
AI 에이전트가 실제 작업을 수행하도록 Docker 기반 Linux 데스크톱, 브라우저, 문서 도구를 제공하는 오픈 에이전트 프레임워크
순차형, 동시 실행형, 그래프 기반, 계층형 워크플로로 멀티 에이전트 시스템을 구축하고 조율하는 Python 프레임워크.
LangGraph 기반의 모듈형 Agentic RAG 튜토리얼로, 계층형 인덱싱과 대화 메모리, 질의 명확화 기능을 제공합니다.