← 보드로 돌아가기

FoundationAgents/OpenManus

No fortress, purely open ground. OpenManus is Coming.

GitHub에서 열기 ↗
56,873
GitHub 스타
9,897
포크
Python
언어
MIT
라이선스
2026.02.11
최근 푸시
2026.05.12
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
AI 에이전트를 직접 구축하거나 확장하려는 개발자에게 적합하며, 특히 MetaGPT 생태계에 익숙한 팀이나 강화 학습 기반 에이전트 튜닝(OpenManus-RL)에 관심이 있는 연구자에게 유용

강점

  • 초대 코드 없이 누구나 사용 가능한 완전 오픈소스 에이전트 프레임워크
  • 3시간 만에 프로토타입이 출시될 정도로 빠른 개발 속도와 활발한 커뮤니티 참여
  • 다중 에이전트 모드, MCP 도구, 데이터 분석 에이전트 등 다양한 실행 옵션 제공

약점

  • README에 명시된 대로 아직 간단한 구현 단계이며, 다중 에이전트 버전은 불안정함
  • LLM API 키 설정이 필수적이며, OpenAI API에 의존적임
  • 브라우저 자동화 등 일부 기능은 선택 사항이지만 추가 설치가 필요함

주의사항

  • config.toml에 API 키를 직접 입력해야 하므로, 실수로 공개 저장소에 커밋하지 않도록 주의
  • 다중 에이전트 버전(run_flow.py)은 불안정하므로 프로덕션 환경보다는 실험용으로 사용
  • 데이터 분석 에이전트 사용 시 추가 의존성 설치가 필요하므로 문서를 꼭 확인

시작 가이드

  • 저장소를 클론하고 conda 또는 uv로 환경을 설정한 후 config.toml에 OpenAI API 키를 입력
  • python main.py를 실행하여 기본 에이전트를 테스트하고, 필요에 따라 run_flow.py로 다중 에이전트 실험
  • OpenManus-RL 저장소를 확인하여 강화 학습 기반 에이전트 튜닝 방법 탐색

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

<p align="center"> <img src="assets/logo.jpg" width="200"/> </p>

English | 中文 | 한국어 | 日本語

&ensp; &ensp;

👋 OpenManus

Manus는 놀랍지만, OpenManus는 초대 코드 없이도 어떤 아이디어든 실현할 수 있습니다 🛫!

저희 팀원 @Xinbin Liang과 @Jinyu Xiang(핵심 저자), 그리고 @Zhaoyang Yu, @Jiayi Zhang, @Sirui Hong은 @MetaGPT 출신입니다. 프로토타입은 3시간 만에 출시되었으며, 계속해서 구축 중입니다!

간단한 구현이므로, 제안, 기여, 피드백을 환영합니다!

OpenManus로 나만의 에이전트를 즐기세요!

또한 OpenManus-RL을 소개하게 되어 기쁩니다. 이는 UIUC와 OpenManus의 연구원들이 공동 개발한 LLM 에이전트를 위한 강화 학습(RL) 기반(예: GRPO) 튜닝 방법에 특화된 오픈소스 프로젝트입니다.

프로젝트 데모

<video src="https://private-user-images.githubusercontent.com/61239030/420168772-6dcfd0d2-9142-45d9-b74e-d10aa75073c6.mp4?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NDEzMTgwNTksIm5iZiI6MTc0MTMxNzc1OSwicGF0aCI6Ii82MTIzOTAzMC80MjAxNjg3NzItNmRjZmQwZDItOTE0Mi00NWQ5LWI3NGUtZDEwYWE3NTA3M2M2Lm1wND9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNTAzMDclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjUwMzA3VDAzMjIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTdiZjFkNjlmYWNjMmEzOTliM2Y3M2VlYjgyNDRlZDJmOWE3NWZhZjE1MzhiZWY4YmQ3NjdkNTYwYTU5ZDA2MzYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.UuHQCgWYkh0OQq9qsUWqGsUbhG3i9jcZDAMeHjLt5T4" data-canonical-src="https://private-user-images.githubusercontent.com/61239030/420168772-6dcfd0d2-9142-45d9-b74e-d10aa75073c6.mp4?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NDEzMTgwNTksIm5iZiI6MTc0MTMxNzc1OSwicGF0aCI6Ii82MTIzOTAzMC80MjAxNjg3NzItNmRjZmQwZDItOTE0Mi00NWQ5LWI3NGUtZDEwYWE3NTA3M2M2Lm1wND9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNTAzMDclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjUwMzA3VDAzMjIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTdiZjFkNjlmYWNjMmEzOTliM2Y3M2VlYjgyNDRlZDJmOWE3NWZhZjE1MzhiZWY4YmQ3NjdkNTYwYTU5ZDA2MzYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.UuHQCgWYkh0OQq9qsUWqGsUbhG3i9jcZDAMeHjLt5T4" controls="controls" muted="muted" class="d-block rounded-bottom-2 border-top width-fit" style="max-height:640px; min-height: 200px"></video>

설치

두 가지 설치 방법을 제공합니다. 더 빠른 설치와 더 나은 의존성 관리를 위해 방법 2(uv 사용)를 권장합니다.

방법 1: conda 사용

  1. 새로운 conda 환경 생성:
conda create -n open_manus python=3.12
conda activate open_manus
  1. 저장소 클론:
git clone https://github.com/FoundationAgents/OpenManus.git
cd OpenManus
  1. 의존성 설치:
pip install -r requirements.txt

방법 2: uv 사용 (권장)

  1. uv 설치 (빠른 Python 패키지 설치 및 해결 도구):
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 저장소 클론:
git clone https://github.com/FoundationAgents/OpenManus.git
cd OpenManus
  1. 새로운 가상 환경 생성 및 활성화:
uv venv --python 3.12
source.venv/bin/activate  # Unix/macOS
# 또는 Windows:
#.venv\Scripts\activate
  1. 의존성 설치:
uv pip install -r requirements.txt

브라우저 자동화 도구 (선택 사항)

playwright install

설정

OpenManus는 사용하는 LLM API에 대한 설정이 필요합니다. 다음 단계에 따라 설정을 완료하세요:

  1. config 디렉토리에 config.toml 파일 생성 (예제에서 복사 가능):
cp config/config.example.toml config/config.toml
  1. config/config.toml을 편집하여 API 키를 추가하고 설정을 사용자 정의:
# 전역 LLM 설정
[llm]
model = "gpt-4o"
base_url = "https://api.openai.com/v1"
api_key = "sk-..."  # 실제 API 키로 교체
max_tokens = 4096
temperature = 0.0

# 특정 LLM 모델에 대한 선택적 설정
[llm.vision]
model = "gpt-4o"
base_url = "https://api.openai.com/v1"
api_key = "sk-..."  # 실제 API 키로 교체

빠른 시작

OpenManus 실행 한 줄 명령어:

python main.py

그런 다음 터미널에 아이디어를 입력하세요!

MCP 도구 버전의 경우 다음을 실행:

python run_mcp.py

불안정한 다중 에이전트 버전의 경우 다음도 실행 가능:

python run_flow.py

다중 에이전트 사용자 정의 추가

현재 일반 OpenManus 에이전트 외에도 데이터 분석 및 데이터 시각화 작업에 적합한 DataAnalysis 에이전트가 통합되어 있습니다. 이 에이전트를 config.toml의 run_flow에 추가할 수 있습니다.

# run-flow에 대한 선택적 설정
[runflow]
use_data_analysis_agent = true     # 기본적으로 비활성화, 활성화하려면 true로 변경

또한 에이전트가 제대로 실행되도록 관련 의존성을 설치해야 합니다: 상세 설치 가이드

기여 방법

친절한 제안과 도움이 되는 기여를 환영합니다! 이슈를 생성하거나 풀 리퀘스트를 제출해 주세요.

또는 📧이메일: [email protected]으로 @mannaandpoem에 연락하세요.

참고: 풀 리퀘스트를 제출하기 전에 pre-commit 도구를 사용하여 변경 사항을 확인하세요. pre-commit run --all-files를 실행하여 검사를 수행하세요.

커뮤니티 그룹

Feishu에서 네트워킹 그룹에 가입하고 다른 개발자와 경험을 공유하세요!

<div align="center" style="display: flex; gap: 20px;"> <img src="assets/community_group.jpg" alt="OpenManus 交流群" width="300" /> </div>

Star History

스폰서

컴퓨팅 리소스 지원에 감사드립니다 PPIO.

PPIO: 가장 저렴하고 쉽게 통합되는 MaaS 및 GPU 클라우드 솔루션.

감사의 말

이 프로젝트에 기본 지원을 제공한 anthropic-computer-use, browser-use 및 crawl4ai에 감사드립니다!

또한 AAAJ, MetaGPT, OpenHands 및 SWE-agent에 감사드립니다.

Hugging Face 데모 공간을 지원해 주신 stepfun(阶跃星辰)에도 감사드립니다.

OpenManus는 MetaGPT의 기여자들에 의해 구축되었습니다. 이 에이전트 커뮤니티에 큰 감사를 드립니다!

인용

@misc{openmanus2025,
  author = {Xinbin Liang and Jinyu Xiang and Zhaoyang Yu and Jiayi Zhang and Sirui Hong and Sheng Fan and Xiao Tang and Bang Liu and Yuyu Luo and Chenglin Wu},
  title = {OpenManus: An open-source framework for building general AI agents},
  year = {2025},
  publisher = {Zenodo},
  doi = {10.5281/zenodo.15186407},
  url = {https://doi.org/10.5281/zenodo.15186407},
}

원본 저장소: FoundationAgents/OpenManus

라이선스: MIT

게재 제외를 원하시면 삭제 요청을 보내주세요.