|
| 1 | +[English](README.md) | [中文](README_zh.md) | 한국어 | [日本語](README_ja.md) |
| 2 | + |
| 3 | + |
| 4 | +[](https://github.com/mannaandpoem/OpenManus/stargazers) |
| 5 | +  |
| 6 | +[](https://opensource.org/licenses/MIT)   |
| 7 | +[](https://discord.gg/DYn29wFk9z) |
| 8 | + |
| 9 | +# 👋 OpenManus |
| 10 | + |
| 11 | +Manus는 놀라운 도구지만, OpenManus는 *초대 코드* 없이도 모든 아이디어를 실현할 수 있습니다! 🛫 |
| 12 | + |
| 13 | +우리 팀의 멤버인 [@Xinbin Liang](https://github.com/mannaandpoem)와 [@Jinyu Xiang](https://github.com/XiangJinyu) (핵심 작성자), 그리고 [@Zhaoyang Yu](https://github.com/MoshiQAQ), [@Jiayi Zhang](https://github.com/didiforgithub), [@Sirui Hong](https://github.com/stellaHSR)이 함께 했습니다. 우리는 [@MetaGPT](https://github.com/geekan/MetaGPT)로부터 왔습니다. 프로토타입은 단 3시간 만에 출시되었으며, 계속해서 발전하고 있습니다! |
| 14 | + |
| 15 | +이 프로젝트는 간단한 구현에서 시작되었으며, 여러분의 제안, 기여 및 피드백을 환영합니다! |
| 16 | + |
| 17 | +OpenManus를 통해 여러분만의 에이전트를 즐겨보세요! |
| 18 | + |
| 19 | +또한 [OpenManus-RL](https://github.com/OpenManus/OpenManus-RL)을 소개하게 되어 기쁩니다. OpenManus와 UIUC 연구자들이 공동 개발한 이 오픈소스 프로젝트는 LLM 에이전트에 대해 강화 학습(RL) 기반 (예: GRPO) 튜닝 방법을 제공합니다. |
| 20 | + |
| 21 | +## 프로젝트 데모 |
| 22 | + |
| 23 | +<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> |
| 24 | + |
| 25 | +## 설치 방법 |
| 26 | + |
| 27 | +두 가지 설치 방법을 제공합니다. **방법 2 (uv 사용)** 이 더 빠른 설치와 효율적인 종속성 관리를 위해 권장됩니다. |
| 28 | + |
| 29 | +### 방법 1: conda 사용 |
| 30 | + |
| 31 | +1. 새로운 conda 환경을 생성합니다: |
| 32 | + |
| 33 | +```bash |
| 34 | +conda create -n open_manus python=3.12 |
| 35 | +conda activate open_manus |
| 36 | +``` |
| 37 | + |
| 38 | +2. 저장소를 클론합니다: |
| 39 | + |
| 40 | +```bash |
| 41 | +git clone https://github.com/mannaandpoem/OpenManus.git |
| 42 | +cd OpenManus |
| 43 | +``` |
| 44 | + |
| 45 | +3. 종속성을 설치합니다: |
| 46 | + |
| 47 | +```bash |
| 48 | +pip install -r requirements.txt |
| 49 | +``` |
| 50 | + |
| 51 | +### 방법 2: uv 사용 (권장) |
| 52 | + |
| 53 | +1. uv를 설치합니다. (빠른 Python 패키지 설치 및 종속성 관리 도구): |
| 54 | + |
| 55 | +```bash |
| 56 | +curl -LsSf https://astral.sh/uv/install.sh | sh |
| 57 | +``` |
| 58 | + |
| 59 | +2. 저장소를 클론합니다: |
| 60 | + |
| 61 | +```bash |
| 62 | +git clone https://github.com/mannaandpoem/OpenManus.git |
| 63 | +cd OpenManus |
| 64 | +``` |
| 65 | + |
| 66 | +3. 새로운 가상 환경을 생성하고 활성화합니다: |
| 67 | + |
| 68 | +```bash |
| 69 | +uv venv |
| 70 | +source .venv/bin/activate # Unix/macOS의 경우 |
| 71 | +# Windows의 경우: |
| 72 | +# .venv\Scripts\activate |
| 73 | +``` |
| 74 | + |
| 75 | +4. 종속성을 설치합니다: |
| 76 | + |
| 77 | +```bash |
| 78 | +uv pip install -r requirements.txt |
| 79 | +``` |
| 80 | + |
| 81 | +## 설정 방법 |
| 82 | + |
| 83 | +OpenManus를 사용하려면 사용하는 LLM API에 대한 설정이 필요합니다. 아래 단계를 따라 설정을 완료하세요: |
| 84 | + |
| 85 | +1. `config` 디렉토리에 `config.toml` 파일을 생성하세요 (예제 파일을 복사하여 사용할 수 있습니다): |
| 86 | + |
| 87 | +```bash |
| 88 | +cp config/config.example.toml config/config.toml |
| 89 | +``` |
| 90 | + |
| 91 | +2. `config/config.toml` 파일을 편집하여 API 키를 추가하고 설정을 커스터마이징하세요: |
| 92 | + |
| 93 | +```toml |
| 94 | +# 전역 LLM 설정 |
| 95 | +[llm] |
| 96 | +model = "gpt-4o" |
| 97 | +base_url = "https://api.openai.com/v1" |
| 98 | +api_key = "sk-..." # 실제 API 키로 변경하세요 |
| 99 | +max_tokens = 4096 |
| 100 | +temperature = 0.0 |
| 101 | + |
| 102 | +# 특정 LLM 모델에 대한 선택적 설정 |
| 103 | +[llm.vision] |
| 104 | +model = "gpt-4o" |
| 105 | +base_url = "https://api.openai.com/v1" |
| 106 | +api_key = "sk-..." # 실제 API 키로 변경하세요 |
| 107 | +``` |
| 108 | + |
| 109 | +## 빠른 시작 |
| 110 | + |
| 111 | +OpenManus를 실행하는 한 줄 명령어: |
| 112 | + |
| 113 | +```bash |
| 114 | +python main.py |
| 115 | +``` |
| 116 | + |
| 117 | +이후 터미널에서 아이디어를 작성하세요! |
| 118 | + |
| 119 | +unstable 버전을 실행하려면 아래 명령어를 사용할 수도 있습니다: |
| 120 | + |
| 121 | +```bash |
| 122 | +python run_flow.py |
| 123 | +``` |
| 124 | + |
| 125 | +## 기여 방법 |
| 126 | + |
| 127 | +모든 친절한 제안과 유용한 기여를 환영합니다! 이슈를 생성하거나 풀 리퀘스트를 제출해 주세요. |
| 128 | + |
| 129 | +또는 📧 메일로 연락주세요. @mannaandpoem : mannaandpoem@gmail.com |
| 130 | + |
| 131 | +## 커뮤니티 그룹 |
| 132 | +Feishu 네트워킹 그룹에 참여하여 다른 개발자들과 경험을 공유하세요! |
| 133 | + |
| 134 | +<div align="center" style="display: flex; gap: 20px;"> |
| 135 | + <img src="assets/community_group.jpg" alt="OpenManus 交流群" width="300" /> |
| 136 | +</div> |
| 137 | + |
| 138 | +## Star History |
| 139 | + |
| 140 | +[](https://star-history.com/#mannaandpoem/OpenManus&Date) |
| 141 | + |
| 142 | +## 감사의 글 |
| 143 | + |
| 144 | +이 프로젝트에 기본적인 지원을 제공해 주신 [anthropic-computer-use](https://github.com/anthropics/anthropic-quickstarts/tree/main/computer-use-demo)와 |
| 145 | +[browser-use](https://github.com/browser-use/browser-use)에게 감사드립니다! |
| 146 | + |
| 147 | +또한, [AAAJ](https://github.com/metauto-ai/agent-as-a-judge), [MetaGPT](https://github.com/geekan/MetaGPT), [OpenHands](https://github.com/All-Hands-AI/OpenHands)에 깊은 감사를 드립니다. |
| 148 | + |
| 149 | +OpenManus는 MetaGPT 기여자들에 의해 개발되었습니다. 이 에이전트 커뮤니티에 깊은 감사를 전합니다! |
| 150 | + |
| 151 | +## 인용 |
| 152 | +```bibtex |
| 153 | +@misc{openmanus2025, |
| 154 | + author = {Xinbin Liang and Jinyu Xiang and Zhaoyang Yu and Jiayi Zhang and Sirui Hong}, |
| 155 | + title = {OpenManus: An open-source framework for building general AI agents}, |
| 156 | + year = {2025}, |
| 157 | + publisher = {GitHub}, |
| 158 | + journal = {GitHub repository}, |
| 159 | + howpublished = {\url{https://github.com/mannaandpoem/OpenManus}}, |
| 160 | +} |
| 161 | +``` |
0 commit comments