166 lines
6.2 KiB
Markdown
166 lines
6.2 KiB
Markdown
|
||
[English](README.md) | 中文 | [한국어](README_ko.md)
|
||
|
||
|
||
|
||
[](https://github.com/mannaandpoem/OpenManus/stargazers)
|
||
 
|
||
[](https://opensource.org/licenses/MIT)  
|
||
[](https://discord.gg/DYn29wFk9z)
|
||
|
||
# 👋 OpenManus
|
||
|
||
Manus 非常棒，但 OpenManus 无需邀请码即可实现任何创意 🛫！
|
||
|
||
我们的团队成员 [@mannaandpoem](https://github.com/mannaandpoem) [@XiangJinyu](https://github.com/XiangJinyu) [@MoshiQAQ](https://github.com/MoshiQAQ) [@didiforgithub](https://github.com/didiforgithub) https://github.com/stellaHSR 来自 [@MetaGPT](https://github.com/geekan/MetaGPT) 组织，我们在 3
|
||
小时内完成了原型开发并持续迭代中！
|
||
|
||
这是一个简洁的实现方案，欢迎任何建议、贡献和反馈！
|
||
|
||
用 OpenManus 开启你的智能体之旅吧！
|
||
|
||
我们也非常高兴地向大家介绍 [OpenManus-RL](https://github.com/OpenManus/OpenManus-RL)，这是一个专注于基于强化学习（RL，例如 GRPO）的方法来优化大语言模型（LLM）智能体的开源项目，由来自UIUC 和 OpenManus 的研究人员合作开发。
|
||
|
||
## 项目演示
|
||
|
||
<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>
|
||
|
||
## 安装指南
|
||
|
||
我们提供两种安装方式。推荐使用方式二（uv），因为它能提供更快的安装速度和更好的依赖管理。
|
||
|
||
### 方式一：使用 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
|
||
```
|
||
|
||
### 方式二：使用 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
|
||
```
|
||
|
||
然后通过终端输入你的创意！
|
||
|
||
如需体验开发中版本，可运行：
|
||
|
||
```bash
|
||
python run_flow.py
|
||
```
|
||
|
||
## 贡献指南
|
||
|
||
我们欢迎任何友好的建议和有价值的贡献！可以直接创建 issue 或提交 pull request。
|
||
|
||
或通过 📧 邮件联系 @mannaandpoem：mannaandpoem@gmail.com
|
||
|
||
## 交流群
|
||
|
||
加入我们的飞书交流群，与其他开发者分享经验！
|
||
|
||
<div align="center" style="display: flex; gap: 20px;">
|
||
<img src="assets/community_group.jpg" alt="OpenManus 交流群" width="300" />
|
||
</div>
|
||
|
||
## Star 数量
|
||
|
||
[](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}},
|
||
}
|
||
``` |