English | 简体中文

OpenManus AI

Versatile AI agent framework with modular capabilities

機能一覧

基本機能

• AI による会話応答
• ツール使用（ウェブ検索、コード実行など）
• タスク管理
• 自己学習と改善

高度なエージェント機能

• ゴールベースの行動計画と実行
• 複雑なタスクの分割と管理
• 自己モニタリングとデバッグ
• マルチエージェント協調

システム機能

• 複数の LLM プロバイダ対応（OpenAI, Gemini, Claude, Groq Llama, Groq DeepSeek）
• モジュラー設計によるプラグイン追加の容易さ
• 堅牢なエラー処理とリトライメカニズム
• ステートフルな会話履歴管理

会話コンテキスト管理機能

• 各AIモデルのコンテキストウィンドウサイズに基づくトークン管理
• 会話スレッドごとのトークン使用量の監視と表示
• コンテキストウィンドウが上限に近づいた際の警告表示
• コンテキストウィンドウがいっぱいになった場合の新スレッド提案
• 複数スレッドの並行管理とスレッド間の切り替え
• トークン数計測によるモデル制限内での会話管理
• スレッド単位でのプロバイダー切り替え対応

使い方

設定

.env.local ファイルを作成し、必要な API キーを設定してください。

# API Keys
OPENAI_API_KEY=your_openai_api_key
GEMINI_API_KEY=your_gemini_api_key
CLAUDE_API_KEY=your_claude_api_key
GROQ_API_KEY=your_groq_api_key

# プロバイダー選択
AI_PROVIDER=openai  # gemini, claude, groq_llama, groq_deepseek のいずれかを選択

起動

python main.py

コントリビューション

プルリクエストやイシューは歓迎します。大きな変更を加える前には、まずイシューを作成して議論しましょう。

ライセンス

MIT

Project Demo

seo_website.mp4

Installation

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

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

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

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

After comprehensively gathering feedback from community members, we have decided to adopt a 3-4 day iteration cycle to gradually implement the highly anticipated features.

• Enhance Planning capabilities, optimize task breakdown and execution logic
• Introduce standardized evaluation metrics (based on GAIA and TAU-Bench) for continuous performance assessment and optimization
• Expand model adaptation and optimize low-cost application scenarios
• Implement containerized deployment to simplify installation and usage workflows
• Enrich example libraries with more practical cases, including analysis of both successful and failed examples
• Frontend/backend development to improve user experience
• RAG enhancement: Implement external knowledge graph retrieval and fusion mechanisms

Community Group

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

Star History

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!