# OpenManus — Open-Source General-Purpose AI Agent Framework

> A community-driven open-source AI agent framework that enables building autonomous agents capable of web browsing, coding, file manipulation, and multi-step task completion.

## Install

Save as a script file and run:

# OpenManus — Open-Source General-Purpose AI Agent Framework

## Quick Use
```bash
git clone https://github.com/FoundationAgents/OpenManus.git
cd OpenManus
pip install -r requirements.txt
cp config/config.example.toml config/config.toml
python main.py "Research the latest trends in edge AI"
```

## Introduction
OpenManus is an open-source AI agent framework that provides a complete toolkit for building autonomous agents. It emerged as a community response to closed-source agent platforms, offering browser automation, code execution, file management, and multi-step planning capabilities out of the box.

## What OpenManus Does
- Provides autonomous agents that plan and execute multi-step tasks end-to-end
- Includes browser automation for web research, form filling, and data extraction
- Supports code generation and execution in sandboxed environments
- Handles file system operations including reading, writing, and organizing documents
- Enables multi-agent collaboration where specialized agents work on subtasks in parallel

## Architecture Overview
OpenManus uses a modular agent architecture built on a planning-execution loop. The planner decomposes user requests into subtasks, selects appropriate tools (browser, code executor, file manager), and dispatches them to execution agents. A memory module maintains context across steps, and a reflection mechanism evaluates progress and adjusts plans. The framework supports multiple LLM backends through a unified API layer.

## Self-Hosting & Configuration
- Install via pip with Python 3.9+ and configure LLM provider keys in a TOML config file
- Browser automation requires Playwright; install with the included setup script
- Code execution uses a sandboxed Docker container (optional but recommended for safety)
- Memory persistence stores session context in a local SQLite database
- All components run locally with no mandatory cloud dependencies

## Key Features
- End-to-end task automation from natural language instructions to completed deliverables
- Built-in browser agent with visual understanding for navigating complex web interfaces
- Sandboxed code execution prevents unintended system modifications
- Modular tool system supports adding custom capabilities via a plugin interface
- Multi-agent mode distributes subtasks across specialized agents for faster completion

## Comparison with Similar Tools
- **OpenHands** — AI development platform; OpenManus is a broader general-purpose agent framework
- **AutoGPT** — pioneered autonomous agents; OpenManus offers a more structured and stable architecture
- **Browser Use** — browser automation focused; OpenManus combines browser, code, and file capabilities
- **Goose** — extensible coding agent; OpenManus extends beyond coding to general task automation

## FAQ
**Q: What LLM providers does OpenManus support?**
A: OpenAI, Anthropic, Google, and any OpenAI-compatible API endpoint including local models.

**Q: Is browser automation headless only?**
A: Both headless and headed modes are supported. Headed mode is useful for debugging.

**Q: Can I restrict what the agent can access?**
A: Yes. Tool permissions and file system access are configurable in the config file.

**Q: How does it handle long-running tasks?**
A: The planning module breaks tasks into checkpointed steps with progress persistence.

## Sources
- https://github.com/FoundationAgents/OpenManus

---
Source: https://tokrepo.com/en/workflows/asset-a0cbca19
Author: Script Depot