camel-ai 0.2.75a6__py3-none-any.whl → 0.2.76__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of camel-ai might be problematic. Click here for more details.

Files changed (97) hide show
  1. camel/__init__.py +1 -1
  2. camel/agents/chat_agent.py +1001 -205
  3. camel/agents/mcp_agent.py +30 -27
  4. camel/configs/__init__.py +6 -0
  5. camel/configs/amd_config.py +70 -0
  6. camel/configs/cometapi_config.py +104 -0
  7. camel/data_collectors/alpaca_collector.py +15 -6
  8. camel/environments/tic_tac_toe.py +1 -1
  9. camel/interpreters/__init__.py +2 -0
  10. camel/interpreters/docker/Dockerfile +3 -12
  11. camel/interpreters/microsandbox_interpreter.py +395 -0
  12. camel/loaders/__init__.py +11 -2
  13. camel/loaders/chunkr_reader.py +9 -0
  14. camel/memories/__init__.py +2 -1
  15. camel/memories/agent_memories.py +3 -1
  16. camel/memories/blocks/chat_history_block.py +21 -3
  17. camel/memories/records.py +88 -8
  18. camel/messages/base.py +127 -34
  19. camel/models/__init__.py +4 -0
  20. camel/models/amd_model.py +101 -0
  21. camel/models/azure_openai_model.py +0 -6
  22. camel/models/base_model.py +30 -0
  23. camel/models/cometapi_model.py +83 -0
  24. camel/models/model_factory.py +4 -0
  25. camel/models/openai_compatible_model.py +0 -6
  26. camel/models/openai_model.py +0 -6
  27. camel/models/zhipuai_model.py +61 -2
  28. camel/parsers/__init__.py +18 -0
  29. camel/parsers/mcp_tool_call_parser.py +176 -0
  30. camel/retrievers/auto_retriever.py +1 -0
  31. camel/runtimes/daytona_runtime.py +11 -12
  32. camel/societies/workforce/prompts.py +131 -50
  33. camel/societies/workforce/single_agent_worker.py +434 -49
  34. camel/societies/workforce/structured_output_handler.py +30 -18
  35. camel/societies/workforce/task_channel.py +43 -0
  36. camel/societies/workforce/utils.py +105 -12
  37. camel/societies/workforce/workforce.py +1322 -311
  38. camel/societies/workforce/workforce_logger.py +24 -5
  39. camel/storages/key_value_storages/json.py +15 -2
  40. camel/storages/object_storages/google_cloud.py +1 -1
  41. camel/storages/vectordb_storages/oceanbase.py +10 -11
  42. camel/storages/vectordb_storages/tidb.py +8 -6
  43. camel/tasks/task.py +4 -3
  44. camel/toolkits/__init__.py +18 -5
  45. camel/toolkits/aci_toolkit.py +45 -0
  46. camel/toolkits/code_execution.py +28 -1
  47. camel/toolkits/context_summarizer_toolkit.py +684 -0
  48. camel/toolkits/dingtalk.py +1135 -0
  49. camel/toolkits/edgeone_pages_mcp_toolkit.py +11 -31
  50. camel/toolkits/{file_write_toolkit.py → file_toolkit.py} +194 -34
  51. camel/toolkits/function_tool.py +6 -1
  52. camel/toolkits/google_drive_mcp_toolkit.py +12 -31
  53. camel/toolkits/hybrid_browser_toolkit/config_loader.py +12 -0
  54. camel/toolkits/hybrid_browser_toolkit/hybrid_browser_toolkit.py +79 -2
  55. camel/toolkits/hybrid_browser_toolkit/hybrid_browser_toolkit_ts.py +95 -59
  56. camel/toolkits/hybrid_browser_toolkit/installer.py +203 -0
  57. camel/toolkits/hybrid_browser_toolkit/ts/package-lock.json +5 -612
  58. camel/toolkits/hybrid_browser_toolkit/ts/package.json +0 -1
  59. camel/toolkits/hybrid_browser_toolkit/ts/src/browser-session.ts +619 -95
  60. camel/toolkits/hybrid_browser_toolkit/ts/src/config-loader.ts +7 -2
  61. camel/toolkits/hybrid_browser_toolkit/ts/src/hybrid-browser-toolkit.ts +115 -219
  62. camel/toolkits/hybrid_browser_toolkit/ts/src/parent-child-filter.ts +226 -0
  63. camel/toolkits/hybrid_browser_toolkit/ts/src/snapshot-parser.ts +219 -0
  64. camel/toolkits/hybrid_browser_toolkit/ts/src/som-screenshot-injected.ts +543 -0
  65. camel/toolkits/hybrid_browser_toolkit/ts/src/types.ts +1 -0
  66. camel/toolkits/hybrid_browser_toolkit/ts/websocket-server.js +39 -6
  67. camel/toolkits/hybrid_browser_toolkit/ws_wrapper.py +405 -131
  68. camel/toolkits/hybrid_browser_toolkit_py/hybrid_browser_toolkit.py +9 -5
  69. camel/toolkits/{openai_image_toolkit.py → image_generation_toolkit.py} +98 -31
  70. camel/toolkits/markitdown_toolkit.py +27 -1
  71. camel/toolkits/mcp_toolkit.py +348 -348
  72. camel/toolkits/message_integration.py +3 -0
  73. camel/toolkits/minimax_mcp_toolkit.py +195 -0
  74. camel/toolkits/note_taking_toolkit.py +18 -8
  75. camel/toolkits/notion_mcp_toolkit.py +16 -26
  76. camel/toolkits/origene_mcp_toolkit.py +8 -49
  77. camel/toolkits/playwright_mcp_toolkit.py +12 -31
  78. camel/toolkits/resend_toolkit.py +168 -0
  79. camel/toolkits/slack_toolkit.py +50 -1
  80. camel/toolkits/terminal_toolkit/__init__.py +18 -0
  81. camel/toolkits/terminal_toolkit/terminal_toolkit.py +924 -0
  82. camel/toolkits/terminal_toolkit/utils.py +532 -0
  83. camel/toolkits/vertex_ai_veo_toolkit.py +590 -0
  84. camel/toolkits/video_analysis_toolkit.py +17 -11
  85. camel/toolkits/wechat_official_toolkit.py +483 -0
  86. camel/types/enums.py +124 -1
  87. camel/types/unified_model_type.py +5 -0
  88. camel/utils/commons.py +17 -0
  89. camel/utils/context_utils.py +804 -0
  90. camel/utils/mcp.py +136 -2
  91. camel/utils/token_counting.py +25 -17
  92. {camel_ai-0.2.75a6.dist-info → camel_ai-0.2.76.dist-info}/METADATA +158 -59
  93. {camel_ai-0.2.75a6.dist-info → camel_ai-0.2.76.dist-info}/RECORD +95 -76
  94. camel/loaders/pandas_reader.py +0 -368
  95. camel/toolkits/terminal_toolkit.py +0 -1788
  96. {camel_ai-0.2.75a6.dist-info → camel_ai-0.2.76.dist-info}/WHEEL +0 -0
  97. {camel_ai-0.2.75a6.dist-info → camel_ai-0.2.76.dist-info}/licenses/LICENSE +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: camel-ai
3
- Version: 0.2.75a6
3
+ Version: 0.2.76
4
4
  Summary: Communicative Agents for AI Society Study
5
5
  Project-URL: Homepage, https://www.camel-ai.org/
6
6
  Project-URL: Repository, https://github.com/camel-ai/camel
@@ -10,8 +10,9 @@ License-Expression: Apache-2.0
10
10
  License-File: LICENSE
11
11
  Keywords: ai-societies,artificial-intelligence,communicative-ai,cooperative-ai,deep-learning,large-language-models,multi-agent-systems,natural-language-processing
12
12
  Requires-Python: <3.13,>=3.10
13
+ Requires-Dist: astor>=0.8.1
13
14
  Requires-Dist: colorama<0.5,>=0.4.6
14
- Requires-Dist: docstring-parser<0.16,>=0.15
15
+ Requires-Dist: docstring-parser<0.18,>=0.17.0
15
16
  Requires-Dist: httpx<1.0.0dev,>=0.28.0
16
17
  Requires-Dist: jsonschema<5,>=4
17
18
  Requires-Dist: mcp>=1.3.0
@@ -20,6 +21,7 @@ Requires-Dist: pillow<11.0.0,>=10.1.0
20
21
  Requires-Dist: psutil<6,>=5.9.8
21
22
  Requires-Dist: pydantic>=2.10.6
22
23
  Requires-Dist: tiktoken<0.8,>=0.7.0
24
+ Requires-Dist: websockets<15.1,>=13.0
23
25
  Provides-Extra: all
24
26
  Requires-Dist: aci-sdk>=1.0.0b1; extra == 'all'
25
27
  Requires-Dist: agentops<0.4,>=0.3.21; extra == 'all'
@@ -39,7 +41,7 @@ Requires-Dist: dappier<0.4,>=0.3.3; extra == 'all'
39
41
  Requires-Dist: datacommons-pandas<0.0.4,>=0.0.3; extra == 'all'
40
42
  Requires-Dist: datacommons<2,>=1.4.3; extra == 'all'
41
43
  Requires-Dist: datasets<4,>=3; extra == 'all'
42
- Requires-Dist: daytona-sdk==0.20.0; extra == 'all'
44
+ Requires-Dist: daytona-sdk>=0.20.0; extra == 'all'
43
45
  Requires-Dist: diffusers<0.26,>=0.25.0; extra == 'all'
44
46
  Requires-Dist: discord-py<3,>=2.3.2; extra == 'all'
45
47
  Requires-Dist: docker<8,>=7.1.0; extra == 'all'
@@ -57,6 +59,7 @@ Requires-Dist: flask>=2.0; extra == 'all'
57
59
  Requires-Dist: google-api-python-client==2.166.0; extra == 'all'
58
60
  Requires-Dist: google-auth-httplib2==0.2.0; extra == 'all'
59
61
  Requires-Dist: google-auth-oauthlib==1.2.1; extra == 'all'
62
+ Requires-Dist: google-cloud-aiplatform>=1.111.0; extra == 'all'
60
63
  Requires-Dist: google-cloud-storage<3,>=2.18.0; extra == 'all'
61
64
  Requires-Dist: google-genai>=1.13.0; extra == 'all'
62
65
  Requires-Dist: googlemaps<5,>=4.10.0; extra == 'all'
@@ -73,6 +76,7 @@ Requires-Dist: markitdown>=0.1.1; extra == 'all'
73
76
  Requires-Dist: math-verify<0.8,>=0.7.0; extra == 'all'
74
77
  Requires-Dist: mcp>=1.3.0; extra == 'all'
75
78
  Requires-Dist: mem0ai>=0.1.67; extra == 'all'
79
+ Requires-Dist: microsandbox>=0.1.8; extra == 'all'
76
80
  Requires-Dist: mistralai<2,>=1.1.0; extra == 'all'
77
81
  Requires-Dist: mock<6,>=5; extra == 'all'
78
82
  Requires-Dist: mypy<2,>=1.5.1; extra == 'all'
@@ -84,8 +88,7 @@ Requires-Dist: numpy<=2.2,>=1.2; extra == 'all'
84
88
  Requires-Dist: onnxruntime<=1.19.2; extra == 'all'
85
89
  Requires-Dist: openapi-spec-validator<0.8,>=0.7.1; extra == 'all'
86
90
  Requires-Dist: openpyxl>=3.1.5; extra == 'all'
87
- Requires-Dist: pandas<2,>=1.5.3; extra == 'all'
88
- Requires-Dist: pandasai<3,>=2.3.0; extra == 'all'
91
+ Requires-Dist: pandas>=2; extra == 'all'
89
92
  Requires-Dist: pgvector<0.3,>=0.2.4; extra == 'all'
90
93
  Requires-Dist: playwright>=1.50.0; extra == 'all'
91
94
  Requires-Dist: prance<24,>=23.6.21.0; extra == 'all'
@@ -107,13 +110,14 @@ Requires-Dist: pytest-asyncio<0.24,>=0.23.0; extra == 'all'
107
110
  Requires-Dist: pytest-cov<5,>=4; extra == 'all'
108
111
  Requires-Dist: pytest<8,>=7; extra == 'all'
109
112
  Requires-Dist: python-pptx>=1.0.2; extra == 'all'
110
- Requires-Dist: pytidb-experimental==0.0.1.dev4; extra == 'all'
113
+ Requires-Dist: pytidb>=0.0.13; extra == 'all'
111
114
  Requires-Dist: qdrant-client<2,>=1.9.0; extra == 'all'
112
115
  Requires-Dist: rank-bm25<0.3,>=0.2.2; extra == 'all'
113
116
  Requires-Dist: redis<6,>=5.0.6; extra == 'all'
114
117
  Requires-Dist: reka-api<4,>=3.0.8; extra == 'all'
115
118
  Requires-Dist: reportlab>=4.4.2; extra == 'all'
116
119
  Requires-Dist: requests-oauthlib<2,>=1.3.1; extra == 'all'
120
+ Requires-Dist: resend<3,>=2.0.0; extra == 'all'
117
121
  Requires-Dist: rlcard<1.3.0,>=1.0.0; extra == 'all'
118
122
  Requires-Dist: rouge<2,>=1.0.1; extra == 'all'
119
123
  Requires-Dist: scenedetect>=0.6.5.2; extra == 'all'
@@ -152,6 +156,7 @@ Requires-Dist: notion-client<3,>=2.2.1; extra == 'communication-tools'
152
156
  Requires-Dist: praw<8,>=7.7.1; extra == 'communication-tools'
153
157
  Requires-Dist: pygithub<3,>=2.6.0; extra == 'communication-tools'
154
158
  Requires-Dist: pytelegrambotapi<5,>=4.18.0; extra == 'communication-tools'
159
+ Requires-Dist: resend<3,>=2.0.0; extra == 'communication-tools'
155
160
  Requires-Dist: slack-bolt<2,>=1.20.1; extra == 'communication-tools'
156
161
  Requires-Dist: slack-sdk<4,>=3.27.2; extra == 'communication-tools'
157
162
  Provides-Extra: data-tools
@@ -161,7 +166,7 @@ Requires-Dist: datacommons<2,>=1.4.3; extra == 'data-tools'
161
166
  Requires-Dist: math-verify<0.8,>=0.7.0; extra == 'data-tools'
162
167
  Requires-Dist: networkx<4,>=3.4.2; extra == 'data-tools'
163
168
  Requires-Dist: numpy<=2.2,>=1.2; extra == 'data-tools'
164
- Requires-Dist: pandas<2,>=1.5.3; extra == 'data-tools'
169
+ Requires-Dist: pandas>=2; extra == 'data-tools'
165
170
  Requires-Dist: rouge<2,>=1.0.1; extra == 'data-tools'
166
171
  Requires-Dist: stripe<12,>=11.3.0; extra == 'data-tools'
167
172
  Requires-Dist: textblob<0.18,>=0.17.1; extra == 'data-tools'
@@ -186,13 +191,14 @@ Requires-Dist: uv<0.8,>=0.7.0; extra == 'dev'
186
191
  Provides-Extra: dev-tools
187
192
  Requires-Dist: aci-sdk>=1.0.0b1; extra == 'dev-tools'
188
193
  Requires-Dist: agentops<0.4,>=0.3.21; extra == 'dev-tools'
189
- Requires-Dist: daytona-sdk==0.20.0; extra == 'dev-tools'
194
+ Requires-Dist: daytona-sdk>=0.20.0; extra == 'dev-tools'
190
195
  Requires-Dist: docker<8,>=7.1.0; extra == 'dev-tools'
191
196
  Requires-Dist: e2b-code-interpreter<2,>=1.0.3; extra == 'dev-tools'
192
197
  Requires-Dist: ipykernel<7,>=6.0.0; extra == 'dev-tools'
193
198
  Requires-Dist: jupyter-client<9,>=8.6.2; extra == 'dev-tools'
194
199
  Requires-Dist: langfuse>=2.60.5; extra == 'dev-tools'
195
200
  Requires-Dist: mcp>=1.3.0; extra == 'dev-tools'
201
+ Requires-Dist: microsandbox>=0.1.8; extra == 'dev-tools'
196
202
  Requires-Dist: tree-sitter-python<0.24,>=0.23.6; extra == 'dev-tools'
197
203
  Requires-Dist: tree-sitter<0.24,>=0.23.2; extra == 'dev-tools'
198
204
  Requires-Dist: typer>=0.15.2; extra == 'dev-tools'
@@ -214,7 +220,6 @@ Requires-Dist: numpy<=2.2,>=1.2; extra == 'document-tools'
214
220
  Requires-Dist: onnxruntime<=1.19.2; extra == 'document-tools'
215
221
  Requires-Dist: openapi-spec-validator<0.8,>=0.7.1; extra == 'document-tools'
216
222
  Requires-Dist: openpyxl>=3.1.5; extra == 'document-tools'
217
- Requires-Dist: pandasai<3,>=2.3.0; extra == 'document-tools'
218
223
  Requires-Dist: prance<24,>=23.6.21.0; extra == 'document-tools'
219
224
  Requires-Dist: pylatex>=1.4.2; extra == 'document-tools'
220
225
  Requires-Dist: pymupdf<2,>=1.22.5; extra == 'document-tools'
@@ -230,6 +235,8 @@ Requires-Dist: docx>=0.2.4; extra == 'eigent'
230
235
  Requires-Dist: exa-py<2,>=1.10.0; extra == 'eigent'
231
236
  Requires-Dist: ffmpeg-python<0.3,>=0.2.0; extra == 'eigent'
232
237
  Requires-Dist: google-api-python-client==2.166.0; extra == 'eigent'
238
+ Requires-Dist: google-auth-httplib2==0.2.0; extra == 'eigent'
239
+ Requires-Dist: google-auth-oauthlib==1.2.1; extra == 'eigent'
233
240
  Requires-Dist: imageio[pyav]<3,>=2.34.2; extra == 'eigent'
234
241
  Requires-Dist: markitdown[all]>=0.1.1; extra == 'eigent'
235
242
  Requires-Dist: mcp-server-fetch==2025.1.17; extra == 'eigent'
@@ -237,7 +244,7 @@ Requires-Dist: mcp-simple-arxiv==0.2.2; extra == 'eigent'
237
244
  Requires-Dist: numpy<=2.2,>=1.2; extra == 'eigent'
238
245
  Requires-Dist: onnxruntime<=1.19.2; extra == 'eigent'
239
246
  Requires-Dist: openpyxl>=3.1.5; extra == 'eigent'
240
- Requires-Dist: pandas<2,>=1.5.3; extra == 'eigent'
247
+ Requires-Dist: pandas>=2; extra == 'eigent'
241
248
  Requires-Dist: pydub<0.26,>=0.25.1; extra == 'eigent'
242
249
  Requires-Dist: pylatex>=1.4.2; extra == 'eigent'
243
250
  Requires-Dist: pytesseract>=0.3.13; extra == 'eigent'
@@ -297,8 +304,7 @@ Requires-Dist: numpy<=2.2,>=1.2; extra == 'owl'
297
304
  Requires-Dist: onnxruntime<=1.19.2; extra == 'owl'
298
305
  Requires-Dist: openapi-spec-validator<0.8,>=0.7.1; extra == 'owl'
299
306
  Requires-Dist: openpyxl>=3.1.5; extra == 'owl'
300
- Requires-Dist: pandas<2,>=1.5.3; extra == 'owl'
301
- Requires-Dist: pandasai<3,>=2.3.0; extra == 'owl'
307
+ Requires-Dist: pandas>=2; extra == 'owl'
302
308
  Requires-Dist: playwright>=1.50.0; extra == 'owl'
303
309
  Requires-Dist: prance<24,>=23.6.21.0; extra == 'owl'
304
310
  Requires-Dist: pyautogui<0.10,>=0.9.54; extra == 'owl'
@@ -335,11 +341,10 @@ Requires-Dist: google-genai>=1.13.0; extra == 'rag'
335
341
  Requires-Dist: nebula3-python==3.8.2; extra == 'rag'
336
342
  Requires-Dist: neo4j<6,>=5.18.0; extra == 'rag'
337
343
  Requires-Dist: numpy<=2.2,>=1.2; extra == 'rag'
338
- Requires-Dist: pandasai<3,>=2.3.0; extra == 'rag'
339
344
  Requires-Dist: protobuf>=6.0.0; extra == 'rag'
340
345
  Requires-Dist: pymilvus<3,>=2.4.0; extra == 'rag'
341
346
  Requires-Dist: pyobvector>=0.1.18; extra == 'rag'
342
- Requires-Dist: pytidb-experimental==0.0.1.dev4; extra == 'rag'
347
+ Requires-Dist: pytidb>=0.0.13; extra == 'rag'
343
348
  Requires-Dist: qdrant-client<2,>=1.9.0; extra == 'rag'
344
349
  Requires-Dist: rank-bm25<0.3,>=0.2.2; extra == 'rag'
345
350
  Requires-Dist: unstructured==0.16.20; extra == 'rag'
@@ -362,7 +367,7 @@ Requires-Dist: protobuf>=6.0.0; extra == 'storage'
362
367
  Requires-Dist: psycopg[binary]<4,>=3.1.18; extra == 'storage'
363
368
  Requires-Dist: pymilvus<3,>=2.4.0; extra == 'storage'
364
369
  Requires-Dist: pyobvector>=0.1.18; extra == 'storage'
365
- Requires-Dist: pytidb-experimental==0.0.1.dev4; extra == 'storage'
370
+ Requires-Dist: pytidb>=0.0.13; extra == 'storage'
366
371
  Requires-Dist: qdrant-client<2,>=1.9.0; extra == 'storage'
367
372
  Requires-Dist: redis<6,>=5.0.6; extra == 'storage'
368
373
  Requires-Dist: surrealdb>=1.0.6; extra == 'storage'
@@ -411,9 +416,14 @@ Description-Content-Type: text/markdown
411
416
  [![Star][star-image]][star-url]
412
417
  [![Package License][package-license-image]][package-license-url]
413
418
  [![PyPI Download][package-download-image]][package-download-url]
419
+ [![][join-us-image]][join-us]
414
420
 
415
421
  <a href="https://trendshift.io/repositories/649" target="_blank"><img src="https://trendshift.io/api/badge/repositories/649" alt="camel-ai/camel | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
416
422
 
423
+ [English](README.md) |
424
+ [简体中文](README.zh.md) |
425
+ [日本語](README.ja.md)
426
+
417
427
  </div>
418
428
 
419
429
 
@@ -445,12 +455,54 @@ Join us ([*Discord*](https://discord.camel-ai.org/) or [*WeChat*](https://ghli.o
445
455
  </div>
446
456
 
447
457
  <div align="center">
448
- <img src="docs/images/star.gif" alt="Star" width="186" height="60">
458
+ <img src="docs/images/stars.gif" alt="Star">
449
459
  </a>
450
460
  </div>
451
461
 
452
462
  <br>
453
463
 
464
+ [![][image-join-us]][join-us]
465
+
466
+ <details>
467
+ <summary><kbd>Table of contents</kbd></summary>
468
+
469
+ <br/>
470
+
471
+ - [CAMEL Framework Design Principles](#camel-framework-design-principles)
472
+ - [Why Use CAMEL for Your Research?](#why-use-camel-for-your-research)
473
+ - [What Can You Build With CAMEL?](#what-can-you-build-with-camel)
474
+ - [Data Generation](#1-data-generation)
475
+ - [Task Automation](#2-task-automation)
476
+ - [World Simulation](#3-world-simulation)
477
+ - [Quick Start](#quick-start)
478
+ - [Starting with ChatAgent](#starting-with-chatagent)
479
+ - [Seeking Help](#seeking-help)
480
+ - [Tech Stack](#tech-stack)
481
+ - [Research](#research)
482
+ - [Synthetic Datasets](#synthetic-datasets)
483
+ - [Cookbooks (Usecases)](#cookbooks-usecases)
484
+ - [Basic Concepts](#1-basic-concepts)
485
+ - [Advanced Features](#2-advanced-features)
486
+ - [Model Training & Data Generation](#3-model-training--data-generation)
487
+ - [Multi-Agent Systems & Applications](#4-multi-agent-systems--applications)
488
+ - [Data Processing](#5-data-processing)
489
+ - [Real-World Usecases](#real-world-usecases)
490
+ - [🧱 Built with CAMEL (Real-world Producs & Research)](#-built-with-camel-real-world-producs--research)
491
+ - [Research Projects](#research-projects)
492
+ - [Product Projects](#product-projects)
493
+ - [🗓️ Events](#️-events)
494
+ - [Contributing to CAMEL](#contributing-to-camel)
495
+ - [Community & Contact](#community--contact)
496
+ - [Citation](#citation)
497
+ - [Acknowledgment](#acknowledgment)
498
+ - [License](#license)
499
+
500
+ ####
501
+
502
+ <br/>
503
+
504
+ </details>
505
+
454
506
 
455
507
  ## CAMEL Framework Design Principles
456
508
 
@@ -560,7 +612,7 @@ We are a community-driven research collective comprising over 100 researchers de
560
612
  </div>
561
613
 
562
614
  <div align="center">
563
- <a href="https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_rag.html">
615
+ <a href="https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_rag">
564
616
  <img src="docs/images/rag_pipeline.png" alt="RAG Pipeline">
565
617
  </a>
566
618
  </div>
@@ -600,6 +652,13 @@ This example demonstrates how to create a `ChatAgent` using the CAMEL framework
600
652
  export OPENAI_API_KEY='your_openai_api_key'
601
653
  ```
602
654
 
655
+ Alternatively, use a `.env` file:
656
+
657
+ ```bash
658
+ cp .env.example .env
659
+ # then edit .env and add your keys
660
+ ```
661
+
603
662
  3. **Run the following Python code:**
604
663
 
605
664
  ```python
@@ -639,10 +698,10 @@ We provide a [![Google Colab](https://colab.research.google.com/assets/colab-bad
639
698
 
640
699
  Explore different types of agents, their roles, and their applications.
641
700
 
642
- - **[Creating Your First Agent](https://docs.camel-ai.org/cookbooks/basic_concepts/create_your_first_agent.html)**
643
- - **[Creating Your First Agent Society](https://docs.camel-ai.org/cookbooks/basic_concepts/create_your_first_agents_society.html)**
644
- - **[Embodied Agents](https://docs.camel-ai.org/cookbooks/advanced_features/embodied_agents.html)**
645
- - **[Critic Agents](https://docs.camel-ai.org/cookbooks/advanced_features/critic_agents_and_tree_search.html)**
701
+ - **[Creating Your First Agent](https://docs.camel-ai.org/cookbooks/basic_concepts/create_your_first_agent)**
702
+ - **[Creating Your First Agent Society](https://docs.camel-ai.org/cookbooks/basic_concepts/create_your_first_agents_society)**
703
+ - **[Embodied Agents](https://docs.camel-ai.org/cookbooks/advanced_features/embodied_agents)**
704
+ - **[Critic Agents](https://docs.camel-ai.org/cookbooks/advanced_features/critic_agents_and_tree_search)**
646
705
 
647
706
  ### Seeking Help
648
707
 
@@ -663,19 +722,19 @@ Core components and utilities to build, operate, and enhance CAMEL-AI agents and
663
722
 
664
723
  | Module | Description |
665
724
  |:---|:---|
666
- | **[Agents](https://docs.camel-ai.org/key_modules/agents.html)** | Core agent architectures and behaviors for autonomous operation. |
667
- | **[Agent Societies](https://docs.camel-ai.org/key_modules/society.html)** | Components for building and managing multi-agent systems and collaboration. |
668
- | **[Data Generation](https://docs.camel-ai.org/key_modules/datagen.html)** | Tools and methods for synthetic data creation and augmentation. |
669
- | **[Models](https://docs.camel-ai.org/key_modules/models.html)** | Model architectures and customization options for agent intelligence. |
670
- | **[Tools](https://docs.camel-ai.org/key_modules/tools.html)** | Tools integration for specialized agent tasks. |
671
- | **[Memory](https://docs.camel-ai.org/key_modules/memory.html)** | Memory storage and retrieval mechanisms for agent state management. |
672
- | **[Storage](https://docs.camel-ai.org/key_modules/storages.html)** | Persistent storage solutions for agent data and states. |
725
+ | **[Agents](https://docs.camel-ai.org/key_modules/agents)** | Core agent architectures and behaviors for autonomous operation. |
726
+ | **[Agent Societies](https://docs.camel-ai.org/key_modules/society)** | Components for building and managing multi-agent systems and collaboration. |
727
+ | **[Data Generation](https://docs.camel-ai.org/key_modules/datagen)** | Tools and methods for synthetic data creation and augmentation. |
728
+ | **[Models](https://docs.camel-ai.org/key_modules/models)** | Model architectures and customization options for agent intelligence. |
729
+ | **[Tools](https://docs.camel-ai.org/key_modules/tools)** | Tools integration for specialized agent tasks. |
730
+ | **[Memory](https://docs.camel-ai.org/key_modules/memory)** | Memory storage and retrieval mechanisms for agent state management. |
731
+ | **[Storage](https://docs.camel-ai.org/key_modules/storages)** | Persistent storage solutions for agent data and states. |
673
732
  | **[Benchmarks](https://github.com/camel-ai/camel/tree/master/camel/benchmarks)** | Performance evaluation and testing frameworks. |
674
- | **[Interpreters](https://docs.camel-ai.org/key_modules/interpreters.html)** | Code and command interpretation capabilities. |
675
- | **[Data Loaders](https://docs.camel-ai.org/key_modules/loaders.html)** | Data ingestion and preprocessing tools. |
676
- | **[Retrievers](https://docs.camel-ai.org/key_modules/retrievers.html)** | Knowledge retrieval and RAG components. |
733
+ | **[Interpreters](https://docs.camel-ai.org/key_modules/interpreters)** | Code and command interpretation capabilities. |
734
+ | **[Data Loaders](https://docs.camel-ai.org/key_modules/loaders)** | Data ingestion and preprocessing tools. |
735
+ | **[Retrievers](https://docs.camel-ai.org/key_modules/retrievers)** | Knowledge retrieval and RAG components. |
677
736
  | **[Runtime](https://github.com/camel-ai/camel/tree/master/camel/runtime)** | Execution environment and process management. |
678
- | **[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. |
737
+ | **[Human-in-the-Loop](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_human_in_loop_and_tool_approval)** | Interactive components for human oversight and intervention. |
679
738
  ---
680
739
 
681
740
  ## Research
@@ -684,6 +743,18 @@ We believe that studying these agents on a large scale offers valuable insights
684
743
 
685
744
  **Explore our research projects:**
686
745
 
746
+ <div align="center">
747
+ <a href="https://github.com/camel-ai/owl">
748
+ <img src="docs/images/owl.png" alt="OWL">
749
+ </a>
750
+ </div>
751
+
752
+ <div align="center">
753
+ <a href="https://oasis.camel-ai.org/">
754
+ <img src="docs/images/oasis.png" alt="OASIS">
755
+ </a>
756
+ </div>
757
+
687
758
  <div align="center">
688
759
  <a href="https://crab.camel-ai.org/">
689
760
  <img src="docs/images/crab.png" alt="CRAB">
@@ -691,14 +762,14 @@ We believe that studying these agents on a large scale offers valuable insights
691
762
  </div>
692
763
 
693
764
  <div align="center">
694
- <a href="https://agent-trust.camel-ai.org/">
695
- <img src="docs/images/agent_trust.png" alt="Agent Trust">
765
+ <a href="https://github.com/camel-ai/loong">
766
+ <img src="docs/images/loong.png" alt="Loong">
696
767
  </a>
697
768
  </div>
698
769
 
699
770
  <div align="center">
700
- <a href="https://oasis.camel-ai.org/">
701
- <img src="docs/images/oasis.png" alt="OASIS">
771
+ <a href="https://agent-trust.camel-ai.org/">
772
+ <img src="docs/images/agent_trust.png" alt="Agent Trust">
702
773
  </a>
703
774
  </div>
704
775
 
@@ -724,7 +795,7 @@ We believe that studying these agents on a large scale offers valuable insights
724
795
 
725
796
  ### 1. Utilize Various LLMs as Backends
726
797
 
727
- For more details, please see our [`Models Documentation`](https://docs.camel-ai.org/key_modules/models.html#).
798
+ For more details, please see our [`Models Documentation`](https://docs.camel-ai.org/key_modules/models#).
728
799
 
729
800
  > **Data (Hosted on Hugging Face)**
730
801
 
@@ -753,42 +824,42 @@ Practical guides and tutorials for implementing specific functionalities in CAME
753
824
  ### 1. Basic Concepts
754
825
  | Cookbook | Description |
755
826
  |:---|:---|
756
- | **[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. |
757
- | **[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. |
758
- | **[Message Cookbook](https://docs.camel-ai.org/cookbooks/basic_concepts/agents_message.html)** | Best practices for message handling in agents. |
827
+ | **[Creating Your First Agent](https://docs.camel-ai.org/cookbooks/basic_concepts/create_your_first_agent)** | A step-by-step guide to building your first agent. |
828
+ | **[Creating Your First Agent Society](https://docs.camel-ai.org/cookbooks/basic_concepts/create_your_first_agents_society)** | Learn to build a collaborative society of agents. |
829
+ | **[Message Cookbook](https://docs.camel-ai.org/cookbooks/basic_concepts/agents_message)** | Best practices for message handling in agents. |
759
830
 
760
831
  ### 2. Advanced Features
761
832
  | Cookbook | Description |
762
833
  |:---|:---|
763
- | **[Tools Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_tools.html)** | Integrating tools for enhanced functionality. |
764
- | **[Memory Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_memory.html)** | Implementing memory systems in agents. |
765
- | **[RAG Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_rag.html)** | Recipes for Retrieval-Augmented Generation. |
766
- | **[Graph RAG Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_graph_rag.html)** | Leveraging knowledge graphs with RAG. |
767
- | **[Track CAMEL Agents with AgentOps](https://docs.camel-ai.org/cookbooks/advanced_features/agents_tracking.html)** | Tools for tracking and managing agents in operations. |
834
+ | **[Tools Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_tools)** | Integrating tools for enhanced functionality. |
835
+ | **[Memory Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_memory)** | Implementing memory systems in agents. |
836
+ | **[RAG Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_rag)** | Recipes for Retrieval-Augmented Generation. |
837
+ | **[Graph RAG Cookbook](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_graph_rag)** | Leveraging knowledge graphs with RAG. |
838
+ | **[Track CAMEL Agents with AgentOps](https://docs.camel-ai.org/cookbooks/advanced_features/agents_tracking)** | Tools for tracking and managing agents in operations. |
768
839
 
769
840
  ### 3. Model Training & Data Generation
770
841
  | Cookbook | Description |
771
842
  |:---|:---|
772
- | **[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. |
773
- | **[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. |
774
- | **[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. |
775
- | **[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. |
843
+ | **[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)** | Learn how to generate data with CAMEL and fine-tune models effectively with Unsloth. |
844
+ | **[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)** | Explore how to generate data with real function calls and the Hermes format. |
845
+ | **[CoT Data Generation and Upload Data to Huggingface](https://docs.camel-ai.org/cookbooks/data_generation/distill_math_reasoning_data_from_deepseek_r1)** | Uncover how to generate CoT data with CAMEL and seamlessly upload it to Huggingface. |
846
+ | **[CoT Data Generation and SFT Qwen with Unsolth](https://docs.camel-ai.org/cookbooks/data_generation/cot_data_gen_sft_qwen_unsolth_upload_huggingface)** | Discover how to generate CoT data using CAMEL and SFT Qwen with Unsolth, and seamlessly upload your data and model to Huggingface. |
776
847
 
777
848
  ### 4. Multi-Agent Systems & Applications
778
849
  | Cookbook | Description |
779
850
  |:---|:---|
780
- | **[Role-Playing Scraper for Report & Knowledge Graph Generation](https://docs.camel-ai.org/cookbooks/applications/roleplaying_scraper.html)** | Create role-playing agents for data scraping and reporting. |
781
- | **[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. |
782
- | **[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. |
783
- | **[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. |
784
- | **[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. |
851
+ | **[Role-Playing Scraper for Report & Knowledge Graph Generation](https://docs.camel-ai.org/cookbooks/applications/roleplaying_scraper)** | Create role-playing agents for data scraping and reporting. |
852
+ | **[Create A Hackathon Judge Committee with Workforce](https://docs.camel-ai.org/cookbooks/multi_agent_society/workforce_judge_committee)** | Building a team of agents for collaborative judging. |
853
+ | **[Dynamic Knowledge Graph Role-Playing: Multi-Agent System with dynamic, temporally-aware knowledge graphs](https://docs.camel-ai.org/cookbooks/advanced_features/agents_with_dkg)** | 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. |
854
+ | **[Customer Service Discord Bot with Agentic RAG](https://docs.camel-ai.org/cookbooks/applications/customer_service_Discord_bot_using_SambaNova_with_agentic_RAG)** | Learn how to build a robust customer service bot for Discord using Agentic RAG. |
855
+ | **[Customer Service Discord Bot with Local Model](https://docs.camel-ai.org/cookbooks/applications/customer_service_Discord_bot_using_local_model_with_agentic_RAG)** | Learn how to build a robust customer service bot for Discord using Agentic RAG which supports local deployment. |
785
856
 
786
857
  ### 5. Data Processing
787
858
  | Cookbook | Description |
788
859
  |:---|:---|
789
- | **[Video Analysis](https://docs.camel-ai.org/cookbooks/data_processing/video_analysis.html)** | Techniques for agents in video data analysis. |
790
- | **[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. |
791
- | **[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. |
860
+ | **[Video Analysis](https://docs.camel-ai.org/cookbooks/data_processing/video_analysis)** | Techniques for agents in video data analysis. |
861
+ | **[3 Ways to Ingest Data from Websites with Firecrawl](https://docs.camel-ai.org/cookbooks/data_processing/ingest_data_from_websites_with_Firecrawl)** | Explore three methods for extracting and processing data from websites using Firecrawl. |
862
+ | **[Create AI Agents that work with your PDFs](https://docs.camel-ai.org/cookbooks/data_processing/agent_with_chunkr_for_pdf_parsing)** | Learn how to create AI agents that work with your PDFs using Chunkr and Mistral AI. |
792
863
 
793
864
  <br>
794
865
 
@@ -832,6 +903,31 @@ Real-world usecases demonstrating how CAMEL’s multi-agent framework enables re
832
903
 
833
904
  <br>
834
905
 
906
+ ## 🧱 Built with CAMEL (Real-world Producs & Research)
907
+ <div align="left">
908
+ <a href="https://www.camel-ai.org/">
909
+ <img src="docs/images/built_with_CAMEL.png" alt="Built with CAMEL" height="40px">
910
+ </a>
911
+ </div>
912
+
913
+ ### Research Projects
914
+
915
+ | Name | Description |
916
+ |:---|:---|
917
+ | **[ChatDev](https://github.com/OpenBMB/ChatDev/tree/main/camel)** | Communicative Agents for software Development |
918
+ | **[Paper2Poster](https://github.com/Paper2Poster/Paper2Poster)** | Multimodal poster automation from scientific papers |
919
+
920
+ ### Product Projects
921
+
922
+ | Name | Description |
923
+ |:---|:---|
924
+ | **[Eigent](https://www.eigent.ai/)** | The World First Multi-agent Workforce |
925
+ | **[EigentBot](https://bot.eigent.ai/)** | One EigentBot,
926
+ Every Code Answer |
927
+ | **[Matrix](https://matrix.eigent.ai/)** | Social Media Simulation |
928
+ | **[AI Geometric](https://www.linkedin.com/posts/aigeometric_ai-interviewpreparation-careerdevelopment-activity-7261428422516555776-MtaK/?utm_source=share&utm_medium=member_desktop&rcm=ACoAAChHluEB9xRwkjiJ6VSAzqM2Y-U4NI2sKGY)** | AI-powered interview copilot |
929
+ | **[Log10](https://github.com/log10-io/log10/blob/main/src/log10/agents/camel.py)** | AI accuracy, delivered |
930
+
835
931
 
836
932
  ## 🗓️ Events
837
933
 
@@ -904,7 +1000,7 @@ The source code is licensed under Apache 2.0.
904
1000
  <br>
905
1001
 
906
1002
  [docs-image]: https://img.shields.io/badge/Documentation-EB3ECC
907
- [docs-url]: https://camel-ai.github.io/camel/index.html
1003
+ [docs-url]: https://camel-ai.github.io/camel/index
908
1004
  [star-image]: https://img.shields.io/github/stars/camel-ai/camel?label=stars&logo=github&color=brightgreen
909
1005
  [star-url]: https://github.com/camel-ai/camel/stargazers
910
1006
  [package-license-image]: https://img.shields.io/badge/License-Apache_2.0-blue.svg
@@ -925,4 +1021,7 @@ The source code is licensed under Apache 2.0.
925
1021
  [reddit-url]: https://www.reddit.com/r/CamelAI/
926
1022
  [reddit-image]: https://img.shields.io/reddit/subreddit-subscribers/CamelAI?style=plastic&logo=reddit&label=r%2FCAMEL&labelColor=white
927
1023
  [ambassador-url]: https://www.camel-ai.org/community
928
- [package-download-url]: https://pypi.org/project/camel-ai
1024
+ [package-download-url]: https://pypi.org/project/camel-ai
1025
+ [join-us]:https://eigent-ai.notion.site/eigent-ai-careers
1026
+ [join-us-image]:https://img.shields.io/badge/Join%20Us-yellow?style=plastic
1027
+ [image-join-us]: https://camel-ai.github.io/camel_asset/graphics/join_us.png