CAMEL Communicative Agents

What's Changed

• chore: adjust workforce quality check threadhold to 60 by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3839
• chore: fix pre-commit error by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3840
• feat: Interleaved thinking for kimi k2 and glm by @Zephyroam in https://github.com/camel-ai/camel/pull/3737
• feat: support minimax m2.5 and glm5 by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3841
• fix: correct typo 'seperated' to 'separated' by @thecaptain789 in https://github.com/camel-ai/camel/pull/3791
• chore: update contributing guideline and PR template for AI code rule by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3844
• enhance: throw runtime error on absent ffmpeg binary by @a7m-1st in https://github.com/camel-ai/camel/pull/3850
• fix: capture rich output from e2b execution results by @yaowubarbara in https://github.com/camel-ai/camel/pull/3847
• feat: add skill filter by @fengju0213 in https://github.com/camel-ai/camel/pull/3843
• fix: mistral and sambanova model tool calling by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3862
• chore : Update skill prompt in workforce by @fengju0213 in https://github.com/camel-ai/camel/pull/3856
• fix: ffmpg dependency issue in cicd test by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3865
• refactor: model log system include tool schema and support multi-ling… by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3866
• fix: anthropic max_tokens limitation by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3874
• feat(oceanbase): add advanced ANN query options (#3649) by @YixinZ-NUS in https://github.com/camel-ai/camel/pull/3758
• Bump pyobvector version to 0.2.22 by @zhangjiongai-debug in https://github.com/camel-ai/camel/pull/3757
• Add Eigent as first ecosystem highlight by @Copilot in https://github.com/camel-ai/camel/pull/3798
• feat: add Avian as a new LLM provider by @avianion in https://github.com/camel-ai/camel/pull/3881
• fix: fix function param type by @Benjmmi in https://github.com/camel-ai/camel/pull/3499
• feat:add_request_level_token_callback by @fengju0213 in https://github.com/camel-ai/camel/pull/3872
• release: v0.2.90a5 by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3896
• chore: remove default 180s timeout threshold by @nitpicker55555 in https://github.com/camel-ai/camel/pull/3898
• feat: add headless browser search toolkit & enhance browser stealth by @nitpicker55555 in https://github.com/camel-ai/camel/pull/3895
• feat: add gemini 3.1 to model enum list by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3903
• feat: support response api by @fengju0213 in https://github.com/camel-ai/camel/pull/3814
• feat: Extend Prompt Caching Support to More Providers by @Zephyroam in https://github.com/camel-ai/camel/pull/3901
• enhance: TerminalToolkit safe-mode sanitization by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3873
• Add gpt-5.4 by @zechengz in https://github.com/camel-ai/camel/pull/3907
• fix: use partition_html for URL parsing in UnstructuredIO by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3908
• fix: add botocore to mypy ignore list by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3909
• feat(workforce): unify streaming response handling and callback integration by @coolbeevip in https://github.com/camel-ai/camel/pull/3744
• fix(commons): use correct env var for API key URL in api_keys_required error by @jnMetaCode in https://github.com/camel-ai/camel/pull/3913
• fix(github_toolkit): pass repo_name in recursive github_get_all_file_paths call by @jnMetaCode in https://github.com/camel-ai/camel/pull/3912
• chore: fix pre commit issue by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3926
• chore: update qianfan_model schema by @fengju0213 in https://github.com/camel-ai/camel/pull/3925
• feat: auto-coerce dict args to Pydantic models in FunctionTool by @Wendong-Fan in https://github.com/camel-ai/camel/pull/3916
• Async

<div align="center">

<a href="https://www.camel-ai.org/">

<img src="docs/images/banner.png" alt="Banner">

</a>

</div>

</br>

<div align="center">

[![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]

[![Hugging Face][huggingface-image]][huggingface-url]

[![Star][star-image]][star-url]

[![Package License][package-license-image]][package-license-url]

[![PyPI Download][package-download-image]][package-download-url]

[![][join-us-image]][join-us]

<a href="https://trendshift.io/repositories/649" target="_blank"><img src="https://trendshift.io/api/badge/repositories/649" alt="camel-ai/camel | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

English |

简体中文 |

日本語

</div>

<hr>

<div align="center">

<h4 align="center">

Community |

Installation |

Examples |

Paper |

Citation |

Contributing |

CAMEL-AI

</h4>

<p style="line-height: 1.5; text-align: center;"> 🐫 CAMEL is an open-source community dedicated to finding the scaling laws of agents. We believe that studying these agents on a large scale offers valuable insights into their behaviors, capabilities, and potential risks. To facilitate research in this field, we implement and support various types of agents, tasks, prompts, models, and simulated environments.</p>

<br>

Join us (Discord or WeChat) in pushing the boundaries of finding the scaling laws of agents.

🌟 Star CAMEL on GitHub and be instantly notified of new releases.

</div>

<div align="center">

<img src="docs/images/stars.gif" alt="Star">

</a>

</div>

<br>

[![][image-join-us]][join-us]

<details>

<summary><kbd>Table of contents</kbd></summary>

<br/>

• CAMEL Framework Design Principles
• Why Use CAMEL for Your Research?
• What Can You Build With CAMEL?
• Data Generation
• Task Automation
• World Simulation
• Quick Start
• Starting with ChatAgent
• Seeking Help
• Tech Stack
• Research
• Synthetic Datasets
• Cookbooks (Usecases)
• Basic Concepts
• Advanced Features
• Model Training & Data Generation
• Multi-Agent Systems & Applications
• Data Processing
• Real-World Usecases
• 🧱 Built with CAMEL (Real-world Producs & Research)
• Research Projects
• Product Projects
• 🗓️ Events
• Contributing to CAMEL
• Community & Contact
• Citation
• Acknowledgment
• License

####

<br/>

</details>

CAMEL Framework Design Principles

<h3>🧬 Evolvability</h3 >

The framework enables multi-agent systems to continuously evolve by generating data and interacting with environments. This evolution can be driven by reinforcement learning with verifiable rewards or supervised learning.

<h3>📈 Scalability</h3>

The framework is designed to support systems with millions of agents, ensuring efficient coordination, communication, and resource management at scale.

<h3>💾 Statefulness</h3>

Agents maintain stateful memory, enabling them to perform multi-step interactions with environments and efficiently tackle sophisticated tasks.

<h3>📖 Code-as-Prompt</h3>

Every line of code and comment serves as a prompt for agents. Code should be written clearly and readably, ensuring both humans and agents can interpret it effectively.

<br>

Why Use CAMEL for Your Research?

We are a community-driven research collective comprising over 100 researchers dedicated to advancing frontier research in Multi-Agent Systems. Researchers worldwide choose CAMEL for their studies based on the following reasons.

<table style="width: 100%;">

<tr>

<td align="left"></td>

<td align="left"></td>

<td align="left"></td>

</tr>

<tr>

<td align="left">✅</td>

<td align="left" style="font-weight: bold;">Large-Scale Agent System</td>

<td align="left">Simulate up to 1M agents to study emergent behaviors and scaling laws in complex, multi-agent environments.</td>

</tr>

<tr>

<td align="left">✅</td>

<td align="left" style="font-weight: bold;">Dynamic Communication</td>

<td align="left">Enable real-time interactions among agents, fostering seamless collaboration for tackling intricate tasks.</td>

</tr>

<tr>

<td align="left">✅</td>

<td align="left" style="font-weight: bold;">Stateful Memory</td>

<td align="left">Equip agents with the ability to retain and leverage historical context, improving decision-making over extended interactions.</td>

</tr>

<tr>

<td align="left">✅</td>

<td align="left" style="font-weight: bold;">Support for Multiple Benchmarks</td>

<td align="left">Utilize standardized benchmarks to rigorously evaluate agent performance, ensuring reproducibility and reliable comparisons.</td>

</tr>

<tr>

<td align="left">✅</td>

<td align="left" style="font-weight: bold;">Support for Different Agent Types</td>

<td align="left">Work with a variety of agent roles, tasks, models, and environments, supporting interdisciplinary experiments and diverse research applications.</td>

</tr>

<tr>

<td align="left">✅</td>

<td align="left" style="font-weight: bold;">Data Generation and Tool Integration</td>

<td align="left">Automate the creation of large-scale, structured datasets while seamlessly integrating with multiple tools, streamlining synthetic data generation and research workflows.</td>

</tr>

</table>

<br>

What Can You Build With CAMEL?

1. Data Generation

<div align="center">

<a href="https://github.com/camel-ai/camel/blob/master/camel/datagen/cot_datagen.py">

<img src="docs/images/cot.png" alt="CoT Data Generation">

</a>

</div>

<div align="center">

<a href="https://github.com/camel-ai/camel/tree/master/camel/datagen/self_instruct">

<img src="docs/images/self_instruct.png" alt="Self-Instruct Data Generation">

</a>

</div>

<div align="center">

<a href="https://github.com/camel-ai/camel/tree/master/camel/datagen/source2synth">

<img src="docs/images/source2synth.png" alt="Source2Synth Data Generation">

</a>

</div>

<div align="center">

<a href="https://github.com/camel-ai/camel/blob/master/camel/datagen/self_improving_cot.py">

<img src="docs/images/self_improving.png" alt="Self-Improving Data Generation">

</a>

</div>

2. Task Automation

<div align="center">

<a href="https://github.com/camel-ai/camel/blob/master/camel/societies/role_playing.py">

<img src="docs/images/role_playing.png" alt="Role Playing">

</a>

</div>

<div align="center">

<a href="https://github.com/camel-ai/camel/tree/master/camel/societies/workforce">

<img src="docs/images/workforce.png" alt="Workforce">

</a>

</div>

<div align="center">

<a href="https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_rag">

<img src="docs/images/rag_pipeline.png" alt="RAG Pipeline">

</a>

</div>

3. World Simulation

<div align="center">

<a href="https://github.com/camel-ai/oasis">

<img src="docs/images/oasis_case.png" alt="Oasis Case">

</a>

</div>

<br>

Quick Start

Installing CAMEL is a breeze thanks to its availability on PyPI. Simply open your terminal and run:

pip install camel-ai

Starting with ChatAgent

This example demonstrates how to create a ChatAgent using the CAMEL framework and perform a search query using DuckDuckGo.

1. Install the tools package:

  pip install 'camel-ai[web_tools]'

1. Set up your OpenAI API key:

  export OPENAI_API_KEY='your_openai_api_key'

Alternatively, use a .env file:

   cp .env.example .env
   # then edit .env and add your keys

1. Run the following Python code:

  from camel.models import ModelFactory
  from camel.types import ModelPlatformType, ModelType
  from camel.agents import ChatAgent
  from camel.toolkits import SearchToolkit

  model = ModelFactory.create(
    model_platform=ModelPlatformType.OPENAI,
    model_type=ModelType.GPT_4O,
    model_config_dict={"temperature": 0.0},
  )

  search_tool = SearchToolkit().search_duckduckgo

  agent = ChatAgent(model=model, tools=[search_tool])

  response_1 = agent.step("What is CAMEL-AI?")
  print(response_1.msgs[0].content)
  # CAMEL-AI is the first LLM (Large Language Model) multi-agent framework
  # and an open-source community focused on finding the scaling laws of agents.
  # ...

  response_2 = agent.step("What is the Github link to CAMEL framework?")
  print(response_2.msgs[0].content)
  # The GitHub link to the CAMEL framework is
  # [https://github.com/camel-ai/camel](https://github.com/camel-ai/camel).

1. (Optional) Enable model request/response logs:

  export CAMEL_MODEL_LOG_ENABLED=true
  export CAMEL_MODEL_LOG_MODEL_CONFIG_ENABLED=true
  export CAMEL_LOG_DIR=camel_logs

• CAMEL_MODEL_LOG_ENABLED: Enables request/response JSON logs.
• CAMEL_MODEL_LOG_MODEL_CONFIG_ENABLED: Controls whether

model_config_dict is logged under request.model_config_dict.

When unset, it defaults to the same value as

CAMEL_MODEL_LOG_ENABLED.

• CAMEL_LOG_DIR: Directory for generated log files

(default: camel_logs).

• Logs are written as UTF-8 JSON with multilingual text preserved

(for example Chinese, Japanese, Arabic) without Unicode escape noise.

For more detailed instructions and additional configuration options, check out the installation section.

After running, you can explore our CAMEL Tech Stack and Cookbooks at docs.camel-ai.org to build powerful multi-agent systems.

We provide a Google Colab demo showcasing a conversation between two ChatGPT agents playing roles as a python programmer and a stock trader collaborating on developing a trading bot for stock market.

Explore different types of agents, their roles, and their applications.

• Creating Your First Agent
• Creating Your First Agent Society
• Critic Agents

Seeking Help

Please reach out to us on CAMEL discord if you encounter any issue set up CAMEL.

<br>

Tech Stack

<div align="center">

<a href="https://docs.camel-ai.org">

<img src="https://camel-ai.github.io/camel_asset/graphics/techstack.png" alt="TechStack">

</a>

</div>

Key Modules

Core components and utilities to build, operate, and enhance CAMEL-AI agents and societies.

| Module | Description |

|:---|:---|

| Agents | Core agent architectures and behaviors for autonomous operation. |

| Agent Societies | Components for building and managing multi-agent systems and collaboration. |

| Data Generation | Tools and methods for synthetic data creation and augmentation. |

| Models | Model architectures and customization options for agent intelligence. |

| Tools | Tools integration for specialized agent tasks. |

| Memory | Memory storage and retrieval mechanisms for agent state management. |

| Storage | Persistent storage solutions for agent data and states. |

| Benchmarks | Performance evaluation and testing frameworks. |

| Interpreters | Code and command interpretation capabilities. |

| Data Loaders | Data ingestion and preprocessing tools. |

| Retrievers | Knowledge retrieval and RAG components. |

| Runtime | Execution environment and process management. |

| Human-in-the-Loop | Interactive components for human oversight and intervention. |

---

Research

We believe that studying these agents on a large scale offers valuable insights into their behaviors, capabilities, and potential risks.

Explore our research projects:

<div align="center">

<a href="https://github.com/camel-ai/owl">

<img src="docs/images/owl.png" alt="OWL">