A Python simulator where LLM agents mimic up to one million users on Twitter- and Reddit-like social platforms to study information spread and polarization.
camel-ai/camel
A Python multi-agent framework for building, simulating and studying LLM-based agents, with tools, memory, and data generation support.
- Stars
- 17,939
- Forks
- 2,121
- Open issues
- 545
- Last commit
- 2 days ago
What is it?
CAMEL is a Python framework for building multi-agent systems powered by large language models. It provides building blocks for agents with stateful memory, tool use, and role-based communication, plus agent societies where multiple agents collaborate on tasks. The project is run by an open research community that focuses on studying how agent behavior changes as the number of agents grows.
The framework covers several areas: data generation (such as Chain-of-Thought and Self-Instruct pipelines for synthetic datasets), task automation through role-playing and workforce-style agent teams, and world simulation. Models are created through a factory that supports multiple model platforms, and agents can be given toolkits such as web search.
The library is installable from PyPI as camel-ai, and the project includes documentation, cookbooks and example scripts. It is also the base of related research projects such as OWL and OASIS.
Key features
- 01Agents with stateful memory and tool calling
- 02Multi-agent societies with role-playing and workforce-style collaboration
- 03Synthetic data generation pipelines such as CoT and Self-Instruct
- 04Model factory supporting multiple LLM platforms
- 05Installable from PyPI as camel-ai
Use cases
- Researching the behavior and scaling of large groups of LLM agents
- Generating synthetic instruction or reasoning datasets
- Automating multi-step tasks with a team of collaborating agents
- Building RAG-based agents that answer questions over documents or codebases
Quick start
- 1
Install CAMEL from PyPI
pip install camel-ai - 2
Install the web tools package
pip install 'camel-ai[web_tools]' - 3
Set your OpenAI API key
export OPENAI_API_KEY='your_openai_api_key' - 4
Run the ChatAgent example Python code from the README
Things to know
- The quick start example requires a paid OpenAI API key.
- The README's ChatAgent example depends on an external model provider.
Topics
FAQ
- What is camel?
- A Python multi-agent framework for building, simulating and studying LLM-based agents, with tools, memory, and data generation support. CAMEL is a Python framework for building multi-agent systems powered by large language models. It provides building blocks for agents with stateful memory, tool use, and role-based communication, plus agent societies where multiple agents collaborate on tasks. The project is run by an open research community that focuses on studying how agent behavior changes as the number of agents grows.
- Is camel free to use? What license does it have?
- camel is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is camel still maintained?
- Actively maintained. The last commit to camel was on Oct 19, 2026.
- What can I use camel for?
- Researching the behavior and scaling of large groups of LLM agents Generating synthetic instruction or reasoning datasets Automating multi-step tasks with a team of collaborating agents Building RAG-based agents that answer questions over documents or codebases
- How do I install camel?
- Install CAMEL from PyPI: pip install camel-ai Install the web tools package: pip install 'camel-ai[web_tools]' Set your OpenAI API key: export OPENAI_API_KEY='your_openai_api_key' Run the ChatAgent example Python code from the README
- Where can I get camel?
- The source code and installation instructions are on GitHub: https://github.com/camel-ai/camel
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
An open-source autonomous research agent that plans questions, gathers web and local sources, and writes cited reports with any LLM provider.
Open-source Python framework for building production-ready LLM applications with modular pipelines and agent workflows for RAG, search and agents.
Code-first Python framework from Google for building, evaluating, and deploying AI agents, optimized for Gemini but model-agnostic.
Open-source platform for building AI-powered chat bots that connect LLMs to Slack, Discord, Telegram, WeChat, Lark, DingTalk and more.
Agent-native memory infrastructure that turns LLM agent conversations and execution into persistent, structured memory for Python and TypeScript apps.