{"id":13437512,"url":"https://github.com/camel-ai/camel","last_synced_at":"2026-02-13T00:24:53.411Z","repository":{"id":149990025,"uuid":"615510678","full_name":"camel-ai/camel","owner":"camel-ai","description":"🐫 CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org","archived":false,"fork":false,"pushed_at":"2025-05-07T19:50:31.000Z","size":310237,"stargazers_count":12327,"open_issues_count":478,"forks_count":1300,"subscribers_count":106,"default_branch":"master","last_synced_at":"2025-05-07T20:28:31.541Z","etag":null,"topics":["agent","ai-societies","artificial-intelligence","communicative-ai","cooperative-ai","deep-learning","large-language-models","multi-agent-systems","natural-language-processing"],"latest_commit_sha":null,"homepage":"https://docs.camel-ai.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/camel-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-03-17T21:41:54.000Z","updated_at":"2025-05-07T19:45:26.000Z","dependencies_parsed_at":"2023-10-03T04:03:07.509Z","dependency_job_id":"ae23bb4e-3fff-49b5-a477-fdb55a36941f","html_url":"https://github.com/camel-ai/camel","commit_stats":null,"previous_names":["camel-ai/camel","lightaime/camel"],"tags_count":96,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camel-ai%2Fcamel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camel-ai%2Fcamel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camel-ai%2Fcamel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camel-ai%2Fcamel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/camel-ai","download_url":"https://codeload.github.com/camel-ai/camel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254227603,"owners_count":22035667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai-societies","artificial-intelligence","communicative-ai","cooperative-ai","deep-learning","large-language-models","multi-agent-systems","natural-language-processing"],"created_at":"2024-07-31T03:00:57.863Z","updated_at":"2026-01-08T16:20:06.809Z","avatar_url":"https://github.com/camel-ai.png","language":"Python","funding_links":[],"categories":["Statistics","[CAMEL](https://github.com/camel-ai/camel)","Python","Platforms \u0026 Frameworks","A01_文本生成_文本对话","Chatbots \u0026 Virtual Companions","Tools","Applications","2024.05","智能体 Agents","🌟 Core Frameworks","Agents","Learning","Orchestration","Frameworks","🔄 Multi-Agent Systems","🧱 Agent Frameworks","Autonomous Agents","Testing Frameworks","AI Agent Frameworks \u0026 SDKs","其他开源","🕵️ 智能体（Agents）","🤖 Agent Technologies for Research","Librerías para usar NLP en español","Orchestration Frameworks","📋 List of Open-Source Projects","📦 Isolate Context","AI Agents \u0026 Orchestration","Agent Frameworks (fully local) (25)","🤖 AI \u0026 Machine Learning","2. Libraries \u0026 Frameworks","Table of Contents","Frameworks \u0026 Libraries","Practitioner Reports, Methodology Essays, and Agent Frameworks","Open-source Projects","4. Agentic AI \u0026 Multi-Agent Systems","Agentic Systems"],"sub_categories":["Links","Cloud-native Agent Platforms \u0026 Managed Stacks","大语言对话模型及数据","Agent Frameworks","Agent Society Simulation","Camel-GraphRAG【左右开弓】","Repositories","Agent Framework","Development Platforms","Multi-Agent Orchestration","Open Source Frameworks","Multi-Agent Collaboration Systems","2. **🦉 [Camel-Owl](https://github.com/camel-ai/owl)**","主流 Agent 框架","🤖 General-Purpose AI Agents","Modelos de Embeddings para Sentence Similarity y Semantic Search","Agents","Multi-Agent Frameworks","Python","8. Other Frameworks \u003ca name=\"otherframeworks\"\u003e\u003c/a\u003e"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://www.camel-ai.org/\"\u003e\n    \u003cimg src=\"docs/images/banner.png\" alt=\"Banner\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003c/br\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Documentation][docs-image]][docs-url]\n[![Discord][discord-image]][discord-url]\n[![X][x-image]][x-url]\n[![Reddit][reddit-image]][reddit-url]\n[![Wechat][wechat-image]][wechat-url]\n[![Hugging Face][huggingface-image]][huggingface-url]\n[![Star][star-image]][star-url]\n[![Package License][package-license-image]][package-license-url]\n[![PyPI Download][package-download-image]][package-download-url]\n\n\u003ca href=\"https://trendshift.io/repositories/649\" target=\"_blank\"\u003e\u003cimg src=\"https://trendshift.io/api/badge/repositories/649\" alt=\"camel-ai/camel | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"/\u003e\u003c/a\u003e\n\n\u003c/div\u003e\n\n\n\u003chr\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003ch4 align=\"center\"\u003e\n\n[Community](https://github.com/camel-ai/camel#community) |\n[Installation](https://github.com/camel-ai/camel#installation) |\n[Examples](https://github.com/camel-ai/camel/tree/HEAD/examples) |\n[Paper](https://arxiv.org/abs/2303.17760) |\n[Citation](https://github.com/camel-ai/camel#citation) |\n[Contributing](https://github.com/camel-ai/camel#contributing-to-camel-) |\n[CAMEL-AI](https://www.camel-ai.org/)\n\n\u003c/h4\u003e\n\n\u003cp style=\"line-height: 1.5; text-align: center;\"\u003e 🐫 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.\u003c/p\u003e\n\n\n\u003cbr\u003e\n\n\nJoin us ([*Discord*](https://discord.camel-ai.org/) or [*WeChat*](https://ghli.org/camel/wechat.png)) in pushing the boundaries of finding the scaling laws of agents. \n\n🌟 Star CAMEL on GitHub and be instantly notified of new releases.\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"docs/images/star.gif\" alt=\"Star\" width=\"186\" height=\"60\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\n## CAMEL Framework Design Principles\n\n\u003ch3\u003e🧬 Evolvability\u003c/h3 \u003e\n\nThe 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.\n\n\u003ch3\u003e📈 Scalability\u003c/h3\u003e\n\nThe framework is designed to support systems with millions of agents, ensuring efficient coordination, communication, and resource management at scale.\n\n\u003ch3\u003e💾 Statefulness\u003c/h3\u003e\n\nAgents maintain stateful memory, enabling them to perform multi-step interactions with environments and efficiently tackle sophisticated tasks.\n\n\u003ch3\u003e📖 Code-as-Prompt\u003c/h3\u003e\n\nEvery 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.\n\n\u003cbr\u003e\n\n## Why Use CAMEL for Your Research?\n\nWe 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.\n\n\u003ctable style=\"width: 100%;\"\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"left\"\u003e\u003c/td\u003e\n    \u003ctd align=\"left\"\u003e\u003c/td\u003e\n    \u003ctd align=\"left\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"left\"\u003e✅\u003c/td\u003e\n    \u003ctd align=\"left\" style=\"font-weight: bold;\"\u003eLarge-Scale Agent System\u003c/td\u003e\n    \u003ctd align=\"left\"\u003eSimulate up to 1M agents to study emergent behaviors and scaling laws in complex, multi-agent environments.\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"left\"\u003e✅\u003c/td\u003e\n    \u003ctd align=\"left\" style=\"font-weight: bold;\"\u003eDynamic Communication\u003c/td\u003e\n    \u003ctd align=\"left\"\u003eEnable real-time interactions among agents, fostering seamless collaboration for tackling intricate tasks.\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"left\"\u003e✅\u003c/td\u003e\n    \u003ctd align=\"left\" style=\"font-weight: bold;\"\u003eStateful Memory\u003c/td\u003e\n    \u003ctd align=\"left\"\u003eEquip agents with the ability to retain and leverage historical context, improving decision-making over extended interactions.\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"left\"\u003e✅\u003c/td\u003e\n    \u003ctd align=\"left\" style=\"font-weight: bold;\"\u003eSupport for Multiple Benchmarks\u003c/td\u003e\n    \u003ctd align=\"left\"\u003eUtilize standardized benchmarks to rigorously evaluate agent performance, ensuring reproducibility and reliable comparisons.\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"left\"\u003e✅\u003c/td\u003e\n    \u003ctd align=\"left\" style=\"font-weight: bold;\"\u003eSupport for Different Agent Types\u003c/td\u003e\n    \u003ctd align=\"left\"\u003eWork with a variety of agent roles, tasks, models, and environments, supporting interdisciplinary experiments and diverse research applications.\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"left\"\u003e✅\u003c/td\u003e\n    \u003ctd align=\"left\" style=\"font-weight: bold;\"\u003eData Generation and Tool Integration\u003c/td\u003e\n    \u003ctd align=\"left\"\u003eAutomate the creation of large-scale, structured datasets while seamlessly integrating with multiple tools, streamlining synthetic data generation and research workflows.\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003cbr\u003e\n\n## What Can You Build With CAMEL?\n\n\n### 1. Data Generation\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/camel-ai/camel/blob/master/camel/datagen/cot_datagen.py\"\u003e\n    \u003cimg src=\"docs/images/cot.png\" alt=\"CoT Data Generation\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/camel-ai/camel/tree/master/camel/datagen/self_instruct\"\u003e\n    \u003cimg src=\"docs/images/self_instruct.png\" alt=\"Self-Instruct Data Generation\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/camel-ai/camel/tree/master/camel/datagen/source2synth\"\u003e\n    \u003cimg src=\"docs/images/source2synth.png\" alt=\"Source2Synth Data Generation\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/camel-ai/camel/blob/master/camel/datagen/self_improving_cot.py\"\u003e\n    \u003cimg src=\"docs/images/self_improving.png\" alt=\"Self-Improving Data Generation\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n### 2. Task Automation\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/camel-ai/camel/blob/master/camel/societies/role_playing.py\"\u003e\n    \u003cimg src=\"docs/images/role_playing.png\" alt=\"Role Playing\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/camel-ai/camel/tree/master/camel/societies/workforce\"\u003e\n    \u003cimg src=\"docs/images/workforce.png\" alt=\"Workforce\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_rag.html\"\u003e\n    \u003cimg src=\"docs/images/rag_pipeline.png\" alt=\"RAG Pipeline\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\n### 3. World Simulation\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/camel-ai/oasis\"\u003e\n    \u003cimg src=\"docs/images/oasis_case.png\" alt=\"Oasis Case\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n## Quick Start\n\nInstalling CAMEL is a breeze thanks to its availability on PyPI. Simply open your terminal and run:\n\n```bash\npip install camel-ai\n```\n\n### Starting with ChatAgent\n\nThis example demonstrates how to create a `ChatAgent` using the CAMEL framework and perform a search query using DuckDuckGo.\n\n1. **Install the tools package:**\n\n  ```bash\n  pip install 'camel-ai[web_tools]'\n  ```\n\n2. **Set up your OpenAI API key:**\n\n  ```bash\n  export OPENAI_API_KEY='your_openai_api_key'\n  ```\n\n3. **Run the following Python code:**\n\n  ```python\n  from camel.models import ModelFactory\n  from camel.types import ModelPlatformType, ModelType\n  from camel.agents import ChatAgent\n  from camel.toolkits import SearchToolkit\n\n  model = ModelFactory.create(\n    model_platform=ModelPlatformType.OPENAI,\n    model_type=ModelType.GPT_4O,\n    model_config_dict={\"temperature\": 0.0},\n  )\n\n  search_tool = SearchToolkit().search_duckduckgo\n\n  agent = ChatAgent(model=model, tools=[search_tool])\n\n  response_1 = agent.step(\"What is CAMEL-AI?\")\n  print(response_1.msgs[0].content)\n  # CAMEL-AI is the first LLM (Large Language Model) multi-agent framework\n  # and an open-source community focused on finding the scaling laws of agents.\n  # ...\n\n  response_2 = agent.step(\"What is the Github link to CAMEL framework?\")\n  print(response_2.msgs[0].content)\n  # The GitHub link to the CAMEL framework is\n  # [https://github.com/camel-ai/camel](https://github.com/camel-ai/camel).\n  ```\n\n\nFor more detailed instructions and additional configuration options, check out the [installation section](https://github.com/camel-ai/camel/blob/master/docs/get_started/installation.md).\n\nAfter running, you can explore our CAMEL Tech Stack and Cookbooks at [docs.camel-ai.org](https://docs.camel-ai.org) to build powerful multi-agent systems.\n\nWe provide a [![Google Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1AzP33O8rnMW__7ocWJhVBXjKziJXPtim?usp=sharing) 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.\n\nExplore different types of agents, their roles, and their applications.\n\n- **[Creating Your First Agent](https://docs.camel-ai.org/cookbooks/basic_concepts/create_your_first_agent.html)**\n- **[Creating Your First Agent Society](https://docs.camel-ai.org/cookbooks/basic_concepts/create_your_first_agents_society.html)**\n- **[Embodied Agents](https://docs.camel-ai.org/cookbooks/advanced_features/embodied_agents.html)**\n- **[Critic Agents](https://docs.camel-ai.org/cookbooks/advanced_features/critic_agents_and_tree_search.html)**\n\n### Seeking Help\n\nPlease reach out to us on [CAMEL discord](https://discord.camel-ai.org/) if you encounter any issue set up CAMEL.\n\n\u003cbr\u003e\n\n## Tech Stack\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://docs.camel-ai.org\"\u003e\n    \u003cimg src=\"docs/images/techstack.png\" alt=\"TechStack\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n### Key Modules\nCore components and utilities to build, operate, and enhance CAMEL-AI agents and societies.\n\n| Module | Description |\n|:---|:---|\n| **[Agents](https://docs.camel-ai.org/key_modules/agents.html)** | Core agent architectures and behaviors for autonomous operation. |\n| **[Agent Societies](https://docs.camel-ai.org/key_modules/society.html)** | Components for building and managing multi-agent systems and collaboration. |\n| **[Data Generation](https://docs.camel-ai.org/key_modules/datagen.html)** | Tools and methods for synthetic data creation and augmentation. |\n| **[Models](https://docs.camel-ai.org/key_modules/models.html)** | Model architectures and customization options for agent intelligence. |\n| **[Tools](https://docs.camel-ai.org/key_modules/tools.html)** | Tools integration for specialized agent tasks. |\n| **[Memory](https://docs.camel-ai.org/key_modules/memory.html)** | Memory storage and retrieval mechanisms for agent state management. |\n| **[Storage](https://docs.camel-ai.org/key_modules/storages.html)** | Persistent storage solutions for agent data and states. |\n| **[Benchmarks](https://github.com/camel-ai/camel/tree/master/camel/benchmarks)** | Performance evaluation and testing frameworks. |\n| **[Interpreters](https://docs.camel-ai.org/key_modules/interpreters.html)** | Code and command interpretation capabilities. |\n| **[Data Loaders](https://docs.camel-ai.org/key_modules/loaders.html)** | Data ingestion and preprocessing tools. |\n| **[Retrievers](https://docs.camel-ai.org/key_modules/retrievers.html)** | Knowledge retrieval and RAG components. |\n| **[Runtime](https://github.com/camel-ai/camel/tree/master/camel/runtime)** | Execution environment and process management. |\n| **[Human-in-the-Loop](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_human_in_loop_and_tool_approval.html)** | Interactive components for human oversight and intervention. |\n---\n\n## Research\n\nWe believe that studying these agents on a large scale offers valuable insights into their behaviors, capabilities, and potential risks.\n\n**Explore our research projects:**\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://crab.camel-ai.org/\"\u003e\n    \u003cimg src=\"docs/images/crab.png\" alt=\"CRAB\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://agent-trust.camel-ai.org/\"\u003e\n    \u003cimg src=\"docs/images/agent_trust.png\" alt=\"Agent Trust\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://oasis.camel-ai.org/\"\u003e\n    \u003cimg src=\"docs/images/oasis.png\" alt=\"OASIS\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://emos-project.github.io/\"\u003e\n    \u003cimg src=\"docs/images/emos.png\" alt=\"Emos\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003e### Research with US\n\u003e\n\u003eWe warmly invite you to use CAMEL for your impactful research. \n\u003e\n\u003e Rigorous research takes time and resources. We are a community-driven research collective with 100+ researchers exploring the frontier research of Multi-agent Systems. Join our ongoing projects or test new ideas with us, [reach out via email](mailto:camel-ai@eigent.ai) for more information.\n\u003e\n\u003e\u003cdiv align=\"center\"\u003e\n\u003e    \u003cimg src=\"docs/images/partners.png\" alt=\"Partners\"\u003e\n\u003e\u003c/div\u003e\n\n\u003cbr\u003e\n\n## Synthetic Datasets\n\n### 1. Utilize Various LLMs as Backends\n\nFor more details, please see our [`Models Documentation`](https://docs.camel-ai.org/key_modules/models.html#).\n\n\u003e **Data (Hosted on Hugging Face)**\n\n| Dataset        | Chat format                                                                                         | Instruction format                                                                                               | Chat format (translated)                                                                   |\n|----------------|-----------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| **AI Society** | [Chat format](https://huggingface.co/datasets/camel-ai/ai_society/blob/main/ai_society_chat.tar.gz) | [Instruction format](https://huggingface.co/datasets/camel-ai/ai_society/blob/main/ai_society_instructions.json) | [Chat format (translated)](https://huggingface.co/datasets/camel-ai/ai_society_translated) |\n| **Code**       | [Chat format](https://huggingface.co/datasets/camel-ai/code/blob/main/code_chat.tar.gz)             | [Instruction format](https://huggingface.co/datasets/camel-ai/code/blob/main/code_instructions.json)             | x                                                                                          |\n| **Math**       | [Chat format](https://huggingface.co/datasets/camel-ai/math)                                        | x                                                                                                                | x                                                                                          |\n| **Physics**    | [Chat format](https://huggingface.co/datasets/camel-ai/physics)                                     | x                                                                                                                | x                                                                                          |\n| **Chemistry**  | [Chat format](https://huggingface.co/datasets/camel-ai/chemistry)                                   | x                                                                                                                | x                                                                                          |\n| **Biology**    | [Chat format](https://huggingface.co/datasets/camel-ai/biology)                                     | x                                                                                                                | x                                                                                          |\n\n### 2. Visualizations of Instructions and Tasks\n\n| Dataset          | Instructions                                                                                                         | Tasks                                                                                                         |\n|------------------|----------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------|\n| **AI Society**   | [Instructions](https://atlas.nomic.ai/map/3a559a06-87d0-4476-a879-962656242452/db961915-b254-48e8-8e5c-917f827b74c6) | [Tasks](https://atlas.nomic.ai/map/cb96f41b-a6fd-4fe4-ac40-08e101714483/ae06156c-a572-46e9-8345-ebe18586d02b) |\n| **Code**         | [Instructions](https://atlas.nomic.ai/map/902d6ccb-0bbb-4294-83a8-1c7d2dae03c8/ace2e146-e49f-41db-a1f4-25a2c4be2457) | [Tasks](https://atlas.nomic.ai/map/efc38617-9180-490a-8630-43a05b35d22d/2576addf-a133-45d5-89a9-6b067b6652dd) |\n| **Misalignment** | [Instructions](https://atlas.nomic.ai/map/5c491035-a26e-4a05-9593-82ffb2c3ab40/2bd98896-894e-4807-9ed8-a203ccb14d5e) | [Tasks](https://atlas.nomic.ai/map/abc357dd-9c04-4913-9541-63e259d7ac1f/825139a4-af66-427c-9d0e-f36b5492ab3f) |\n\n\u003cbr\u003e\n\n## Cookbooks (Usecases)\nPractical guides and tutorials for implementing specific functionalities in CAMEL-AI agents and societies.\n\n### 1. Basic Concepts\n| Cookbook | Description |\n|:---|:---|\n| **[Creating Your First Agent](https://docs.camel-ai.org/cookbooks/basic_concepts/create_your_first_agent.html)** | A step-by-step guide to building your first agent. |\n| **[Creating Your First Agent Society](https://docs.camel-ai.org/cookbooks/basic_concepts/create_your_first_agents_society.html)** | Learn to build a collaborative society of agents. |\n| **[Message Cookbook](https://docs.camel-ai.org/cookbooks/basic_concepts/agents_message.html)** | Best practices for message handling in agents. |\n\n### 2. Advanced Features\n| Cookbook | Description |\n|:---|:---|\n| **[Tools Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_tools.html)** | Integrating tools for enhanced functionality. |\n| **[Memory Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_memory.html)** | Implementing memory systems in agents. |\n| **[RAG Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_rag.html)** | Recipes for Retrieval-Augmented Generation. |\n| **[Graph RAG Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_graph_rag.html)** | Leveraging knowledge graphs with RAG. |\n| **[Track CAMEL Agents with AgentOps](https://docs.camel-ai.org/cookbooks/advanced_features/agents_tracking.html)** | Tools for tracking and managing agents in operations. |\n\n### 3. Model Training \u0026 Data Generation\n| Cookbook | Description |\n|:---|:---|\n| **[Data Generation with CAMEL and Finetuning with Unsloth](https://docs.camel-ai.org/cookbooks/data_generation/sft_data_generation_and_unsloth_finetuning_Qwen2_5_7B.html)** | Learn how to generate data with CAMEL and fine-tune models effectively with Unsloth. |\n| **[Data Gen with Real Function Calls and Hermes Format](https://docs.camel-ai.org/cookbooks/data_generation/data_gen_with_real_function_calls_and_hermes_format.html)** | Explore how to generate data with real function calls and the Hermes format. |\n| **[CoT Data Generation and Upload Data to Huggingface](https://docs.camel-ai.org/cookbooks/data_generation/distill_math_reasoning_data_from_deepseek_r1.html)** | Uncover how to generate CoT data with CAMEL and seamlessly upload it to Huggingface. |\n| **[CoT Data Generation and SFT Qwen with Unsolth](https://docs.camel-ai.org/cookbooks/data_generation/cot_data_gen_sft_qwen_unsolth_upload_huggingface.html)** | Discover how to generate CoT data using CAMEL and SFT Qwen with Unsolth, and seamlessly upload your data and model to Huggingface. |\n\n### 4. Multi-Agent Systems \u0026 Applications\n| Cookbook | Description |\n|:---|:---|\n| **[Role-Playing Scraper for Report \u0026 Knowledge Graph Generation](https://docs.camel-ai.org/cookbooks/applications/roleplaying_scraper.html)** | Create role-playing agents for data scraping and reporting. |\n| **[Create A Hackathon Judge Committee with Workforce](https://docs.camel-ai.org/cookbooks/multi_agent_society/workforce_judge_committee.html)** | Building a team of agents for collaborative judging. |\n| **[Dynamic Knowledge Graph Role-Playing: Multi-Agent System with dynamic, temporally-aware knowledge graphs](https://docs.camel-ai.org/cookbooks/applications/dyamic_knowledge_graph.html)** |  Builds dynamic, temporally-aware knowledge graphs for financial applications using a multi-agent system. It processes financial reports, news articles, and research papers to help traders analyze data, identify relationships, and uncover market insights. The system also utilizes diverse and optional element node deduplication techniques to ensure data integrity and optimize graph structure for financial decision-making. |\n| **[Customer Service Discord Bot with Agentic RAG](https://docs.camel-ai.org/cookbooks/applications/customer_service_Discord_bot_using_SambaNova_with_agentic_RAG.html)** | Learn how to build a robust customer service bot for Discord using Agentic RAG. |\n| **[Customer Service Discord Bot with Local Model](https://docs.camel-ai.org/cookbooks/applications/customer_service_Discord_bot_using_local_model_with_agentic_RAG.html)** | Learn how to build a robust customer service bot for Discord using Agentic RAG which supports local deployment. |\n\n### 5. Data Processing\n| Cookbook | Description |\n|:---|:---|\n| **[Video Analysis](https://docs.camel-ai.org/cookbooks/data_processing/video_analysis.html)** | Techniques for agents in video data analysis. |\n| **[3 Ways to Ingest Data from Websites with Firecrawl](https://docs.camel-ai.org/cookbooks/data_processing/ingest_data_from_websites_with_Firecrawl.html)** | Explore three methods for extracting and processing data from websites using Firecrawl. |\n| **[Create AI Agents that work with your PDFs](https://docs.camel-ai.org/cookbooks/data_processing/agent_with_chunkr_for_pdf_parsing.html)** | Learn how to create AI agents that work with your PDFs using Chunkr and Mistral AI. |\n\n\n\u003cbr\u003e\n\n\n## Contributing to CAMEL\n\n\u003e For those who'd like to contribute code, we appreciate your interest in contributing to our open-source initiative. Please take a moment to review our [contributing guidelines](https://github.com/camel-ai/camel/blob/master/CONTRIBUTING.md) to get started on a smooth collaboration journey.🚀\n\u003e\n\u003e We also welcome you to help CAMEL grow by sharing it on social media, at events, or during conferences. Your support makes a big difference!\n\n\u003cbr\u003e\n\n## Community \u0026 Contact\nFor more information please contact camel-ai@eigent.ai\n\n- **GitHub Issues:** Report bugs, request features, and track development. [Submit an issue](https://github.com/camel-ai/camel/issues)\n\n- **Discord:** Get real-time support, chat with the community, and stay updated. [Join us](https://discord.camel-ai.org/)\n\n- **X (Twitter):** Follow for updates, AI insights, and key announcements. [Follow us](https://x.com/CamelAIOrg)\n\n- **Ambassador Project:** Advocate for CAMEL-AI, host events, and contribute content. [Learn more](https://www.camel-ai.org/community)\n\n- **WeChat Community:** Scan the QR code below to join our WeChat community.\n\n  \u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"misc/wechat.jpeg\" alt=\"WeChat QR Code\" width=\"200\"\u003e\n  \u003c/div\u003e\n\n\n\u003cbr\u003e\n\n## Citation\n```\n@inproceedings{li2023camel,\n  title={CAMEL: Communicative Agents for \"Mind\" Exploration of Large Language Model Society},\n  author={Li, Guohao and Hammoud, Hasan Abed Al Kader and Itani, Hani and Khizbullin, Dmitrii and Ghanem, Bernard},\n  booktitle={Thirty-seventh Conference on Neural Information Processing Systems},\n  year={2023}\n}\n```\n\n## Acknowledgment\nSpecial thanks to [Nomic AI](https://home.nomic.ai/) for giving us extended access to their data set exploration tool (Atlas).\n\nWe would also like to thank Haya Hammoud for designing the initial logo of our project.\n\nWe implemented amazing research ideas from other works for you to build, compare and customize your agents. If you use any of these modules, please kindly cite the original works:\n- `TaskCreationAgent`, `TaskPrioritizationAgent` and `BabyAGI` from *Nakajima et al.*: [Task-Driven Autonomous Agent](https://yoheinakajima.com/task-driven-autonomous-agent-utilizing-gpt-4-pinecone-and-langchain-for-diverse-applications/). [[Example](https://github.com/camel-ai/camel/blob/master/examples/ai_society/babyagi_playing.py)]\n\n- `PersonaHub` from *Tao Ge et al.*: [Scaling Synthetic Data Creation with 1,000,000,000 Personas](https://arxiv.org/pdf/2406.20094). [[Example](https://github.com/camel-ai/camel/blob/master/examples/personas/personas_generation.py)]\n\n- `Self-Instruct` from *Yizhong Wang et al.*: [SELF-INSTRUCT: Aligning Language Models with Self-Generated Instructions](https://arxiv.org/pdf/2212.10560). [[Example](https://github.com/camel-ai/camel/blob/master/examples/datagen/self_instruct/self_instruct.py)]\n\n\n## License\n\nThe source code is licensed under Apache 2.0.\n\n\u003cbr\u003e\n\n[docs-image]: https://img.shields.io/badge/Documentation-EB3ECC\n[docs-url]: https://camel-ai.github.io/camel/index.html\n[star-image]: https://img.shields.io/github/stars/camel-ai/camel?label=stars\u0026logo=github\u0026color=brightgreen\n[star-url]: https://github.com/camel-ai/camel/stargazers\n[package-license-image]: https://img.shields.io/badge/License-Apache_2.0-blue.svg\n[package-license-url]: https://github.com/camel-ai/camel/blob/master/licenses/LICENSE\n[package-download-image]: https://img.shields.io/pypi/dm/camel-ai\n\n[colab-url]: https://colab.research.google.com/drive/1AzP33O8rnMW__7ocWJhVBXjKziJXPtim?usp=sharing\n[colab-image]: https://colab.research.google.com/assets/colab-badge.svg\n[huggingface-url]: https://huggingface.co/camel-ai\n[huggingface-image]: https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-CAMEL--AI-ffc107?color=ffc107\u0026logoColor=white\n[discord-url]: https://discord.camel-ai.org/\n[discord-image]: https://img.shields.io/discord/1082486657678311454?logo=discord\u0026labelColor=%20%235462eb\u0026logoColor=%20%23f5f5f5\u0026color=%20%235462eb\n[wechat-url]: https://ghli.org/camel/wechat.png\n[wechat-image]: https://img.shields.io/badge/WeChat-CamelAIOrg-brightgreen?logo=wechat\u0026logoColor=white\n[x-url]: https://x.com/CamelAIOrg\n[x-image]: https://img.shields.io/twitter/follow/CamelAIOrg?style=social\n[twitter-image]: https://img.shields.io/twitter/follow/CamelAIOrg?style=social\u0026color=brightgreen\u0026logo=twitter\n[reddit-url]: https://www.reddit.com/r/CamelAI/\n[reddit-image]: https://img.shields.io/reddit/subreddit-subscribers/CamelAI?style=plastic\u0026logo=reddit\u0026label=r%2FCAMEL\u0026labelColor=white\n[ambassador-url]: https://www.camel-ai.org/community\n[package-download-url]: https://pypi.org/project/camel-ai","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcamel-ai%2Fcamel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcamel-ai%2Fcamel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcamel-ai%2Fcamel/lists"}