Repolode
SWE-agent

SWE-agent/mini-swe-agent

bash와 약 100줄의 핵심 Python 코드만 사용하는 최소한의 AI 소프트웨어 엔지니어링 에이전트로, GitHub 이슈를 해결하거나 CLI에서 작업을 돕습니다.

대체할 수 있는 제품:Claude CodeCodex

스타
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. 1

    uv를 사용해 격리된 환경에 CLI를 설치하고 사용해 보세요

    pip install uv && uvx mini-swe-agent
  2. 2

    또는 현재 환경에 CLI와 Python 바인딩을 설치하세요

    pip install mini-swe-agent
  3. 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 통계는 매일 갱신됩니다.

관련 프로젝트