๐ฆ OWL: Optimized Workforce Learning for General Multi-Agent Assistance in Real-World Task Automation
[![Documentation][docs-image]][docs-url]
[![Discord][discord-image]][discord-url]
[![X][x-image]][x-url]
[![Reddit][reddit-image]][reddit-url]
[![Wechat][wechat-image]][wechat-url]
[![Wechat][owl-image]][owl-url]
[![Hugging Face][huggingface-image]][huggingface-url]
[![Star][star-image]][star-url]
[![Package License][package-license-image]][package-license-url]
[Community](https://github.com/camel-ai/camel#community) |
[Installation](https://github.com/camel-ai/camel#installation) |
[Examples](https://github.com/camel-ai/camel/tree/HEAD/examples) |
[Paper](https://arxiv.org/abs/2303.17760) |
[Citation](https://github.com/camel-ai/camel#citation) |
[Contributing](https://github.com/camel-ai/camel#contributing-to-camel-) |
[CAMEL-AI](https://www.camel-ai.org/)
๐ฆ OWL is a cutting-edge framework for multi-agent collaboration that pushes the boundaries of task automation, built on top of the [CAMEL-AI Framework](https://github.com/camel-ai/camel).
OWL achieves **58.18** average score on GAIA benchmark and ranks ๐
๏ธ #1 among open-source frameworks.
Our vision is to revolutionize how AI agents collaborate to solve real-world tasks. By leveraging dynamic agent interactions, OWL enables more natural, efficient, and robust task automation across diverse domains.
# ๐ฅ News
- **[2025.03.07]**: We open-source the codebase of ๐ฆ OWL project.
# ๐ ๏ธ Installation
## **Clone the Github repository**
```bash
git clone https://github.com/camel-ai/owl.git
cd owl
```
## **Set up Environment**
Using Conda (recommended):
```bash
conda create -n owl python=3.11
conda activate owl
```
Using venv (alternative):
```bash
python -m venv owl_env
# On Windows
owl_env\Scripts\activate
# On Unix or MacOS
source owl_env/bin/activate
```
## **Install Dependencies**
```bash
python -m pip install -r requirements.txt
```
## **Setup Environment Variables**
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.
# ๐ Quick Start
Run the following minimal example:
```bash
python owl/run.py
```
# ๐งช Experiments
We provided a script to reproduce the results on GAIA.
You can check the `run_gaia_roleplaying.py` file and run the following command:
```bash
python run_gaia_roleplaying.py
```
# โฑ๏ธ Future Plans
- [ ] 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