• 📋 Table of Contents
• 🔥 News
• 🛠️ Installation
  • Clone the Github repository
  • Set up Environment
  • Install Dependencies
  • Setup Environment Variables
• 🚀 Quick Start
• 🧪 Experiments
• ⏱️ Future Plans
• 📄 License
• 🖊️ Cite
• 🔥 Community

• [2025.03.07]: We open-source the codebase of 🦉 OWL project.

git clone https://github.com/camel-ai/owl.git
cd owl

Using Conda (recommended):

conda create -n owl python=3.11
conda activate owl

Using venv (alternative):

python -m venv owl_env
# On Windows
owl_env\Scripts\activate
# On Unix or MacOS
source owl_env/bin/activate

python -m pip install -r requirements.txt

In the owl/.env_example file, you will find all the necessary API keys along with the websites where you can register for each service. To use these API services, follow these steps:

1. Copy and Rename: Duplicate the .env_example file and rename the copy to .env.
2. Fill in Your Keys: Open the .env file and insert your API keys in the corresponding fields.

Run the following minimal example:

python owl/run.py

We provided a script to reproduce the results on GAIA. You can check the run_gaia_roleplaying.py file and run the following command:

python run_gaia_roleplaying.py

• Write a technical blog post detailing our exploration and insights in multi-agent collaboration in real-world tasks.
• Enhance the toolkit ecosystem with more specialized tools for domain-specific tasks.
• Develop more sophisticated agent interaction patterns and communication protocols

The source code is licensed under Apache 2.0.

If you find this repo useful, please cite:

@misc{owl2025,
  title        = {OWL: Optimized Workforce Learning for General Multi-Agent Assistance in Real-World Task Automation},
  author       = {{CAMEL-AI.org}},
  howpublished = {\url{https://github.com/camel-ai/owl}},
  note         = {Accessed: 2025-03-07},
  year         = {2025}
}

Join us for further discussions!