camel-ai
v0.2.90 open-sourceCAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org
from camel.toolkits.mcp import PulseMCPSearchToolkit
search_toolkit = PulseMCPSearchToolkit()
results = search_toolkit.search_mcp_servers(query="Slack", top_k=1)
print(results)
from camel.toolkits import TerminalToolkit
toolkit = TerminalToolkit()
# Write a script to disk, then block until a build command completes
toolkit.shell_write_content_to_file(content="echo hello", file_path="/tmp/hello.sh")
toolkit.shell_wait(command="bash /tmp/hello.sh")
from camel.workforce.events import TaskUpdatedEvent, TaskCompletedEvent, TaskFailedEvent
def on_event(event):
if isinstance(event, TaskUpdatedEvent):
print(f"Task updated: {event}")
elif isinstance(event, TaskCompletedEvent):
print(f"Done (parent={event.parent_task_id})")
elif isinstance(event, TaskFailedEvent):
print(f"Failed (parent={event.parent_task_id})")
from camel.toolkits import SerpApiToolkit
from camel.agents import ChatAgent
from camel.models import ModelFactory
from camel.types import ModelPlatformType, ModelType
toolkit = SerpApiToolkit()
model = ModelFactory.create(
model_platform=ModelPlatformType.OPENAI,
model_type=ModelType.GPT_4O,
)
agent = ChatAgent(model=model, tools=toolkit.get_tools())
response = agent.step('What are the top results for "AI agent frameworks" today?')
print(response.msgs[0].content)
agent.summarize(directory='/tmp/agent_summaries/')
from camel.toolkits import TerminalToolkit
toolkit = TerminalToolkit()
tools = toolkit.get_tools()
from camel.toolkits import SearchToolkit
toolkit = SearchToolkit(excluded_domains=['spamsite.com', 'lowqualityblog.net'])
results = toolkit.search_google('latest vulnerability disclosures 2024')
for r in results:
print(r)
from camel.toolkits import Crawl4AIToolkit
from camel.agents import ChatAgent
toolkit = Crawl4AIToolkit()
agent = ChatAgent(tools=toolkit.get_tools())
response = agent.step("Crawl https://example.com and summarize the content.")
workforce = Workforce('My Pipeline')
workforce.add_single_agent_worker('Researcher', worker=researcher_agent)
mcp_server = workforce.to_mcp()
mcp_server.run()
from camel.toolkits import FileWriteToolkit
toolkit = FileWriteToolkit()
toolkit.latex_to_pdf(latex_content=r"\documentclass{article}\begin{document}Hello, CAMEL!\end{document}", output_path="report.pdf")
from camel.loaders import MarkItDownLoader
loader = MarkItDownLoader()
docs = loader.load("report.pdf")
from camel.toolkits import MCPToolkit
config = {
"mcpServers": {
"my_server": {
"url": "http://localhost:8000"
}
}
}
toolkit = MCPToolkit(config=config)
from camel.toolkits import MCPToolkit
toolkit = MCPToolkit(config_path="mcp_config.json", strict=True)
from camel.toolkits import HumanToolkit
toolkit = HumanToolkit()
toolkit.send_message_to_user('Task complete — results saved to output.csv')
from camel.toolkits import TerminalToolkit, FileWriteToolkit
terminal = TerminalToolkit()
file_writer = FileWriteToolkit()
# Pass both toolkits to your agent
tools = terminal.get_tools() + file_writer.get_tools()
from camel.toolkits import ExcelToolkit
from camel.agents import ChatAgent
toolkit = ExcelToolkit()
agent = ChatAgent(tools=toolkit.get_tools())
agent.step('Summarize the data in report.xlsx')
from camel.data_collector import AlpacaItem
item = AlpacaItem(instruction='Explain XSS', input='', output='Cross-site scripting is...')
print(item.model_dump())
retriever.process(content="https://example.com/doc", extra_payload={"source": "internal", "priority": 1})
from camel.agents import ChatAgent
agent = ChatAgent() # system_message now optional
response = agent.step('Summarize the latest AI news')
print(response.msg.content)
from camel.toolkits import FunctionTool
from camel.agents import ChatAgent
def get_weather(city: str) -> str:
return f'Sunny in {city}'
tool = FunctionTool(get_weather)
agent = ChatAgent(tools=[tool])
response = agent.step('What is the weather in Paris?')
print(response.msg.content)
from camel.toolkits import RetrievalToolkit
toolkit = RetrievalToolkit(
top_k=5,
similarity_threshold=0.75,
)
from camel.models import OpenAICompatibilityModel
model = OpenAICompatibilityModel(
model_type="llama3",
url="http://localhost:11434/v1",
api_key="none",
) Summary
camel-ai is an open-source agent framework designed to study the scaling laws of AI agents, making it available under the MIT license. It is positioned for researchers and practitioners interested in multi-agent systems, communicative agents, and research tooling. The framework supports implementing various agent types, tasks, prompts, models, and simulated environments for agent behavior analysis. Users interact with the system via its repository and documentation. The project shows ongoing community dedication, evidenced by its multiple official documentation links and active community hubs.
CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org
What camel-ai answers
What types of interactions does it support for agents?
It supports various agent types, tasks, prompts, models, and simulated environments.
Can it be used to study how agent behavior changes with scale?
It is designed for studying the scaling laws of AI agents.
Does it provide ways to generate data?
It supports data generation.
What kind of systems can I automate using this framework?
It supports task automation.
Where can I find examples of how to use the framework?
Examples are available in the project's repository.
What languages are provided for accessing the documentation?
Documentation is available in English, Simplified Chinese, and Japanese.
Examples
Command line
No option matches that search.
| option | found in | since | description |
|---|
No option matches that search.
Values are placeholders taken from each option’s declared default. Nothing is executed here — the output shown is a recording of a run that already happened.
Release history
- docs update
Adds
PulseMCPSearchToolkitfor searching MCP servers by keyword from within CAMEL agents└──▷ USE ITDiscover available MCP servers matching a keyword (e.g. 'Slack') to find integrations your agent can connect to.from camel.toolkits.mcp import PulseMCPSearchToolkit search_toolkit = PulseMCPSearchToolkit() results = search_toolkit.search_mcp_servers(query="Slack", top_k=1) print(results)
- ›Adds
PulseMCPSearchToolkitwith a search_mcp_servers(query, top_k) method to discover available MCP servers by keyword search directly from Python code.
- ›Adds
- v0.2.90
camel-ai v0.2.90 adds new LLM providers, headless browser toolkit, response API support, and expanded prompt caching.
└──▷ GET THIS VERSION$ git clone --branch v0.2.90 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.90
- ›Adds
request_level_token_callbacksupport viafeat:add_request_level_token_callback, enabling per-request token usage tracking callbacks. - ›Adds advanced ANN query options to the OceanBase integration (bumps
pyobvectorto 0.2.22). - ›Adds a headless browser search toolkit with enhanced browser stealth mode.
- ›Adds
TerminalToolkitsafe-mode sanitization to restrict dangerous command execution. - ›Auto-coerces dict arguments to Pydantic models inside
FunctionTool, removing manual conversion boilerplate.
+9 moreshow less
- ›Adds unified streaming response handling and callback integration for
workforce. - ›Supports the OpenAI Responses API via
feat: support response api. - ›Extends prompt caching support to additional providers beyond Anthropic.
- ›Adds async support for the AWS Bedrock Converse API.
- ›Adds interleaved thinking for Kimi K2 and GLM models.
- ›Adds new models:
MiniMax-M2.5,MiniMax-M2.7,MiniMax-M2.7-highspeed,GLM5, andgemini 3.1to the model enum list. - ›Adds
gpt-5.4to the model enum list. - ›Adds Avian as a new LLM provider.
- ›Adds skill filter capability to workforce task routing.
└──▷ BREAKING ON UPGRADE- !Removes the default 180-second timeout threshold that was previously applied globally.
- ›Adds
- v0.2.86
camel-ai v0.2.86 adds Kimi K2.5 and Claude Opus 4.6 support, prompt caching, browser visual pixel mode, ChatAgent skills, Jina reranking, and file upload/download tooling.
└──▷ GET THIS VERSION$ git clone --branch v0.2.86 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.86
- ›Adds support for
kimi k2.5as a model backend. - ›Adds support for
claude-opus-4-6as a model backend. - ›Adds prompt caching support for compatible model backends.
- ›Adds browser visual pixel mode to
hybrid_browser_toolkit, enabling pixel-level visual interaction with web pages. - ›Adds file upload and download tool for agent workflows.
+4 moreshow less
- ›Adds
ChatAgentskills system, including a skill creator with scripts and reference documentation. - ›Adds Jina reranking integration for retrieval pipelines.
- ›Adds typed parameter definitions and supported format declarations to
EarthScienceToolkit, and expands supported formats inMarkItDownLoader. - ›Unifies cleanup handling across all runtimes for consistent teardown behavior.
- ›Adds support for
- v0.2.85
camel-ai v0.2.85 adds Zhipu GLM 4.1V-thinking, 4.5, 4.6, and 4.7 model support
└──▷ GET THIS VERSION$ git clone --branch v0.2.85 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.85
- ›Adds support for Zhipu's
GLM-4.1V-thinking,GLM-4.5,GLM-4.6, andGLM-4.7models.
- ›Adds support for Zhipu's
- v0.2.83
camel-ai v0.2.83 adds Outlook mail, Lark, IMAP, Serper.dev, AtlasCloud, and Gemma integrations plus new workforce task events
└──▷ GET THIS VERSION$ git clone --branch v0.2.83 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.83
└──▷ USE ITWrite a file and wait for a long-running shell command to finish inside a TerminalToolkit session.from camel.toolkits import TerminalToolkit toolkit = TerminalToolkit() # Write a script to disk, then block until a build command completes toolkit.shell_write_content_to_file(content="echo hello", file_path="/tmp/hello.sh") toolkit.shell_wait(command="bash /tmp/hello.sh")
Listen for task-lifecycle events — including the new TaskUpdatedEvent — to audit workforce task modifications in real time.from camel.workforce.events import TaskUpdatedEvent, TaskCompletedEvent, TaskFailedEvent def on_event(event): if isinstance(event, TaskUpdatedEvent): print(f"Task updated: {event}") elif isinstance(event, TaskCompletedEvent): print(f"Done (parent={event.parent_task_id})") elif isinstance(event, TaskFailedEvent): print(f"Failed (parent={event.parent_task_id})")- ›Adds
SearchToolkitsupport for Serper.dev as a search provider. - ›Adds
shell_waitandshell_write_content_to_filetools toTerminalToolkit. - ›Adds
parent_task_idfield toTaskCompletedEventandTaskFailedEventin the workforce module. - ›Adds
TaskUpdatedEventto the workforce module for tracking task modifications. - ›Adds Microsoft Outlook mail actions toolkit for reading and sending mail.
+11 moreshow less
- ›Adds Lark integration (
lark_send_messageand related toolkit) for messaging via Lark/Feishu. - ›Adds IMAP mail integration for reading email via IMAP.
- ›Adds AtlasCloud model backend integration.
- ›Adds Gemma model integration via new function-calling support.
- ›Emits
TaskFailedEventon workforce quality-check failures. - ›Improves timeout handling for
BaseToolkitandTerminalToolkit. - ›Skips virtual environment creation in
TerminalToolkitif the environment already exists. - ›Enhances workforce task judge and fail-handling prompts.
- ›Improves volcano engine reasoning handling in model backends.
- ›Browser toolkit switches from relative navigation to absolute coordinate positioning.
- ›Browser toolkit reads images into context.
- ›Adds
- v0.2.82
camel-ai v0.2.82 adds SerpAPI and SQL toolkits, EarthScienceToolkit, configurable Workforce fail handling, GPT-5.2 and Gemini 3 Flash support, and custom ChatAgent in RolePlaying.
└──▷ GET THIS VERSION$ git clone --branch v0.2.82 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.82
└──▷ USE ITRun a web search inside an agent using the new SerpAPI toolkit to retrieve live search results.from camel.toolkits import SerpApiToolkit from camel.agents import ChatAgent from camel.models import ModelFactory from camel.types import ModelPlatformType, ModelType toolkit = SerpApiToolkit() model = ModelFactory.create( model_platform=ModelPlatformType.OPENAI, model_type=ModelType.GPT_4O, ) agent = ChatAgent(model=model, tools=toolkit.get_tools()) response = agent.step('What are the top results for "AI agent frameworks" today?') print(response.msgs[0].content)- ›Adds
SerpApiToolkitfor search-engine results via SerpAPI, accessible as a new toolkit integration. - ›Adds
SqlToolkitfor agent-driven SQL database interaction. - ›Adds
EarthScienceToolkitwith ~100 earth-science-specific tools derived from the Earth-Agent paper. - ›Adds
stream_callbackparameter to task execution in Workforce, enabling streaming progress callbacks. - ›Adds configurable failure handling to Workforce so callers can control behaviour when a subtask fails.
+7 moreshow less
- ›Adds
log_messagemethod toWorkforceLoggerfor structured workforce logging. - ›Enables shared multi-runtime instances across multiple toolkits within the same workflow.
- ›Supports custom
ChatAgentinstances insideRolePlaying, allowing callers to supply pre-configured agents for either role. - ›Adds async support for
SiliconFlowmodel backend. - ›Renames all Gmail toolkit tool-call names to include a
gmailprefix (e.g.gmail_send_email). - ›Removes deprecated Gemini 1.5 models from the model registry.
- ›Removes deprecated Groq models from the model registry.
└──▷ BREAKING ON UPGRADE- !Gmail toolkit tool-call names now carry a
gmailprefix; any agent prompt, tool-routing logic, or stored conversation referencing the old bare names (e.g.send_email) will no longer match. - !Deprecated Gemini 1.5 models have been removed; code that instantiates those model identifiers will fail.
- !Deprecated Groq models have been removed; code that instantiates those model identifiers will fail.
- ›Adds
- v0.2.80
camel-ai v0.2.80 adds Gemini 3, Claude Opus 4.5, Cerebras, and ERNIE 5.0 Thinking model support alongside workforce running-mode expansion
└──▷ GET THIS VERSION$ git clone --branch v0.2.80 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.80
- ›Adds support for Gemini 3 models, including thought signatures and streaming mode.
- ›Adds support for Claude Opus 4.5.
- ›Adds Cerebras platform models as a new provider integration.
- ›Adds
ERNIE_5_0_THINKINGmodel to the ERNIE model family. - ›Extends
BaseMessageto carry reasoning/thought fields and updates usage accounting in streaming mode.
+6 moreshow less
- ›Terminal toolkit now automatically creates a Docker container if one does not already exist.
- ›Terminal toolkit gains support for installing user-specified dependency packages.
- ›Workforce gains support for additional running modes.
- ›Unifies timeout configuration across the library with a
TIMEOUTconstant. - ›Workflow save folder and filename generation is now semantic (human-readable) rather than using opaque identifiers.
- ›Improves async tool execution support across toolkits.
- v0.2.79
camel-ai v0.2.79 adds workforce callbacks, smart workflow retrieval, new model providers, async summarization, and multiple system message support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.79 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.79
- ›Adds callback support for Workforce events and metrics logging, enabling hooks into task lifecycle and observability pipelines.
- ›Adds
searchtool toFileToolkitfor searching across files managed by the toolkit. - ›Supports multiple system messages in
ChatAgentwith an improved API (Support Multiple System Messages with Better API). - ›Adds automatic summarization in
ChatAgentwhen token limit is exceeded or a configurable threshold is reached. - ›Adds async
summarizesupport inChatAgentfor faster Workforce execution.
+10 moreshow less
- ›Adds Smart Workflow Retrieval to Workflow, enabling context-aware session lookup.
- ›Supports better filenames and custom session IDs in Workflow.
- ›Adds async
runsupport for AWS Bedrock model backend. - ›Supports customized clients in model backends.
- ›Adds
AiHubMixas a new model provider. - ›Adds
SiliconFlowmodel provider support, including Deepseek, InternLM, and Qwen model families. - ›Adds Minimax M2 model support.
- ›Adds
gmail_toolkitintegration. - ›Adds browser sheet tool with input and read capabilities.
- ›Adds Python 3.13 and 3.14 support.
- v0.2.76
camel-ai v0.2.76 adds AMD model platform, microsandbox, WeChat/DingTalk/Resend toolkits, Workforce workflows, and Claude Sonnet 4.5 support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.76 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.76
└──▷ USE ITSummarize a long agent conversation to a directory so context can be reloaded across sessions.agent.summarize(directory='/tmp/agent_summaries/')
- ›Adds
ArtifactToolto provide a Claude-style artifact experience for agents. - ›Adds configurable accumulated vs. delta streaming mode with memory optimization via
feat(agents): add configurable accumulated vs delta streaming with memory optimization. - ›Adds agent.summarize() with a
directoryparameter so agents can load and write context summaries to files on disk. - ›Adds tool-call caching for
ChatAgentto avoid redundant tool invocations. - ›Adds
kwargspassthrough toChunkrReaderConfigfor extended configuration of the Chunkr document reader.
+25 moreshow less
- ›Adds AMD model platform support as a new inference backend.
- ›Adds
MiniMax MCPtoolkit integration for MiniMax model operations. - ›Integrates
microsandboxas a local sandboxed code-execution solution. - ›Integrates WeChat as a new messaging toolkit.
- ›Integrates Resend as an email-sending toolkit.
- ›Integrates DingTalk toolkit with enhanced capabilities.
- ›Adds Google Vertex AI Veo toolkit for video generation.
- ›Adds
ACItoolkit async support. - ›Adds Grok image support in model integrations.
- ›Adds
CometAPIsupport with new model and configuration classes. - ›Adds Magistral Small 1.2 and Magistral Medium 1.2 models.
- ›Adds Claude Sonnet 4.5 model support.
- ›Adds Slack
get_user_infocapability to the Slack toolkit. - ›Adds Workforce Workflow feature enabling structured multi-agent pipeline execution.
- ›Adds independent task queue support for Workforce.
- ›Adds Pydantic type checking in the MCP decorator.
- ›Adds Markdown agent context handling for structured document processing.
- ›Adds Dynamic File Editing capability for agents.
- ›Refactors MCPToolkits for improved structure.
- ›Refactors
terminal_toolkitwith Docker backend support andlog_dirlogging. - ›Adds
log_dirparameter for browser and terminal tools to capture session logs. - ›Adds
browser_som_screenshotenhancement for visual element tagging in browser automation. - ›Supports image URL as a message directly in model inputs.
- ›Adds agent pool performance metrics and efficiency improvements.
- ›Runs containers as non-root with host UID/GID mapping for improved sandbox security.
- ›Adds
- v0.2.75
camel-ai v0.2.75 adds Claude 4.1, GPT-5, Mistral Medium 3.1, Nebius AI Studio, MetaSo search, and a TerminalToolkit MCP server.
└──▷ GET THIS VERSION$ git clone --branch v0.2.75 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.75
└──▷ USE ITUse the new TerminalToolkit MCP server to give an agent shell access via MCP.from camel.toolkits import TerminalToolkit toolkit = TerminalToolkit() tools = toolkit.get_tools()
- ›Adds
TerminalToolkitMCP server, enabling agents to execute terminal commands via the Model Context Protocol. - ›Updates
OpenAIImageToolkitto support generating multiple images in a single call. - ›Adds Ollama API key configuration support for authenticated Ollama endpoints.
- ›Adds
ChatAgenttimeout and retry handling for more resilient agent loops. - ›Adds support for Claude 4.1 models.
+4 moreshow less
- ›Adds support for GPT-5 models.
- ›Adds support for Mistral Medium 3.1 models.
- ›Adds Nebius AI Studio as a new model provider integration.
- ›Adds MetaSo (
metaso.cn) API as a new search tool integration.
- ›Adds
- v0.2.74
camel-ai v0.2.74 adds custom E2B-compatible sandbox providers, browser console/input tools, snapshot/viewport toolkit, and Horizon Alpha model support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.74 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.74
- ›Adds support for custom E2B-compatible sandbox providers, allowing agents to execute code in alternative sandboxed environments beyond the default E2B offering.
- ›Adds console and input tools to the hybrid browser toolkit, enabling agents to interact with browser console output and inject input during browser-based automation.
- ›Adds a snapshot design and viewport toolkit (
viewport_toolkit.py) for capturing and reasoning over browser viewport state. - ›Adds the Horizon Alpha model from OpenRouter as a supported model in CAMEL.
- v0.2.73
camel-ai v0.2.73 adds SurrealDB vector storage, five new toolkits, domain exclusion for Google search, and token-saving tool-call pruning in ChatAgent.
└──▷ GET THIS VERSION$ git clone --branch v0.2.73 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.73
└──▷ USE ITExclude competitor or low-quality domains from Google search results inside an agent toolkit.from camel.toolkits import SearchToolkit toolkit = SearchToolkit(excluded_domains=['spamsite.com', 'lowqualityblog.net']) results = toolkit.search_google('latest vulnerability disclosures 2024') for r in results: print(r)- ›Adds
SurrealDBStorageas a new vector storage backend, enabling agents to persist and query embeddings in SurrealDB. - ›Adds
excluded_domainsparameter toSearchToolkitdefinition to exclude specified domains fromsearch_googleresults at the toolkit level. - ›Adds
timeoutparameter toTerminalToolkitto bound how long shell commands may run. - ›Adds
TerminalToolkitauto-installation ofuvwhen it is not present on the host. - ›Adds tool-call message pruning in
ChatAgentto reduce token budget consumed by accumulated tool-call history.
+10 moreshow less
- ›Adds
ToolkitMessageIntegrationto let agents broadcast structured status messages from within toolkits. - ›Adds
ScreenshotToolkitfor capturing screenshots from within agent workflows. - ›Adds
WebDeployToolkit(webdeploy_toolkit) for deploying web artifacts from within agent workflows. - ›Adds
NotionMCPToolkit(notion_mcp_toolkit.py) for interacting with Notion via the MCP protocol. - ›Adds Origene toolkit integration for agent-driven research workflows.
- ›Adds CDP (Chrome DevTools Protocol) connect support to the browser toolkit via
cdp connect. - ›Adds Python-native browser (
py browser) as an additional browser backend. - ›Adds Qwen Coder model support to the model registry.
- ›Converts invalid MCP schemas to satisfy OpenAI tool-calling requirements automatically.
- ›Updates Mem0 integration to the v2 API.
- ›Adds
- v0.2.70
camel-ai v0.2.70 adds PgVector/Chroma storage, Google Drive toolkit, crawl4ai/markitdown toolkits, Mistral Small 3.2, and multimodal Task support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.70 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.70
└──▷ USE ITUse the Crawl4AI toolkit to give an agent web-crawling capability.from camel.toolkits import Crawl4AIToolkit from camel.agents import ChatAgent toolkit = Crawl4AIToolkit() agent = ChatAgent(tools=toolkit.get_tools()) response = agent.step("Crawl https://example.com and summarize the content.")- ›Adds
extra_bodyfield to vLLM model config, enabling pass-through of provider-specific parameters. - ›Adds
PgVectorStorageimplementation for PostgreSQL withpgvectorsupport as a new vector store backend. - ›Adds
ChromaDBas a supported vector database for RAG workflows. - ›Adds
GoogleDriveToolkitfor agent access to Google Drive. - ›Adds Crawl4AIToolkit and
MarkItDownToolkitas first-class built-in toolkits.
+9 moreshow less
- ›Adds
EdgeOnePagesMCPToolkitand updatesbrowser_nonvisual_human_in_the_loopfor human-in-the-loop browser workflows. - ›Adds Mistral Small 3.2 as a supported model.
- ›Adds non-visual browser method enabling agents to interact with web content without vision capabilities.
- ›Enhances
ExcelToolkitwith additional spreadsheet operations. - ›Supports attaching multimodal (image/media) information directly to Task objects.
- ›Adds more built-in operations to the Python interpreter sandbox.
- ›Enhances
VideoAnalysisToolkitwith updated OCR capability. - ›Updates
TerminalToolkitto support Docker environment log output. - ›Improves Workforce task assignment robustness and adds JSON validation to agent outputs.
- ›Adds
- v0.2.68
camel-ai v0.2.68 adds RLCards board-game environments and parallel task execution to Workforce.
└──▷ GET THIS VERSION$ git clone --branch v0.2.68 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.68
- ›Adds RLCards environments for the Project Loong board game, enabling multi-step reinforcement-learning workflows.
- ›Adds parallelization support to Workforce to improve throughput on multi-agent task pipelines.
- ›Updates Workforce with support for the latest Anthropic models.
- v0.2.67
Camel v0.2.67 adds Workforce shared memory, batch task assignment, KPI metrics, human-in-the-loop, and Qianfan platform integration.
└──▷ GET THIS VERSION$ git clone --branch v0.2.67 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.67
- ›Adds
share_memorysupport to Workforce, enabling agents within a workforce to share a common memory store. - ›Adds batch task assignment to Workforce, allowing multiple tasks to be dispatched in a single operation.
- ›Adds KPI metrics collection to Workforce for monitoring and measuring workforce performance.
- ›Adds human-in-the-loop capability to Workforce, letting a human intervene in task processing at runtime.
- ›Updates Workforce task processing to async, unlocking non-blocking multi-agent pipelines.
+3 moreshow less
- ›Integrates the Qianfan platform as a new model provider, expanding supported LLM backends.
- ›Enables flexible argument passing on model calls, allowing runtime kwargs to be forwarded to underlying model APIs.
- ›Improves robustness of async operations across core modules.
- ›Adds
- v0.2.66
camel-ai v0.2.66 adds strict-mode JSON schema enforcement for tool definitions
└──▷ GET THIS VERSION$ git clone --branch v0.2.66 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.66
- ›Sets tool schema to follow strict mode, enforcing stricter JSON schema validation on tool definitions passed to the model
- v0.2.65
camel-ai v0.2.65 adds a Task Planning Toolkit, O3-pro model support, persistent browser context, stealth mode, and mock website tooling.
└──▷ GET THIS VERSION$ git clone --branch v0.2.65 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.65
- ›Replaces
ChatAgent.single_iterationwithmax_iteration_for controlling agent iteration limits. - ›Adds a new Task Planning Toolkit for structured agent task planning workflows.
- ›Adds support for the O3-pro model.
- ›Supports persistent browser context and stealth mode for browser-based automation.
- ›Adds mock website capability for browser toolkit testing and simulation.
+1 moreshow less
- ›Adds a PowerPoint (
pptx) toolkit use-case application.
└──▷ BREAKING ON UPGRADE- !
ChatAgent.single_iterationhas been replaced bymax_iteration_; any code referencingsingle_iterationwill break on upgrade.
- ›Replaces
- v0.2.64
camel-ai v0.2.64 adds Weaviate vector storage, Langfuse integration, MCP export for Workforce, Crynux LLM provider, and two new model supports.
└──▷ GET THIS VERSION$ git clone --branch v0.2.64 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.64
└──▷ USE ITExpose a Workforce multi-agent pipeline as an MCP server so external tools can invoke it via the Model Context Protocol.workforce = Workforce('My Pipeline') workforce.add_single_agent_worker('Researcher', worker=researcher_agent) mcp_server = workforce.to_mcp() mcp_server.run()- ›Adds
to_mcpmethod to Workforce, enabling Workforce instances to be exported and used as an MCP server. - ›Integrates Langfuse as an observability/tracing backend for agent runs.
- ›Adds
WeaviateVectorStorageas a new vector storage backend. - ›Adds Crynux as a new LLM provider.
- ›Adds support for
gemini-2.5-pro-preview-06-05model.
+5 moreshow less
- ›Adds support for Mistral's
magistral-medium-2506model. - ›Adds dynamic dependency loading so optional integrations are imported on demand rather than at startup.
- ›Enhances Workforce with graceful shutdown support.
- ›Adds attempt information to Task additional info in Workforce, giving agents richer context on retries.
- ›Enhances MCP support to run in synchronous mode.
- ›Adds
- v0.2.62
camel-ai v0.2.62 adds a PowerPoint toolkit for agent-driven PPTX generation.
└──▷ GET THIS VERSION$ git clone --branch v0.2.62 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.62
- ›Adds a new
pptxtoolkit enabling agents to create and manipulate PowerPoint presentations programmatically.
- ›Adds a new
- v0.2.61
camel-ai v0.2.61 adds FAISS vector storage, Claude 4, MCP agent export, Mistral OCR, and LaTeX-to-PDF tooling
└──▷ GET THIS VERSION$ git clone --branch v0.2.61 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.61
└──▷ USE ITGenerate a polished PDF report from LaTeX source produced by an agent, using the updatedFileWriteToolkit.from camel.toolkits import FileWriteToolkit toolkit = FileWriteToolkit() toolkit.latex_to_pdf(latex_content=r"\documentclass{article}\begin{document}Hello, CAMEL!\end{document}", output_path="report.pdf")- ›Adds FAISSStorage as a new vector storage backend, giving practitioners a local, high-performance embedding index option alongside existing cloud stores.
- ›Adds
ModelManageras an accepted input toChatAgent, enabling dynamic model routing and fallback strategies at the agent level. - ›Adds Agent-to-MCP export capability, allowing
ChatAgentinstances to be exposed as Model Context Protocol servers for interoperability with MCP-compatible clients. - ›Adds synchronous
mcp_toolkit, enabling synchronous MCP tool invocation alongside the existing async interface. - ›Adds Mistral Document AI integration for advanced OCR processing of documents within the toolkit ecosystem.
+5 moreshow less
- ›Adds LaTeX-to-PDF conversion to
FileWriteToolkit, enabling agents to render structured documents directly to PDF. - ›Adds Bohrium compute platform integration for running camel workloads on Bohrium infrastructure.
- ›Supports Claude 4 models via the
ChatAgentmodel interface. - ›Updates
evol_instructwith new capabilities for instruction evolution and data synthesis workflows. - ›Updates Chunkr integration to use the Chunkr SDK, replacing the previous direct API approach.
- v0.2.60
camel-ai v0.2.60 adds streamable HTTP, Jina Reranker API support, extra Azure OpenAI headers, and new Gemini model types.
└──▷ GET THIS VERSION$ git clone --branch v0.2.60 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.60
- ›Adds streamable HTTP transport support for real-time, streaming agent communication.
- ›Adds Jina Reranker API support, enabling remote reranking calls alongside the existing local reranker.
- ›Adds support for passing extra headers to Azure OpenAI requests.
- ›Adds updated Gemini model types including corrected support for Gemini 2.0 Flash.
- v0.2.59
camel-ai v0.2.59 adds an Airbnb MCP integration and the BrowseComp benchmark for CAMEL agents.
└──▷ GET THIS VERSION$ git clone --branch v0.2.59 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.59
- ›Integrates the BrowseComp benchmark, enabling evaluation of CAMEL agents on complex, multi-step web browsing tasks.
- ›Adds an Airbnb MCP integration use case, demonstrating CAMEL agents operating as MCP clients against an Airbnb MCP server.
- v0.2.58
camel-ai v0.2.58 adds a MarkItDown loader, MCP search agent, async BrowserToolkit, and Gemini 2.5 Pro preview support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.58 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.58
└──▷ USE ITLoad a PDF or Office document into a CAMEL pipeline using the new MarkItDown loader.from camel.loaders import MarkItDownLoader loader = MarkItDownLoader() docs = loader.load("report.pdf")- ›Adds
gemini-2.5-pro-preview-05-06as a supported model in theGEMINImodel family. - ›Adds a
MarkItDowndocument loader for ingesting files via Microsoft's MarkItDown library. - ›Adds an MCP search agent enabling agent workflows driven by Model Context Protocol tool servers.
- ›Adds async support to
BrowserToolkit, enabling non-blocking browser automation in async agent pipelines. - ›Improves MCP server launch with a better interface and support for all connection modes.
- ›Adds
- v0.2.56
camel-ai v0.2.56 adds async Mistral support, Mistral Medium model, and a Playwright MCP toolkit.
└──▷ GET THIS VERSION$ git clone --branch v0.2.56 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.56
- ›Adds async implementation to the Mistral model integration, enabling non-blocking LLM calls.
- ›Adds support for the
mistral-mediummodel. - ›Adds a Playwright MCP toolkit for browser automation within agent workflows.
- v0.2.55
camel-ai v0.2.55 adds Agent-as-MCP-server, Pulse MCP search, Klavis AI toolkit, and timeout control for MCP sessions.
└──▷ GET THIS VERSION$ git clone --branch v0.2.55 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.55
└──▷ USE ITSupply MCP server config as a plain dict instead of a config file, useful for dynamically constructed or secrets-managed configs.from camel.toolkits import MCPToolkit config = { "mcpServers": { "my_server": { "url": "http://localhost:8000" } } } toolkit = MCPToolkit(config=config)- ›Adds MCPServer capability to expose a CAMEL agent as an MCP server, letting other MCP clients connect to and invoke the agent directly.
- ›Adds support for passing a Dict as config to the MCP toolkit, complementing the existing file-based config approach.
- ›Adds a
timeoutargument to MCP session initialization, enabling control over how long the client waits for MCP server responses. - ›Adds Pulse MCP search toolkits, enabling agents to search the Pulse MCP registry.
- ›Adds
list_toolsandcall_toolfunctions to the Klavis AI toolkit, allowing agents to enumerate and invoke Klavis AI tools.
- v0.2.53
camel-ai v0.2.53 adds Gemini embeddings, ACI tool interface, MCP for non-function-calling models, and richer ChatAgent control.
└──▷ GET THIS VERSION$ git clone --branch v0.2.53 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.53
- ›Adds
terminationparameter to ChatAgent.step() and ChatAgent.astep() to allow callers to inject custom termination conditions at call time. - ›Enables
ModelFactoryto accept and pass through additional keyword arguments when constructing model instances. - ›Adds Gemini embedding support via the existing embeddings interface.
- ›Introduces ACI tool interface (
ACI_Tool_interface) for interacting with ACI-based tools. - ›Enables MCP (Model Context Protocol) for models that do not natively support function calling, expanding MCP compatibility beyond function-calling-capable backends.
- ›Adds
- v0.2.52
camel-ai v0.2.52 adds Klavis toolkit, Daytona runtime integration, and a
strictparameter for MCP classes.└──▷ GET THIS VERSION$ git clone --branch v0.2.52 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.52
└──▷ USE ITEnforce strict mode when initializing an MCP client to surface connection or schema errors immediately.from camel.toolkits import MCPToolkit toolkit = MCPToolkit(config_path="mcp_config.json", strict=True)
- ›Adds
strictparameter to the constructors of MCPClient and MCPToolkit classes for stricter MCP connection control. - ›Adds
KlavisToolkitintegration for connecting to the Klavis API. - ›Integrates Daytona runtime support for sandboxed code execution environments.
- ›Adds
- v0.2.51
camel-ai v0.2.51 adds DeepSeek Prover V2 671B via PPIO, SingleStepEnv timeout, and Azure AD token provider support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.51 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.51
- ›Adds
azure_ad_token_providersupport to Azure OpenAI integration, enabling token-based authentication flows. - ›Adds
timeoutparameter toSingleStepEnv, enabling time-bounded environment execution. - ›Adds DeepSeek Prover V2 671B model support via the PPIO provider.
- ›Adds
- v0.2.50
camel-ai v0.2.50 adds Novita and WatsonX LLM providers, Qwen3 support, a Physics verifier, and browser toolkit caching.
└──▷ GET THIS VERSION$ git clone --branch v0.2.50 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.50
- ›Adds Novita as a new LLM provider integration.
- ›Integrates IBM WatsonX as a new LLM provider.
- ›Adds Qwen3 model support via both ModelScope and the
qwen_modelbackend. - ›Adds a Physics verifier for validating physics-related agent outputs.
- ›Adds caching capability to the Browser Toolkit, reducing redundant network calls.
+1 moreshow less
- ›Simplifies agent creation by accepting a plain string argument in place of a full model config object.
- v0.2.49
camel-ai v0.2.49 adds Netmind as a supported model platform.
└──▷ GET THIS VERSION$ git clone --branch v0.2.49 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.49
- ›Adds support for the Netmind platform as a model backend.
- v0.2.47
camel-ai v0.2.47 adds OceanBase DB integration, Jina reranker, Alibaba Tongxiao Search, ScrapeGraph SDK, and O4-mini/O3 model support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.47 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.47
- ›Adds support for O4-mini and
O3models. - ›Integrates OceanBase database as a new storage/retrieval backend.
- ›Adds a Jina reranker toolkit for reranking retrieval results.
- ›Adds Alibaba Tongxiao Search API support via
search_toolkit. - ›Integrates
scrapegraph-sdkfor AI-powered web scraping.
- ›Adds support for O4-mini and
- v0.2.46
camel-ai v0.2.46 adds PyAutoGUI toolkit, LM Studio integration, and refreshed AWS Bedrock and OpenAICompatibleModel support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.46 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.46
- ›Adds
PyAutoGUItoolkit, enabling agents to drive desktop GUI automation through the newpyautoguitoolkit interface. - ›Adds LM Studio integration via
LMStudioModel, letting practitioners run locally-hosted LM Studio models as a camel-ai backend. - ›Updates AWS Bedrock integration with refreshed model support through
aws_bedrock. - ›Enhances
OpenAICompatibleModelso all model implementations inherit from it, simplifying custom model integration. - ›Refactors the video toolkit with expanded capabilities for video processing workflows.
- ›Adds
- v0.2.45
camel-ai v0.2.45 adds Ubuntu Docker runtime and OpenAI GPT-4.1 model support
└──▷ GET THIS VERSION$ git clone --branch v0.2.45 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.45
- ›Supports OpenAI
gpt-4.1as a model backend option. - ›Adds Ubuntu Docker runtime for sandboxed code execution environments.
- ›Adds
timeoutsetting for all model backends to cap inference wait time.
- ›Supports OpenAI
- v0.2.43
camel-ai v0.2.43 adds Exa search, crawl4ai, Google Calendar toolkit, Together/Azure embeddings, PPIO LLM, and Llama 4 via OpenRouter.
└──▷ GET THIS VERSION$ git clone --branch v0.2.43 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.43
- ›Adds Exa search integration as a new toolkit for web search capabilities.
- ›Integrates
crawl4aifor AI-powered web crawling support. - ›Adds
GoogleCalendarToolkitfor interacting with Google Calendar from agents. - ›Adds Together embedding support as a new embedding backend.
- ›Adds Azure embedding support as a new embedding backend.
+3 moreshow less
- ›Adds PPIO as a new LLM provider platform.
- ›Adds Llama 4 model support via the OpenRouter integration.
- ›Implements Tic Tac Toe as a
MultiStepEnvenvironment for reinforcement-learning-style agent tasks.
- v0.2.42
camel-ai v0.2.42 adds dict-of-strings input to the step function and enhances the terminal toolkit.
└──▷ GET THIS VERSION$ git clone --branch v0.2.42 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.42
- ›Allows a dict of strings to be passed as input to the
stepfunction, enabling richer structured message passing to agents. - ›Enhances the terminal toolkit with new capabilities for agent-driven shell interactions.
- ›Allows a dict of strings to be passed as input to the
- v0.2.40
camel-ai v0.2.40 adds ModelScope integration, YAML/JSON model config loading, MCP server support, and new data-generation verifiers
└──▷ GET THIS VERSION$ git clone --branch v0.2.40 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.40
└──▷ USE ITSend a direct message to the user from within a tool-using agent, rather than routing output through the agent reply chain.from camel.toolkits import HumanToolkit toolkit = HumanToolkit() toolkit.send_message_to_user('Task complete — results saved to output.csv')- ›Supports loading model configs from YAML and JSON files via
SaranshPandya's implementation, enabling file-driven model configuration. - ›Adds
send_message_to_usermethod tohuman_toolkitfor direct user messaging from agent workflows. - ›Allows optional output dimension parameter in OpenAI-compatible embedding calls.
- ›Integrates ModelScope models as a new model provider in camel.
- ›Adds a self-instruct data generator for synthetic instruction dataset creation.
+4 moreshow less
- ›Adds math verification as a new verifier (math verify) for evaluating model outputs against mathematical reference answers.
- ›Exposes camel toolkits as an MCP server, making them accessible over the Model Context Protocol.
- ›Supports one-command-line connection to MCP servers.
- ›Implements resetting from a generative dataset in reinforcement-learning environments.
└──▷ BREAKING ON UPGRADE- !The
ground_truthfield in verifier is renamed toreference_answer— any code passingground_truthto a verifier will break.
- ›Supports loading model configs from YAML and JSON files via
- v0.2.38
camel-ai v0.2.38 adds Evol-Instruct datagen, TiDB vector storage, SearXNG toolkit, OpenAI Responses API, and model request timeouts
└──▷ GET THIS VERSION$ git clone --branch v0.2.38 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.38
- ›Adds timeout support for the base model backend, enabling callers to bound inference request duration.
- ›Adds
SearXNGtoolkit for privacy-respecting federated web search inside agent workflows. - ›Adds OpenAI Responses API support to the model backend.
- ›Adds Evol-Instruct-style data augmentation methods to
camel/datagenfor synthetic instruction generation. - ›Adds browser toolkit support with pre-defined dynamic channel routing.
- v0.2.37
camel-ai v0.2.37 adds a Think Toolkit, a GitHub repo query agent, and Gemini 2.5 Pro support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.37 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.37
- ›Adds
ThinkToolkitfor structured reasoning steps within agent workflows. - ›Adds a new agent for processing queries grounded in GitHub repositories.
- ›Adds support for Gemini 2.5 Pro as a model backend.
- ›Adds
- v0.2.36
camel-ai v0.2.36 adds Mem0 memory integration, OpenRouter support, browser downloads, and MCP toolkit header acceptance.
└──▷ GET THIS VERSION$ git clone --branch v0.2.36 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.36
- ›Adds
accepting headersupport in MCP toolkits, enabling custom HTTP headers when connecting to MCP tool servers. - ›Integrates Mem0 as a memory backend, giving agents persistent, external memory via the Mem0 service.
- ›Adds OpenRouter as a supported model provider, expanding the set of LLM backends available to agents.
- ›Adds browser download capability to the browser toolkit, allowing agents to trigger and handle file downloads.
- ›Adds
- v0.2.35
camel-ai v0.2.35 adds persistent agent memory by ID and a pluggable chunker module for custom chunking strategies.
└──▷ GET THIS VERSION$ git clone --branch v0.2.35 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.35
- ›Adds a chunker module enabling custom chunking strategies for document processing pipelines.
- ›Links memory to agents by ID, enabling persistent and retrievable memory scoped to individual agent instances.
- v0.2.34
camel-ai v0.2.34 adds JSONL-based StaticDataset initialization and enhances FewShotGenerator
└──▷ GET THIS VERSION$ git clone --branch v0.2.34 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.34
- ›Adds JSONL initialization support to
StaticDataset, enabling datasets to be loaded directly from JSONL files. - ›Enhances
FewShotGeneratorwith new capabilities for few-shot example generation.
- ›Adds JSONL initialization support to
- v0.2.31
camel-ai v0.2.31 adds Bing Search integration
└──▷ GET THIS VERSION$ git clone --branch v0.2.31 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.31
- ›Adds Bing Search as a new search backend
- v0.2.30
camel-ai v0.2.30 adds Baidu search integration, enhanced BrowserToolkit, file logging output, and refactored environment types.
└──▷ GET THIS VERSION$ git clone --branch v0.2.30 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.30
- ›Adds Baidu search as a new search integration via
feat: add baidu search. - ›Enhances
BrowserToolkitwith new capabilities for browser-based agent workflows. - ›Adds file output support for logging, enabling log persistence to disk.
- ›Refactors
BaseEnvironmentinto distinctSingleStepandMultiStepenvironment classes for cleaner agent environment modeling.
└──▷ BREAKING ON UPGRADE- !
BaseEnvironmenthas been refactored intoSingleStepandMultiStepenvironment classes — code importing or subclassingBaseEnvironmentdirectly will break on upgrade.
- ›Adds Baidu search as a new search integration via
- v0.2.29
camel-ai v0.2.29 splits datasets into StaticDataset and GenerativeDataset and adds agent tool call try/except handling.
└──▷ GET THIS VERSION$ git clone --branch v0.2.29 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.29
- ›Introduces
StaticDatasetandGenerativeDatasetas distinct classes, replacing the previous unified dataset abstraction. - ›Adds try/except error handling for agent tool calls, plus updated image logging support.
- ›Introduces
- v0.2.28
camel-ai v0.2.28 adds MCPToolkitManager for orchestrating multiple MCPToolkits in a single agent.
└──▷ GET THIS VERSION$ git clone --branch v0.2.28 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.28
- ›Adds
MCPToolkitManagerclass to manage multiple MCPToolkit instances together, simplifying multi-toolkit agent setups.
- ›Adds
- v0.2.27
camel-ai v0.2.27 adds Volcano Engine model integration and Bocha search to the search toolkit.
└──▷ GET THIS VERSION$ git clone --branch v0.2.27 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.27
- ›Adds Bocha search as a new provider in the search toolkit.
- ›Adds Volcano Engine integration support for model backends.
- v0.2.26
camel-ai v0.2.26 adds Claude tool calling, PubMed toolkit, and dynamic graph support via Neo4j
└──▷ GET THIS VERSION$ git clone --branch v0.2.26 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.26
- ›Adds Claude tool calling support, enabling Anthropic Claude models to invoke tools through the camel-ai agent framework.
- ›Adds
PubMedToolkitto the toolkit collection, allowing agents to query PubMed biomedical literature. - ›Supports dynamic graph construction via Neo4j, enabling agents to build and query knowledge graphs at runtime.
- ›Refactors
SeedDatasetto improve compatibility and simplify usage when constructing training datasets.
- v0.2.25
camel-ai v0.2.25 adds function call support in SGLang.
└──▷ GET THIS VERSION$ git clone --branch v0.2.25 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.25
- ›Adds function call support in SGLang.
- v0.2.24
camel-ai v0.2.24 adds Terminal, File Write, and MCP Client toolkits plus Claude 3.7 and async RolePlaying support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.24 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.24
└──▷ USE ITGive an agent the ability to run shell commands and write files in a single session.from camel.toolkits import TerminalToolkit, FileWriteToolkit terminal = TerminalToolkit() file_writer = FileWriteToolkit() # Pass both toolkits to your agent tools = terminal.get_tools() + file_writer.get_tools()
- ›Adds
TerminalToolkitfor agent-driven shell command execution. - ›Adds
FileWriteToolkitfor agent-driven file write operations. - ›Integrates MCP (Model Context Protocol) client as a callable Toolkit, enabling agents to connect to MCP servers.
- ›Adds Claude 3.7 model support via updated Anthropic model config.
- ›Enables
RolePlayingto run asynchronously withasyncsupport.
- ›Adds
- v0.2.23
camel-ai v0.2.23 adds new toolkits (Excel, audio, web, image analysis, Zapier), hybrid retrieval, verifiers, and data-gen pipeline improvements.
└──▷ GET THIS VERSION$ git clone --branch v0.2.23 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.23
└──▷ USE ITEquip an agent with the ExcelToolkit to read and manipulate spreadsheets during a task.from camel.toolkits import ExcelToolkit from camel.agents import ChatAgent toolkit = ExcelToolkit() agent = ChatAgent(tools=toolkit.get_tools()) agent.step('Summarize the data in report.xlsx')- ›Adds
stop_on_first_failureoption toInstructionFilterin thedatagenmodule to halt pipelines on the first failed instruction. - ›Adds
ensure_asciioption toSelfImprovingCoTPipelineJSON output for non-ASCII character handling in generated datasets. - ›Adds timestamp to
VectorDBMemoryto prevent data retrieval order confusion. - ›Adds
ExcelToolkitfor agent interaction with Excel files. - ›Adds
WebToolkit(ported from owl project) for web interaction capabilities.
+15 moreshow less
- ›Adds audio toolkit (ported from owl project) for audio processing in agents.
- ›Adds image analysis toolkit for visual analysis tasks.
- ›Integrates Zapier AI as a new toolkit, enabling agents to trigger Zapier workflows.
- ›Adds
reasoning_parameterintegration for model calls, exposing reasoning configuration to agents. - ›Introduces
BaseVerifierandPythonVerifierfor verifying agent-generated code and outputs. - ›Implements KnowNo for agent uncertainty quantification and conformal prediction.
- ›Adds hybrid retrieval support, combining multiple retrieval strategies in the RAG pipeline.
- ›Integrates NetworkX for graph-based reasoning and data representation.
- ›Adds custom prompt support in the graph agent.
- ›Adds new timeout functionality across all toolkits, enabling per-toolkit execution time limits.
- ›Adds support for the
gpt-4.5model. - ›Adds Ollama multimodal model support.
- ›Adds rejection sampling data generation pipeline with
SelfImprovingCoTpipeline. - ›Adds logging for error handling and instruction generation progress in
datagenpipelines. - ›Switches dependency management to
uv.
- ›Adds
- v0.2.22
camel-ai v0.2.22 adds MinerU document extraction and non-ASCII JSON readability in SelfInstructPipeline
└──▷ GET THIS VERSION$ git clone --branch v0.2.22 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.22
- ›Adds
MinerU Extractorfor document extraction support. - ›Enhances
SelfInstructPipelineJSON dump to preserve non-ASCII characters in readable form (instead of escaped Unicode sequences). - ›Adds URL handling support to
OpenAIEmbeddingto align behavior withOpenAIModel.
- ›Adds
- v0.2.20
camel v0.2.20 adds Moonshot, SiliconFlow, and AIML model integrations plus SemanticScholar and SymPy toolkits
└──▷ GET THIS VERSION$ git clone --branch v0.2.20 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.20
- ›Adds
SemanticScholarToolkitsto integrate Semantic Scholar academic search into agents. - ›Integrates Moonshot models into camel's model platform support.
- ›Integrates SiliconFlow model platform.
- ›Integrates AIML model platform.
- ›Adds SymPy integration for symbolic mathematics computation within agents.
+3 moreshow less
- ›Implements STaR (Self-Taught Reasoner) self-improving reasoning pipeline.
- ›Adds internal deduplication support for data pipelines.
- ›Supports Gemini 2.0 Flash Thinking and Gemini 2.0 Pro models.
- ›Adds
- v0.2.19
camel-ai v0.2.19 adds Jina embeddings, OpenAI o3-mini support, and tool calling for SGLang and Groq
└──▷ GET THIS VERSION$ git clone --branch v0.2.19 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.19
- ›Adds support for OpenAI
o3-minimodel. - ›Adds Jina embedding integration.
- ›Enables tool calling for SGLang and Groq backends.
- ›Enhances
source2synthdata synthesis pipeline.
- ›Adds support for OpenAI
- v0.2.18
camel-ai v0.2.18 adds DeepSeek R1 reasoning content support, a new DeepSeek Reasoner model, and native tool calls for SambaCloud and TogetherAI.
└──▷ GET THIS VERSION$ git clone --branch v0.2.18 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.18
- ›Supports extracting reasoning content from DeepSeek R1 model responses via the model backend.
- ›Adds
deepseek_reasonermodel to the supported model list. - ›Enables native tool call support for SambaCloud and TogetherAI providers.
- v0.2.17
camel-ai v0.2.17 adds Discord OAuth, InternLM models, Skywork reward model, Source2Synth, and a structured document loader.
└──▷ GET THIS VERSION$ git clone --branch v0.2.17 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.17
- ›Adds Discord OAuth Flow integration, enabling agent workflows to authenticate with Discord.
- ›Integrates InternLM models as a supported model backend.
- ›Adds Skywork reward model support for scoring and evaluating agent outputs.
- ›Adds Source2Synth for synthetic data generation from source material.
- ›Adds a structured document loader via
feat: structured loaderfor ingesting structured data into agent pipelines.
+2 moreshow less
- ›Adds free proxies option to the Google Scholar Toolkit to work around access restrictions.
- ›Updates function call result message format for tool-calling responses.
- v0.2.16
camel-ai v0.2.16 adds the Dappier toolkit for real-time AI-powered data access.
└──▷ GET THIS VERSION$ git clone --branch v0.2.16 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.16
- ›Adds
DappierToolkitintegration, enabling agents to query Dappier's real-time data and AI recommendations API.
- ›Adds
- v0.2.15
camel-ai v0.2.15 adds graph sampling via Neo4j, OpenBB and Linkup integrations, new benchmarks, native structured output, and a self-instruct pipeline.
└──▷ GET THIS VERSION$ git clone --branch v0.2.15 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.15
- ›Adds native structured output property to
ChatAgent, enabling schema-enforced responses without post-processing. - ›Adds graph sampling support with Neo4j integration for graph-based retrieval workflows.
- ›Adds time-label support to the NebulaGraph integration.
- ›Integrates Linkup as a new data-source provider.
- ›Integrates OpenBB into the library for financial data access within agentic workflows.
+4 moreshow less
- ›Adds benchmarks API-Bank, APIBench, and Nexus to the benchmarks API.
- ›Adds a preliminary self-instruct pipeline for automated instruction-data generation.
- ›Refactors
ChatAgentinternals (PR #1142). - ›Adds the
o1datagen(CoTDataGenerator) core pipeline for chain-of-thought data generation.
- ›Adds native structured output property to
- v0.2.14
camel-ai v0.2.14 adds an Outlines converter model for structured output and support for the OpenAI O1 model.
└──▷ GET THIS VERSION$ git clone --branch v0.2.14 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.14
- ›Adds
OutlinesConvertermodel for structured output generation via the Outlines integration. - ›Supports the OpenAI O1 model.
- ›Adds
- v0.2.12
camel-ai v0.2.12 adds Brave Search, SGLang, e2b, Stripe, reward models, structured outputs, and HuggingFace dataset upload.
└──▷ GET THIS VERSION$ git clone --branch v0.2.12 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.12
- ›Adds structured output support for
ChatAgentusing the OpenAI beta client, enabling typed response schemas from chat interactions. - ›Adds structured output support for Ollama models, enabling schema-constrained responses from locally hosted Ollama instances.
- ›Integrates the Brave Web Search API into the search toolkit, giving agents a new web-search backend.
- ›Integrates SGLang as a new inference backend in CAMEL.
- ›Integrates e2b as a new code execution/sandbox backend.
+6 moreshow less
- ›Integrates Stripe as a new toolkit, enabling agents to interact with payment workflows.
- ›Adds a reward model component for scoring and evaluating agent outputs.
- ›Adds a data collector for dataset generation pipelines.
- ›Adds a pipeline to fetch and upload data to HuggingFace datasets.
- ›Adds the
llama3.3_70Bmodel to the supported model registry. - ›Adds the GAIA benchmark for evaluating agent capabilities.
- ›Adds structured output support for
- v0.2.11
camel-ai v0.2.11 adds ModelManager scheduling, NVIDIA platform support, Meshy 3D integration, and structured output improvements.
└──▷ GET THIS VERSION$ git clone --branch v0.2.11 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.11
└──▷ USE ITConvert a prompt-response pair into a validated Alpaca training record for fine-tuning dataset construction.from camel.data_collector import AlpacaItem item = AlpacaItem(instruction='Explain XSS', input='', output='Cross-site scripting is...') print(item.model_dump())
- ›Adds
ModelManagerclass to schedule and load-balance calls across multiple model backends. - ›Adds NVIDIA model platform support, expanding available backends alongside existing OpenAI/Azure/Mistral integrations.
- ›Adds
logprobshandling in choice response objects, enabling access to token-level log probabilities from model completions. - ›Adds
AlpacaItempydantic class for easy conversion, validation, and structured Alpaca-format output generation. - ›Supports OpenAI structured output as a typed object, enabling schema-validated responses from OpenAI models.
+5 moreshow less
- ›Expands
CodeExecutionToolkitwith additional interpreter backends beyond the existing default. - ›Integrates Meshy text-to-3D model generation as a new toolkit, allowing agents to produce 3D models from text prompts.
- ›Adds structured logging support throughout the library.
- ›Allows manual addition of filename metadata to documents, with normalized extra metadata fields.
- ›Removes
api_keys_requiredconstraint for Firecrawl integration to support self-hosted deployments.
- ›Adds
- v0.2.10
CAMEL v0.2.10 adds Persona Hub, Runtime tool execution, video reading, DeepSeek/Cohere/Gemini model support, and OpenAI structured output.
└──▷ GET THIS VERSION$ git clone --branch v0.2.10 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.10
- ›Adds support for OpenAI structured output via
camel, enabling agents to receive typed, schema-conforming responses. - ›Adds Runtime abstraction for tool calling, providing a dedicated execution layer for agent tool invocations.
- ›Adds
HumanToolkitfor human-in-the-loop interaction with agents. - ›Supports setting default model and platform from environment variables, removing the need to hardcode model configuration.
- ›Integrates Persona Hub techniques for enhanced agent diversity when generating synthetic agent personas.
+10 moreshow less
- ›Adds
ShareGPTconversation format conversion for exporting agent dialogues. - ›Supports
Text to BaseModelparsing, converting raw text output into structured PydanticBaseModelinstances. - ›Adds OpenAI-compatible embedding support.
- ›Integrates video reading capability for agents to process video content.
- ›Integrates Cohere models as a supported model platform.
- ›Adds support for DeepSeek models.
- ›Adds support for Gemini-Exp-1114 model and updates Gemini implementation with OpenAI compatibility.
- ›Adds
qwqmodel and additional Qwen models to supported model list. - ›Wolfram Alpha toolkit now records
SBSHintStepinfo in step-by-step results. - ›Synthesizes execution of tool calling to provide unified tool-call handling across agent workflows.
- ›Adds support for OpenAI structured output via
- v0.2.7
camel-ai v0.2.7 adds Notion, Apify, Tavily, GitHub, and Data Commons toolkits plus 01 and Qwen model platform support.
└──▷ GET THIS VERSION$ git clone --branch v0.2.7 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.7
└──▷ USE ITPass custom metadata or payload fields through the vector retrieval pipeline using the newextra_payloadparameter.retriever.process(content="https://example.com/doc", extra_payload={"source": "internal", "priority": 1})- ›Adds
extra_payloadparameter to VectorRetriever.process() for passing additional data through the retrieval pipeline. - ›Adds
authorassignment support to the Google Scholar toolkit. - ›New Notion toolkit integration for reading and writing Notion content from agents.
- ›New Apify toolkit integration for running Apify actors from agent workflows.
- ›New Tavily search toolkit integration for web search inside agents.
+7 moreshow less
- ›New GitHub toolkit with GitHub functions for interacting with repositories from agents.
- ›New Data Commons toolkit for querying the Google Data Commons knowledge graph.
- ›Adds support for the 01 model platform.
- ›Adds support for the Qwen model platform.
- ›Adds OpenAI tool schema generation capability.
- ›Qdrant vector store enhancements.
- ›WolframAlpha toolkit now returns more detailed output.
- ›Adds
- v0.2.3
camel-ai v0.2.3 adds WhatsApp, Discord, Slack, Arxiv, Google Scholar, AskNews, and Chunkr integrations plus FunctionTool refactor
└──▷ GET THIS VERSION$ git clone --branch v0.2.3 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.3
└──▷ USE ITDrop system_message to spin up a minimal ChatAgent without boilerplate role definition.from camel.agents import ChatAgent agent = ChatAgent() # system_message now optional response = agent.step('Summarize the latest AI news') print(response.msg.content)Wrap a plain Python function as a FunctionTool (formerly OpenAIFunction) and attach it to an agent.from camel.toolkits import FunctionTool from camel.agents import ChatAgent def get_weather(city: str) -> str: return f'Sunny in {city}' tool = FunctionTool(get_weather) agent = ChatAgent(tools=[tool]) response = agent.step('What is the weather in Paris?') print(response.msg.content)- ›Renames
OpenAIFunctiontoFunctionTool, providing a unified interface for defining callable tools across agents. - ›Makes
system_messageoptional inChatAgent, reducing boilerplate for minimal agent setups. - ›Adds
ChatAgentinterface enhancements and a configurable default model setting. - ›New
ArxivToolkitfor querying and retrieving academic papers from arXiv. - ›New
GoogleScholarToolkitfor searching Google Scholar from within agents.
+7 moreshow less
- ›New
AskNewsToolkitfor fetching live news context inside agent workflows. - ›Integrates WhatsApp messaging as a new toolkit for agent-driven communication.
- ›Integrates Discord as a new app toolkit, enabling agents to interact with Discord channels.
- ›Integrates Slack as a new app toolkit, enabling agents to interact with Slack workspaces.
- ›Integrates Chunkr for document chunking and processing workflows.
- ›Adds Mistral
ministral-3bandministral-8bmodel support. - ›Adds AgentOps observability support for SambaNova-hosted models.
└──▷ BREAKING ON UPGRADE- !The
modelparameter inModelFactoryis renamed tomodel_type; any code passingmodel=as a keyword argument will break.
- ›Renames
- v0.2.2
camel-ai v0.2.2 adds Llama tool calling, Nebula Graph integration, Mistral Pixtral support, and bytes handling for vector retrieval.
└──▷ GET THIS VERSION$ git clone --branch v0.2.2 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.2.2
- ›Adds tool calling support for Llama models.
- ›Adds Nebula Graph integration for graph-based storage and retrieval.
- ›Supports the Mistral Pixtral multimodal model.
- ›Adds support for handling bytes input in vector retrieval.
- v0.1.7.0
camel-ai v0.1.7.0 adds object storage, five new model/platform integrations, LinkedIn and Reddit toolkits, and richer RAG controls.
└──▷ GET THIS VERSION$ git clone --branch v0.1.7.0 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.1.7.0
└──▷ USE ITTune retrieval precision in an agent by setting how many chunks to return and a minimum similarity cutoff.from camel.toolkits import RetrievalToolkit toolkit = RetrievalToolkit( top_k=5, similarity_threshold=0.75, )Point camel-ai at any OpenAI-compatible local or third-party endpoint without a custom model class.from camel.models import OpenAICompatibilityModel model = OpenAICompatibilityModel( model_type="llama3", url="http://localhost:11434/v1", api_key="none", )- ›Adds
top_kandsimilarity_thresholdparameters toRetrievalToolkitfor fine-grained retrieval tuning. - ›Adds
max_characterssetting to RAG to cap chunk size during ingestion. - ›Adds subprocess-based local serving support for Ollama and vllm via the new subprocess integration.
- ›Adds
firecrawlmap endpoint support for broader web-crawl coverage. - ›Adds
OpenAICompatibilityModelto support any OpenAI-compatible model endpoint as a drop-in backend.
+10 moreshow less
- ›Integrates Together AI as a supported model platform.
- ›Integrates SambaNova model and SambaVerse API as supported model platforms.
- ›Integrates Reka model as a supported model platform.
- ›Integrates Mistral tool-calling support alongside a Mistral version update.
- ›Adds LinkedIn toolkit for agent-driven LinkedIn interactions.
- ›Adds Reddit toolkit for agent-driven Reddit interactions.
- ›Rebuilds
RecordMemorymodule with updated architecture. - ›Adds object storage support for storing and retrieving agent artifacts.
- ›Enables
AutoRetrieverto accept raw strings and Element objects as input (previously required pre-processed documents). - ›Updates
auto_retrieveroutput format for improved downstream parsing.
- ›Adds
- v0.1.6.1
camel-ai v0.1.6.1 adds Workforce orchestration, Task primitives, Firecrawl integration, multi-modal DALL-E support, and structured function-call responses.
└──▷ GET THIS VERSION$ git clone --branch v0.1.6.1 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.1.6.1
- ›Adds Task class to camel, providing a first-class primitive for defining and managing agent tasks.
- ›Adds Workforce class for orchestrating multiple agents working together on a shared workload.
- ›Integrates Firecrawl as a new tool, enabling agents to crawl and extract web content.
- ›Adds AgentOps observability settings, allowing configuration of AgentOps tracking for agent runs.
- ›Supports structured responses via function calls, enabling agents to return typed, schema-constrained output.
+1 moreshow less
- ›Supports multi-modal input and multi-modal output (including DALL-E image generation) within a single agent.
- v0.1.6.0
camel-ai v0.1.6.0 adds Gemini 1.5, vLLM, Azure OpenAI, Mistral, Groq-hosted Llama 3/Gemma, GPT-4o Mini, and an IPython kernel code interpreter.
└──▷ GET THIS VERSION$ git clone --branch v0.1.6.0 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.1.6.0
- ›Adds
GPT_4O_MINImodel constant for targeting OpenAI's GPT-4o Mini in agents and role-playing sessions. - ›Supports custom token counters via
ModelFactory, letting callers override the default counter at construction time. - ›Adds Azure OpenAI API as a model backend, enabling agents to route requests through Azure-hosted OpenAI endpoints.
- ›Supports vLLM as a model backend for self-hosted, high-throughput inference.
- ›Integrates Gemini 1.5 as a supported model backend.
+4 moreshow less
- ›Integrates Mistral AI as a supported model backend.
- ›Integrates Groq-hosted Llama 3 (8B and 70B), Mistral.AI, and Gemma (7B and 9B) as model backends via the Groq service.
- ›Adds an IPython kernel code interpreter, enabling agents to execute code interactively in an IPython session.
- ›Moves tool functions into a dedicated toolkits directory, providing a cleaner import path for agent toolkits.
- ›Adds
- v0.1.5.5
camel-ai v0.1.5.5 adds Claude 3.5, Redis cache, Docker code execution, Jina Reader, and async utilities
└──▷ GET THIS VERSION$ git clone --branch v0.1.5.5 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.1.5.5
- ›Adds Redis cache storage backend for agent memory and caching workflows.
- ›Supports
internal_pythoncode interpreter as a callable tool, enabling agents to execute code directly. - ›Adds Docker-based code execution sandbox for isolated, safe code running.
- ›Integrates Jina Reader into the loaders API for web content ingestion.
- ›Adds a config file mechanism for models using the OpenAI-compatible interface.
+5 moreshow less
- ›Adds utility functions to convert synchronous functions to async functions.
- ›Adds Claude 3.5 model support.
- ›Adds new open-source models to the supported model list.
- ›Adds a Discord bot with RAG (retrieval-augmented generation) capability.
- ›Updates sentence transformer and OpenAI text embedding integrations.
- v0.1.5.3
camel-ai v0.1.5.3 adds async ChatAgent, VLM embeddings, DuckDuckGo search, Discord/Telegram bots, LiteLLM, Nemotron, ZhipuAI, and GitHub PR retrieval.
└──▷ GET THIS VERSION$ git clone --branch v0.1.5.3 https://github.com/camel-ai/camel.git # already have the repo? check out this version: $ git checkout v0.1.5.3
- ›Integrates VLM (Vision-Language Model) embedding model support.
- ›Adds DuckDuckGo search and enhanced text extraction from websites.
- ›Adds API key support for OpenAPI functions.
- ›Adds more OpenAPI functions and refactors
open_api_function. - ›Adds Discord bot integration.
+7 moreshow less
- ›Adds Telegram bot integration.
- ›Adds support for the LiteLLM library as a model backend.
- ›Integrates Nemotron API as a supported model provider.
- ›Adds ZhipuAI model support.
- ›Adds
retrieve recent pull requestscapability toGithubToolkit. - ›Adds video description function into agent capabilities.
- ›Makes Slack SDK dependency optional.