๐ Other Languages
- [English](README.md)
- [ไธญๆ](README_zh.md)
- ํ๊ตญ์ด
[](https://github.com/mannaandpoem/OpenManus/stargazers)
[](https://opensource.org/licenses/MIT)
[](https://discord.gg/DYn29wFk9z)
# ๐ OpenManus
Manus๋ ๋๋ผ์ด ๋๊ตฌ์ง๋ง, OpenManus๋ *์ด๋ ์ฝ๋* ์์ด๋ ๋ชจ๋ ์์ด๋์ด๋ฅผ ์คํํ ์ ์์ต๋๋ค! ๐ซ
์ฐ๋ฆฌ ํ์ ๋ฉค๋ฒ์ธ [@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์๊ฐ ๋ง์ ์ถ์๋์์ผ๋ฉฐ, ๊ณ์ํด์ ๋ฐ์ ํ๊ณ ์์ต๋๋ค!
์ด ํ๋ก์ ํธ๋ ๊ฐ๋จํ ๊ตฌํ์์ ์์๋์์ผ๋ฉฐ, ์ฌ๋ฌ๋ถ์ ์ ์, ๊ธฐ์ฌ ๋ฐ ํผ๋๋ฐฑ์ ํ์ํฉ๋๋ค!
OpenManus๋ฅผ ํตํด ์ฌ๋ฌ๋ถ๋ง์ ์์ด์ ํธ๋ฅผ ์ฆ๊ฒจ๋ณด์ธ์!
๋ํ [OpenManus-RL](https://github.com/OpenManus/OpenManus-RL)์ ์๊ฐํ๊ฒ ๋์ด ๊ธฐ์ฉ๋๋ค. OpenManus์ UIUC ์ฐ๊ตฌ์๋ค์ด ๊ณต๋ ๊ฐ๋ฐํ ์ด ์คํ์์ค ํ๋ก์ ํธ๋ LLM ์์ด์ ํธ์ ๋ํด ๊ฐํ ํ์ต(RL) ๊ธฐ๋ฐ (์: GRPO) ํ๋ ๋ฐฉ๋ฒ์ ์ ๊ณตํฉ๋๋ค.
## ํ๋ก์ ํธ ๋ฐ๋ชจ
## ์ค์น ๋ฐฉ๋ฒ
๋ ๊ฐ์ง ์ค์น ๋ฐฉ๋ฒ์ ์ ๊ณตํฉ๋๋ค. **๋ฐฉ๋ฒ 2 (uv ์ฌ์ฉ)** ์ด ๋ ๋น ๋ฅธ ์ค์น์ ํจ์จ์ ์ธ ์ข
์์ฑ ๊ด๋ฆฌ๋ฅผ ์ํด ๊ถ์ฅ๋ฉ๋๋ค.
### ๋ฐฉ๋ฒ 1: conda ์ฌ์ฉ
1. ์๋ก์ด conda ํ๊ฒฝ์ ์์ฑํฉ๋๋ค:
```bash
conda create -n open_manus python=3.12
conda activate open_manus
```
2. ์ ์ฅ์๋ฅผ ํด๋ก ํฉ๋๋ค:
```bash
git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus
```
3. ์ข
์์ฑ์ ์ค์นํฉ๋๋ค:
```bash
pip install -r requirements.txt
```
### ๋ฐฉ๋ฒ 2: uv ์ฌ์ฉ (๊ถ์ฅ)
1. uv๋ฅผ ์ค์นํฉ๋๋ค. (๋น ๋ฅธ Python ํจํค์ง ์ค์น ๋ฐ ์ข
์์ฑ ๊ด๋ฆฌ ๋๊ตฌ):
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
2. ์ ์ฅ์๋ฅผ ํด๋ก ํฉ๋๋ค:
```bash
git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus
```
3. ์๋ก์ด ๊ฐ์ ํ๊ฒฝ์ ์์ฑํ๊ณ ํ์ฑํํฉ๋๋ค:
```bash
uv venv
source .venv/bin/activate # Unix/macOS์ ๊ฒฝ์ฐ
# Windows์ ๊ฒฝ์ฐ:
# .venv\Scripts\activate
```
4. ์ข
์์ฑ์ ์ค์นํฉ๋๋ค:
```bash
uv pip install -r requirements.txt
```
## ์ค์ ๋ฐฉ๋ฒ
OpenManus๋ฅผ ์ฌ์ฉํ๋ ค๋ฉด ์ฌ์ฉํ๋ LLM API์ ๋ํ ์ค์ ์ด ํ์ํฉ๋๋ค. ์๋ ๋จ๊ณ๋ฅผ ๋ฐ๋ผ ์ค์ ์ ์๋ฃํ์ธ์:
1. `config` ๋๋ ํ ๋ฆฌ์ `config.toml` ํ์ผ์ ์์ฑํ์ธ์ (์์ ํ์ผ์ ๋ณต์ฌํ์ฌ ์ฌ์ฉํ ์ ์์ต๋๋ค):
```bash
cp config/config.example.toml config/config.toml
```
2. `config/config.toml` ํ์ผ์ ํธ์งํ์ฌ API ํค๋ฅผ ์ถ๊ฐํ๊ณ ์ค์ ์ ์ปค์คํฐ๋ง์ด์งํ์ธ์:
```toml
# ์ ์ญ 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๋ฅผ ์คํํ๋ ํ ์ค ๋ช
๋ น์ด:
```bash
python main.py
```
์ดํ ํฐ๋ฏธ๋์์ ์์ด๋์ด๋ฅผ ์์ฑํ์ธ์!
unstable ๋ฒ์ ์ ์คํํ๋ ค๋ฉด ์๋ ๋ช
๋ น์ด๋ฅผ ์ฌ์ฉํ ์๋ ์์ต๋๋ค:
```bash
python run_flow.py
```
## ๊ธฐ์ฌ ๋ฐฉ๋ฒ
๋ชจ๋ ์น์ ํ ์ ์๊ณผ ์ ์ฉํ ๊ธฐ์ฌ๋ฅผ ํ์ํฉ๋๋ค! ์ด์๋ฅผ ์์ฑํ๊ฑฐ๋ ํ ๋ฆฌํ์คํธ๋ฅผ ์ ์ถํด ์ฃผ์ธ์.
๋๋ ๐ง ๋ฉ์ผ๋ก ์ฐ๋ฝ์ฃผ์ธ์. @mannaandpoem : mannaandpoem@gmail.com
## ์ปค๋ฎค๋ํฐ ๊ทธ๋ฃน
Feishu ๋คํธ์ํน ๊ทธ๋ฃน์ ์ฐธ์ฌํ์ฌ ๋ค๋ฅธ ๊ฐ๋ฐ์๋ค๊ณผ ๊ฒฝํ์ ๊ณต์ ํ์ธ์!
## Star History
[](https://star-history.com/#mannaandpoem/OpenManus&Date)
## ๊ฐ์ฌ์ ๊ธ
์ด ํ๋ก์ ํธ์ ๊ธฐ๋ณธ์ ์ธ ์ง์์ ์ ๊ณตํด ์ฃผ์ [anthropic-computer-use](https://github.com/anthropics/anthropic-quickstarts/tree/main/computer-use-demo)์
[browser-use](https://github.com/browser-use/browser-use)์๊ฒ ๊ฐ์ฌ๋๋ฆฝ๋๋ค!
๋ํ, [AAAJ](https://github.com/metauto-ai/agent-as-a-judge), [MetaGPT](https://github.com/geekan/MetaGPT), [OpenHands](https://github.com/All-Hands-AI/OpenHands)์ ๊น์ ๊ฐ์ฌ๋ฅผ ๋๋ฆฝ๋๋ค.
OpenManus๋ MetaGPT ๊ธฐ์ฌ์๋ค์ ์ํด ๊ฐ๋ฐ๋์์ต๋๋ค. ์ด ์์ด์ ํธ ์ปค๋ฎค๋ํฐ์ ๊น์ ๊ฐ์ฌ๋ฅผ ์ ํฉ๋๋ค!
## ์ธ์ฉ
```bibtex
@misc{openmanus2025,
author = {Xinbin Liang and Jinyu Xiang and Zhaoyang Yu and Jiayi Zhang and Sirui Hong},
title = {OpenManus: An open-source framework for building general AI agents},
year = {2025},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/mannaandpoem/OpenManus}},
}
```