Open Source AI Agent 36.2k Stars

OpenManus

An open-source framework for building general AI agents without Invite Code 🛫

OpenManus Logo

Stars

36.2k

Rapidly growing community support

Forks

5.9k

Active development and contributions

Contributors

39

Growing team of developers

👋 About OpenManus

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

Our team members @Xinbin Liang and @Jinyu Xiang (core authors), along with @Zhaoyang Yu, @Jiayi Zhang, and @Sirui Hong, 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 Structure

graph TD A[OpenManus] --> B[app/] A --> C[assets/] A --> D[config/] A --> E[examples/] B --> F[agents/] B --> G[core/] B --> H[tools/] B --> I[utils/] D --> J[config.toml] E --> K[Example Agents] style A fill:#f9f9f9,stroke:#333,stroke-width:2px

Core Components

  • app/ - Main application code
  • config/ - Configuration files
  • examples/ - Example implementations
  • main.py - Entry point
  • run_flow.py - Experimental version

Technical Stack

  • Python 3.12
  • OpenAI API
  • LLM-based agents
  • Reinforcement Learning
  • Web browsing capabilities
  • Tool use framework

🚀 Installation Guide

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

# 2. Clone the repository
git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus

# 3. 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

# 2. Clone the repository
git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus

# 3. Create a new virtual environment and activate it
uv venv --python 3.12
source .venv/bin/activate  # On Unix/macOS
# Or on Windows:
# .venv\Scripts\activate

# 4. 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
cp config/config.example.toml config/config.toml

# 2. 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

👨‍💻 Contributors

@mannaandpoem @mannaandpoem
@XiangJinyu @XiangJinyu
@fred913 @fred913
@MoshiQAQ @MoshiQAQ
@K-tang-mkv @K-tang-mkv
@rxdaozhang @rxdaozhang
@Kingtous @Kingtous
@xyuzh @xyuzh
@XBsleepy @XBsleepy
@stellaHSR @stellaHSR

📊 Repository Statistics

Languages

Python 99.8%
Dockerfile 0.2%

Star History

Star History Chart

🌐 Join Our Community

Community Group

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

OpenManus Community Group

📚 Further Reading

Recommended Resources