FoundationAgents /OpenManus

No fortress, purely open ground. OpenManus is Coming.

★ 58,968⑂ 10,249👁 422⑃ 605● 774▤ 3
PythonMITCreated 2025-03-06openmanus.github.io/
More from this author
Download: v0.3.0OpenManus-0.3.0 ↓0.3.02025-04-10
+1
Daily
+32
Weekly
58,968
stars
10,249
forks
422
watchers
605
prs
774
issues
3
releases

README

English | 中文 | 한국어 | 日本語


 
  




 👋 OpenManus

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

Our team members @Xinbing 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 Demo



 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:

bash
conda create -n open_manus python=3.12
conda activate open_manus


2. Clone the repository:

bash
git clone https://github.com/FoundationAgents/OpenManus.git
cd OpenManus


3. Install dependencies:

bash
pip install -r requirements.txt


 Method 2: Using uv (Recommended)

1. Install uv (A fast Python package installer and resolver):

bash
curl -LsSf https://astral.sh/uv/install.sh | sh


2. Clone the repository:

bash
git clone https://github.com/FoundationAgents/OpenManus.git
cd OpenManus


3. Create a new virtual environment and activate it:

bash
uv venv --python 3.12
source .venv/bin/activate   On Unix/macOS
 Or on Windows:
 .venv\Scripts\activate


4. Install dependencies:

bash
uv pip install -r requirements.txt


 Browser automation

OpenManus starts Browser Use CLI 3.0 as a default MCP server:

bash
uvx browser-use --cli-mcp


uvx keeps Browser Use and its fast-moving dependencies isolated from the
OpenManus environment. The agent receives the canonical Browser Use skill and
the native browser_exec and browser_screenshot tools.

Local mode attaches to Chrome or Chromium automatically and needs no API key.
For diagnostics or to install Chromium, run:

bash
uvx browser-use --doctor
uvx browser-use install


For an isolated Browser Use Cloud browser, authenticate before starting
OpenManus. The agent can then start and select a named remote browser:

bash
export BROWSER_USE_API_KEY="bu_..."


Existing browsers can be selected with BU_CDP_URL, BU_CDP_WS, or BU_NAME.
Set OPENMANUS_DISABLE_BROWSER_USE=1 to disable the default Browser Use MCP
server.

BrowserGym still requires its Playwright browser:

bash
playwright install


 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_u

Top issues

Discussions

Latest release

v0.3.0 v0.3.0 2025-04-10

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON