Skip to content

Latest commit

 

History

History
159 lines (108 loc) · 6.24 KB

README.md

File metadata and controls

159 lines (108 loc) · 6.24 KB

English | 中文

GitHub stars   License: MIT   Discord Follow

👋 OpenManus

Manus is incredible, but OpenManus can achieve any idea without an Invite Code 🛫!

Our team members @mannaandpoem @XiangJinyu @MoshiQAQ @didiforgithub @stellaHSR, we are from @MetaGPT. The prototype is launched within 3 hours and we are keeping building!

It's a simple implementation, so we welcome any suggestions, contributions, and feedback!

Enjoy your own agent with OpenManus!

We're also excited to introduce OpenManus-RL, an open-source project dedicated to reinforcement learning (RL)- based (such as GRPO) tuning methods for LLM agents, developed collaboratively by researchers from UIUC and OpenManus.

Project Demo

seo_website.mp4

Installation

We provide two installation methods. Method 2 (using uv) is recommended for faster installation and better dependency management.

Method 1: Using conda

  1. Create a new conda environment:
conda create -n open_manus python=3.12
conda activate open_manus
  1. Clone the repository:
git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus
  1. Install dependencies:
pip install -r requirements.txt

Method 2: Using uv (Recommended)

  1. Install uv (A fast Python package installer and resolver):
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Clone the repository:
git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus
  1. Create a new virtual environment and activate it:
uv venv
source .venv/bin/activate  # On Unix/macOS
# Or on Windows:
# .venv\Scripts\activate
  1. Install dependencies:
uv 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):
cp config/config.example.toml config/config.toml
  1. Edit config/config.toml to add your API keys and customize settings:
# 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:

python main.py

Then input your idea via terminal!

For unstable version, you also can run:

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

Community Group

Join our networking group on Feishu and share your experience with other developers!

OpenManus 交流群

Star History

Star History Chart

Acknowledgement

Thanks to anthropic-computer-use and browser-use for providing basic support for this project!

OpenManus is built by contributors from MetaGPT. Huge thanks to this agent community!

Cite

@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}},
}