QuantaAlpha/RepoMaster

2025.09.19🎉 저희의 논문들이 NeurIPS 2025에 채택되었음을 기쁘게 발표합니다. RepoMaster가 (≈3.2%) 확률로 Poster로, SE-Agent가 (≈24.52%) 확률로 Spotlight로 선정되었습니다!

2025.08.28🎉 복잡한 실세계 작업을 해결하기 위해 GitHub 저장소(repos)를 활용하는 AI 에이전트인 RepoMaster를 오픈 소스로 공개했습니다.

2025.08.26🎉 실세계 작업을 위한 저장소 수준(repo-level)의 벤치마크 및 툴링 스위트인 GitTaskBench를 오픈 소스로 공개했습니다.

2025.08.10🎉 다단계 추론 (multi-step reasoning)을 위한 자기 진화 궤적 프레임워크 (self-evolution trajectory framework)인 SE-Agent를 오픈 소스로 공개했습니다.

🔗

생태계 (Ecosystem): RepoMaster · GitTaskBench · SE-Agent · 팀 홈페이지

RepoMaster는 적절한 GitHub 도구를 자동으로 찾아내고 이들이 원활하게 함께 작동하도록 함으로써 코딩 작업을 해결하는 방식을 변화시킵니다. 원하는 내용을 설명하기만 하면, 오픈 소스 저장소들이 당신의 지능형 어시스턴트가 되는 과정을 지켜보게 될 것입니다.

💬 작업 설명 (Describe Task) → 🧠 AI 분석 (AI Analysis) → 🔍 자동 탐색 (Auto Discovery) → ⚡ 스마트 실행 (Smart Execution) → ✅ 완벽한 결과 (Perfect Results)

git clone https://github.com/QuantaAlpha/RepoMaster.git
cd RepoMaster
pip install -r requirements.txt

예시 설정 파일을 복사하여 귀하의 API 키로 맞춤 설정하세요:

cp configs/env.example configs/.env
# 선호하는 에디터로 설정 파일을 편집하세요
nano configs/.env # 또는 vim, code 등을 사용하세요

필수 API 키 (Required API Keys):

# 기본 AI 제공자 (필수)
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_MODEL=gpt-5
...

💡 팁 (Tip): configs/env.example 파일에는 상세한 주석과 함께 사용 가능한 모든 설정 옵션이 포함되어 있습니다.

웹 인터페이스 (Web Interface) (초보자 권장):

python launcher.py --mode frontend
# 웹 대시보드 접속 주소: http://localhost:8501

명령줄 인터페이스 (Command Line Interface) (숙련자 권장):

python launcher.py --mode backend --backend-mode unified
# 터미널을 통해 지능형 멀티 에이전트 오케스트레이션 (multi-agent orchestration)을 제공합니다

특화된 에이전트 접속 (Specialized Agent Access):

python launcher.py --mode backend --backend-mode deepsearch # Deep Search Agent (심층 검색 에이전트)
python launcher.py --mode backend --backend-mode general_assistant # Programming Assistant (프로그래밍 어시스턴트)
python launcher.py --mode backend --backend-mode repository_agent # Repository Agent (리포지토리 에이전트)

📘

도움이 필요하신가요? 고급 설정, 문제 해결(Troubleshooting), 그리고 상세한 사용 예시에 대해서는 당사의 종합 사용자 가이드(User Guide)를 확인해 주세요.

단순히 자연어로 작업을 설명하기만 하면 됩니다. RepoMaster의 AI가 귀하의 요청을 자동으로 분석하고, 최적의 솔루션 경로로 지능적으로 라우팅(Routing)하며, 아이디어를 실현하기 위해 완벽한 GitHub 도구들을 오케스트레이션(Orchestration)합니다.

작업 설명	RepoMaster 동작	결과
"이 웹페이지에서 제품 가격을 스크래핑하는 것을 도와줘"	🔍 스크래핑 도구 탐색 → 🔧 자동 구성 → ✅ 데이터 추출	구조화된 CSV 출력
"사진을 반 고흐 스타일로 변환해줘"	🔍 스타일 전이(Style Transfer) 리포지토리 탐색 → 🎨 이미지 처리 → ✅ 예술 작품 생성	예술적 걸작

**"처음부터 코드 작성하기"**에서 → **"오픈 소스 작동시키기"**까지

repomaster.2.1.mp4

RepoMaster가 신경 스타일 전이(Neural Style Transfer) 작업을 자율적으로 수행하는 전체 과정

고급 사용법, 구성 옵션 및 문제 해결(Troubleshooting)에 대해서는 사용자 가이드를 참조하십시오.

우리는 커뮤니티 주도 혁신의 힘을 믿습니다. 여러분의 기여는 RepoMaster를 더 똑똑하고, 빠르고, 유능하게 만드는 데 도움이 됩니다.

🐛 버그 보고(Bug Reports): 이슈를 보고하여 저희가 문제를 식별하고 수정할 수 있도록 도와주세요. 💡 기능 요청(Feature Requests): 멋진 아이디어가 있나요? 새로운 기능을 제안해 주세요.

특별 감사:

• AutoGen - 멀티 에이전트 프레임워크 (Multi-agent framework)

• OpenHands - 소프트웨어 엔지니어링 에이전트 (Software engineering agents)

• SWE-Agent - GitHub 이슈 해결 (GitHub issue resolution)

• MLE-Bench - ML 엔지니어링 벤치마크 (ML engineering benchmarks)

• QuantaAlpha는 Tsinghua University, Peking University, CAS, CMU, HKUST 등의 교수, 박사후 연구원, 박사 및 석사 과정 학생들로 구성된 팀에 의해 2025년 4월에 설립되었습니다.

🌟 우리의 미션은 지능의 **"양자(quantum)"**를 탐구하고, **CodeAgents (코드 에이전트)**에서 자기 진화형 지능 (self-evolving intelligence), 더 나아가 **금융 및 교차 도메인 특화 에이전트 (financial and cross-domain specialized agents)**에 이르기까지 에이전트 연구의 "알파(alpha)" 프런티어를 개척하는 것입니다. 우리는 AI의 경계를 재정의하는 데 전념하고 있습니다.

✨ 2025년에 우리는 다음과 같은 방향으로 고품질 연구를 지속할 것입니다:

CodeAgent (코드 에이전트): 실세계 작업의 엔드투엔드 (End-to-end) 자율 실행
DeepResearch (딥 리서치): 심층 추론 및 검색 증강 지능 (Retrieval-Augmented Intelligence)
Agentic Reasoning / Agentic RL (에이전트 기반 추론 / 에이전트 기반 강화학습): 에이전트 기반 추론 및 강화학습 (Reinforcement Learning)
Self-evolution and collaborative learning (자기 진화 및 협업 학습): 멀티 에이전트 시스템 (Multi-agent systems)의 진화 및 조정

📢 이러한 방향에 관심 있는 학생 및 연구자들의 참여를 환영합니다!

🔗 팀 홈페이지 (Team Homepage): QuantaAlpha
📧 이메일 (Email): quantaalpha.ai@gmail.com

만약 귀하의 연구에 RepoMaster가 유용하다면, 저희의 작업물을 인용해 주세요:

@article{wang2025repomaster,
title={RepoMaster: Autonomous Exploration and Understanding of GitHub Repositories for Complex Task Solving},
author={Huacan Wang and Ziyi Ni and Shuo Zhang and Lu, Shuo and Sen Hu and Ziyang He and Chen Hu and Jiaye Lin and Yifu Guo and Ronghao Chen and Xin Li and Daxin Jiang and Yuntao Du and Pin Lyu},
...

⭐ RepoMaster가 도움이 되었다면, 스타(star)를 눌러주세요!

QuantaAlpha 팀이 ❤️를 담아 만들었습니다.