108 lines
4.5 KiB
Markdown
108 lines
4.5 KiB
Markdown
<p align="left">
|
||
<a href="README_zh.md">中文</a>  ｜  English 
|
||
</p>
|
||
|
||
# OpenManus 🙋
|
||
Manus is incredible, but OpenManus can achieve any ideas without an Invite Code 🛫!
|
||
|
||
Our team members [@mannaandpoem](https://github.com/mannaandpoem) [@XiangJinyu](https://github.com/XiangJinyu) [@MoshiQAQ](https://github.com/MoshiQAQ) [@didiforgithub](https://github.com/didiforgithub) from [@MetaGPT](https://github.com/geekan/MetaGPT) built it within 3 hours!
|
||
|
||
It's a simple implementation, so we welcome any suggestions, contributions, and feedback!
|
||
|
||
Enjoy your own agent with OpenManus!
|
||
|
||
## Project Demo
|
||
|
||
<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>
|
||
|
||
## Installation
|
||
|
||
1. Create a new conda environment:
|
||
|
||
```bash
|
||
conda create -n open_manus python=3.12
|
||
conda activate open_manus
|
||
```
|
||
|
||
2. Clone the repository:
|
||
|
||
```bash
|
||
git clone https://github.com/mannaandpoem/OpenManus.git
|
||
cd OpenManus
|
||
```
|
||
|
||
3. Install dependencies:
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
## Configuration
|
||
|
||
OpenManus requires configuration for the LLM APIs it uses. Follow these steps to set up your configuration:
|
||
|
||
1. Create a `config.toml` file in the `config` directory (you can copy from the example):
|
||
|
||
```bash
|
||
cp config/config.example.toml config/config.toml
|
||
```
|
||
|
||
2. Edit `config/config.toml` to add your API keys and customize settings:
|
||
|
||
```toml
|
||
# Global LLM configuration
|
||
[llm]
|
||
model = "gpt-4o"
|
||
base_url = "https://api.openai.com/v1"
|
||
api_key = "sk-..." # Replace with your actual API key
|
||
max_tokens = 4096
|
||
temperature = 0.0
|
||
|
||
# Optional configuration for specific LLM models
|
||
[llm.vision]
|
||
model = "gpt-4o"
|
||
base_url = "https://api.openai.com/v1"
|
||
api_key = "sk-..." # Replace with your actual API key
|
||
```
|
||
|
||
## Quick Start
|
||
One line for run OpenManus:
|
||
|
||
```bash
|
||
python main.py
|
||
```
|
||
|
||
Then input your idea via terminal!
|
||
|
||
For unstable version, you also can run:
|
||
|
||
```bash
|
||
python run_flow.py
|
||
```
|
||
|
||
## How to contribute
|
||
We welcome any friendly suggestions and helpful contributions! Just create issues or submit pull requests.
|
||
|
||
Or contact @mannaandpoem via 📧email: mannaandpoem@gmail.com
|
||
|
||
## Roadmap
|
||
- [ ] Better Planning
|
||
- [ ] Live Demos
|
||
- [ ] Replay
|
||
- [ ] RL Fine-tuned Models
|
||
- [ ] Comprehensive Benchmarks
|
||
|
||
## Community Group
|
||
Join our networking group and share your experience with other developers!
|
||
|
||
<div align="center" style="display: flex; gap: 20px;">
|
||
<img src="assets/community_group_3.jpg" alt="OpenManus 交流群3" width="300" />
|
||
<img src="assets/community_group_4.jpg" alt="OpenManus 交流群4" width="300" />
|
||
</div>
|
||
|
||
## Acknowledgement
|
||
|
||
Thanks to [anthropic-computer-use](https://github.com/anthropics/anthropic-quickstarts/tree/main/computer-use-demo) and [broswer-use](https://github.com/browser-use/browser-use) for providing basic support for this project!
|
||
|
||
OpenManus is built by contributors from MetaGPT. Huge thanks to this agent community!
|