camel-ai 0.2.36__tar.gz → 0.2.37__tar.gz

{camel_ai-0.2.36 → camel_ai-0.2.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: camel-ai
-Version: 0.2.36
+Version: 0.2.37
 Summary: Communicative Agents for AI Society Study
 Project-URL: Homepage, https://www.camel-ai.org/
 Project-URL: Repository, https://github.com/camel-ai/camel
@@ -79,7 +79,7 @@ Requires-Dist: prance<24,>=23.6.21.0; extra == 'all'
 Requires-Dist: praw<8,>=7.7.1; extra == 'all'
 Requires-Dist: pre-commit<4,>=3; extra == 'all'
 Requires-Dist: pydub<0.26,>=0.25.1; extra == 'all'
-Requires-Dist: pygithub<3,>=2.3.0; extra == 'all'
+Requires-Dist: pygithub<3,>=2.6.0; extra == 'all'
 Requires-Dist: pymilvus<3,>=2.4.0; extra == 'all'
 Requires-Dist: pymupdf<2,>=1.22.5; extra == 'all'
 Requires-Dist: pyowm<4,>=3.3.0; extra == 'all'
@@ -125,7 +125,7 @@ Provides-Extra: communication-tools
 Requires-Dist: discord-py<3,>=2.3.2; extra == 'communication-tools'
 Requires-Dist: notion-client<3,>=2.2.1; extra == 'communication-tools'
 Requires-Dist: praw<8,>=7.7.1; extra == 'communication-tools'
-Requires-Dist: pygithub<3,>=2.3.0; extra == 'communication-tools'
+Requires-Dist: pygithub<3,>=2.6.0; extra == 'communication-tools'
 Requires-Dist: pytelegrambotapi<5,>=4.18.0; extra == 'communication-tools'
 Requires-Dist: slack-bolt<2,>=1.20.1; extra == 'communication-tools'
 Requires-Dist: slack-sdk<4,>=3.27.2; extra == 'communication-tools'
@@ -445,9 +445,56 @@ Installing CAMEL is a breeze thanks to its availability on PyPI. Simply open you
 pip install camel-ai
 ```
 
+### Starting with ChatAgent
+
+This example demonstrates how to create a `ChatAgent` using the CAMEL framework and perform a search query using DuckDuckGo.
+
+1. **Install the tools package:**
+
+  ```bash
+  pip install 'camel-ai[web_tools]'
+  ```
+
+2. **Set up your OpenAI API key:**
+
+  ```bash
+  export OPENAI_API_KEY='your_openai_api_key'
+  ```
+
+3. **Run the following Python code:**
+
+  ```python
+  from camel.models import ModelFactory
+  from camel.types import ModelPlatformType, ModelType
+  from camel.agents import ChatAgent
+  from camel.toolkits import SearchToolkit
+
+  model = ModelFactory.create(
+    model_platform=ModelPlatformType.OPENAI,
+    model_type=ModelType.GPT_4O,
+    model_config_dict={"temperature": 0.0},
+  )
+
+  search_tool = SearchToolkit().search_duckduckgo
+
+  agent = ChatAgent(model=model, tools=[search_tool])
+
+  response_1 = agent.step("What is CAMEL-AI?")
+  print(response_1.msgs[0].content)
+  # CAMEL-AI is the first LLM (Large Language Model) multi-agent framework
+  # and an open-source community focused on finding the scaling laws of agents.
+  # ...
+
+  response_2 = agent.step("What is the Github link to CAMEL framework?")
+  print(response_2.msgs[0].content)
+  # The GitHub link to the CAMEL framework is
+  # [https://github.com/camel-ai/camel](https://github.com/camel-ai/camel).
+  ```
+
+
 For more detailed instructions and additional configuration options, check out the [installation section](https://github.com/camel-ai/camel/blob/master/docs/get_started/installation.md).
 
-After running, you can explore our CAMEL Tech Stack and Cookbooks at [www.docs.camel-ai.org](https://docs.camel-ai.org) to build powerful multi-agent systems.
+After running, you can explore our CAMEL Tech Stack and Cookbooks at [docs.camel-ai.org](https://docs.camel-ai.org) to build powerful multi-agent systems.
 
 We provide a [![Google Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1AzP33O8rnMW__7ocWJhVBXjKziJXPtim?usp=sharing) demo showcasing a conversation between two ChatGPT agents playing roles as a python programmer and a stock trader collaborating on developing a trading bot for stock market.
 
@@ -505,7 +552,7 @@ We believe that studying these agents on a large scale offers valuable insights
 </div>
 
 <div align="center">
-  <a href="https://www.agent-trust.camel-ai.org/">
+  <a href="https://agent-trust.camel-ai.org/">
     <img src="docs/images/agent_trust.png" alt="Agent Trust">
   </a>
 </div>

{camel_ai-0.2.36 → camel_ai-0.2.37}/README.md

@@ -187,9 +187,56 @@ Installing CAMEL is a breeze thanks to its availability on PyPI. Simply open you
 pip install camel-ai
 ```
 
+### Starting with ChatAgent
+
+This example demonstrates how to create a `ChatAgent` using the CAMEL framework and perform a search query using DuckDuckGo.
+
+1. **Install the tools package:**
+
+  ```bash
+  pip install 'camel-ai[web_tools]'
+  ```
+
+2. **Set up your OpenAI API key:**
+
+  ```bash
+  export OPENAI_API_KEY='your_openai_api_key'
+  ```
+
+3. **Run the following Python code:**
+
+  ```python
+  from camel.models import ModelFactory
+  from camel.types import ModelPlatformType, ModelType
+  from camel.agents import ChatAgent
+  from camel.toolkits import SearchToolkit
+
+  model = ModelFactory.create(
+    model_platform=ModelPlatformType.OPENAI,
+    model_type=ModelType.GPT_4O,
+    model_config_dict={"temperature": 0.0},
+  )
+
+  search_tool = SearchToolkit().search_duckduckgo
+
+  agent = ChatAgent(model=model, tools=[search_tool])
+
+  response_1 = agent.step("What is CAMEL-AI?")
+  print(response_1.msgs[0].content)
+  # CAMEL-AI is the first LLM (Large Language Model) multi-agent framework
+  # and an open-source community focused on finding the scaling laws of agents.
+  # ...
+
+  response_2 = agent.step("What is the Github link to CAMEL framework?")
+  print(response_2.msgs[0].content)
+  # The GitHub link to the CAMEL framework is
+  # [https://github.com/camel-ai/camel](https://github.com/camel-ai/camel).
+  ```
+
+
 For more detailed instructions and additional configuration options, check out the [installation section](https://github.com/camel-ai/camel/blob/master/docs/get_started/installation.md).
 
-After running, you can explore our CAMEL Tech Stack and Cookbooks at [www.docs.camel-ai.org](https://docs.camel-ai.org) to build powerful multi-agent systems.
+After running, you can explore our CAMEL Tech Stack and Cookbooks at [docs.camel-ai.org](https://docs.camel-ai.org) to build powerful multi-agent systems.
 
 We provide a [![Google Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1AzP33O8rnMW__7ocWJhVBXjKziJXPtim?usp=sharing) demo showcasing a conversation between two ChatGPT agents playing roles as a python programmer and a stock trader collaborating on developing a trading bot for stock market.
 
@@ -247,7 +294,7 @@ We believe that studying these agents on a large scale offers valuable insights
 </div>
 
 <div align="center">
-  <a href="https://www.agent-trust.camel-ai.org/">
+  <a href="https://agent-trust.camel-ai.org/">
     <img src="docs/images/agent_trust.png" alt="Agent Trust">
   </a>
 </div>

{camel_ai-0.2.36 → camel_ai-0.2.37}/camel/__init__.py

@@ -14,7 +14,7 @@
 
 from camel.logger import disable_logging, enable_logging, set_log_level
 
-__version__ = '0.2.36'
+__version__ = '0.2.37'
 
 __all__ = [
     '__version__',

{camel_ai-0.2.36 → camel_ai-0.2.37}/camel/agents/__init__.py

@@ -16,6 +16,7 @@ from .chat_agent import ChatAgent
 from .critic_agent import CriticAgent
 from .embodied_agent import EmbodiedAgent
 from .knowledge_graph_agent import KnowledgeGraphAgent
+from .repo_agent import RepoAgent
 from .role_assignment_agent import RoleAssignmentAgent
 from .search_agent import SearchAgent
 from .task_agent import (
@@ -41,4 +42,5 @@ __all__ = [
     'RoleAssignmentAgent',
     'SearchAgent',
     'KnowledgeGraphAgent',
+    'RepoAgent',
 ]