camel-ai 0.2.38__tar.gz → 0.2.40__tar.gz

{camel_ai-0.2.38 → camel_ai-0.2.40}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: camel-ai
-Version: 0.2.38
+Version: 0.2.40
 Summary: Communicative Agents for AI Society Study
 Project-URL: Homepage, https://www.camel-ai.org/
 Project-URL: Repository, https://github.com/camel-ai/camel
@@ -55,6 +55,7 @@ Requires-Dist: ipykernel<7,>=6.0.0; extra == 'all'
 Requires-Dist: jupyter-client<9,>=8.6.2; extra == 'all'
 Requires-Dist: linkup-sdk<0.3,>=0.2.1; extra == 'all'
 Requires-Dist: litellm<2,>=1.38.1; extra == 'all'
+Requires-Dist: math-verify<0.8,>=0.7.0; extra == 'all'
 Requires-Dist: mcp>=1.3.0; extra == 'all'
 Requires-Dist: mem0ai>=0.1.67; extra == 'all'
 Requires-Dist: mistralai<2,>=1.1.0; extra == 'all'
@@ -133,6 +134,7 @@ Provides-Extra: data-tools
 Requires-Dist: aiosqlite<0.21,>=0.20.0; extra == 'data-tools'
 Requires-Dist: datacommons-pandas<0.0.4,>=0.0.3; extra == 'data-tools'
 Requires-Dist: datacommons<2,>=1.4.3; extra == 'data-tools'
+Requires-Dist: math-verify<0.8,>=0.7.0; extra == 'data-tools'
 Requires-Dist: networkx<4,>=3.4.2; extra == 'data-tools'
 Requires-Dist: numpy~=1.26; extra == 'data-tools'
 Requires-Dist: pandas<2,>=1.5.3; extra == 'data-tools'

{camel_ai-0.2.38 → camel_ai-0.2.40}/camel/__init__.py

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

{camel_ai-0.2.38 → camel_ai-0.2.40}/camel/agents/chat_agent.py

@@ -526,6 +526,10 @@ class ChatAgent(BaseAgent):
             message.content = response.output_messages[0].content
             if not self._try_format_message(message, response_format):
                 logger.warning(f"Failed to parse response: {message.content}")
+                logger.warning(
+                    "To improve reliability, consider using models "
+                    "that are better equipped to handle structured output"
+                )
 
     async def _aformat_response_if_needed(
         self,

{camel_ai-0.2.38 → camel_ai-0.2.40}/camel/agents/repo_agent.py

@@ -17,7 +17,7 @@ from string import Template
 from typing import TYPE_CHECKING, List, Optional, Tuple, Union
 
 if TYPE_CHECKING:
-    from github import Github
+    from github.MainClass import Github
 from pydantic import BaseModel
 
 from camel.agents import ChatAgent
@@ -219,7 +219,7 @@ class RepoAgent(ChatAgent):
             List[RepositoryInfo]: A list of objects containing information
                 about the all repositories, including the contents.
         """
-        from github import Github
+        from github.MainClass import Github
 
         github_client = Github(self.github_auth_token)
         res = []

{camel_ai-0.2.38 → camel_ai-0.2.40}/camel/benchmarks/apibank.py

@@ -48,7 +48,7 @@ def process_messages(
     Args:
         chat_history (List[Dict[str, Any]):
             A list of dictionaries representing the chat history.
-        prompt (str): A propmt to be set as the system message.
+        prompt (str): A prompt to be set as the system message.
 
     Returns:
         List[Dict[str, str]]: A list of dictionaries representing

{camel_ai-0.2.38 → camel_ai-0.2.40}/camel/benchmarks/apibench.py

@@ -30,7 +30,7 @@ logger = logging.getLogger(__name__)
 
 
 # Mapping of dataset names to file names
-# 'Oracle' retriver used here which means all the full
+# 'Oracle' retriever used here which means all the full
 # API documentation will be included in the prompt
 dataset_mapping = {
     "huggingface": {

{camel_ai-0.2.38 → camel_ai-0.2.40}/camel/configs/__init__.py

@@ -21,6 +21,7 @@ from .groq_config import GROQ_API_PARAMS, GroqConfig
 from .internlm_config import INTERNLM_API_PARAMS, InternLMConfig
 from .litellm_config import LITELLM_API_PARAMS, LiteLLMConfig
 from .mistral_config import MISTRAL_API_PARAMS, MistralConfig
+from .modelscope_config import MODELSCOPE_API_PARAMS, ModelScopeConfig
 from .moonshot_config import MOONSHOT_API_PARAMS, MoonshotConfig
 from .nvidia_config import NVIDIA_API_PARAMS, NvidiaConfig
 from .ollama_config import OLLAMA_API_PARAMS, OllamaConfig
@@ -85,6 +86,8 @@ __all__ = [
     'INTERNLM_API_PARAMS',
     'MoonshotConfig',
     "MOONSHOT_API_PARAMS",
+    'ModelScopeConfig',
+    'MODELSCOPE_API_PARAMS',
     'SiliconFlowConfig',
     'SILICONFLOW_API_PARAMS',
     'AIMLConfig',

camel_ai-0.2.40/camel/configs/modelscope_config.py

@@ -0,0 +1,59 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+from __future__ import annotations
+
+from typing import Optional, Union
+
+from camel.configs.base_config import BaseConfig
+
+
+class ModelScopeConfig(BaseConfig):
+    r"""Defines the parameters for generating chat completions using the
+    ModelScope API. You can refer to the following link for more details:
+    https://www.modelscope.cn/docs/model-service/API-Inference/intro
+
+    Args:
+        tool_choice (Union[dict[str, str], str], optional): Controls which (if
+            any) tool is called by the model. :obj:`"none"` means the model
+            will not call any tool and instead generates a message.
+            :obj:`"auto"` means the model can pick between generating a
+            message or calling one or more tools. :obj:`"required"` or
+            specifying a particular tool via
+            {"type": "function", "function": {"name": "some_function"}}
+            can be used to guide the model to use tools more strongly.
+            (default: :obj:`None`)
+        max_tokens (int, optional): Specifies the maximum number of tokens
+            the model can generate. This sets an upper limit, but does not
+            guarantee that this number will always be reached.
+            (default: :obj:`None`)
+        top_p (float, optional): Controls the randomness of the generated
+            results. Lower values lead to less randomness, while higher
+            values increase randomness. (default: :obj:`None`)
+        temperature (float, optional): Controls the diversity and focus of
+            the generated results. Lower values make the output more focused,
+            while higher values make it more diverse. (default: :obj:`0.3`)
+        stream (bool, optional): If True, enables streaming output.
+            (default: :obj:`None`)
+    """
+
+    tool_choice: Optional[Union[dict[str, str], str]] = None
+    max_tokens: Optional[int] = None
+    top_p: Optional[float] = None
+    temperature: Optional[float] = None
+    stream: Optional[bool] = None
+
+
+MODELSCOPE_API_PARAMS = {
+    param for param in ModelScopeConfig.model_fields.keys()
+}

{camel_ai-0.2.38 → camel_ai-0.2.40}/camel/datagen/self_improving_cot.py

@@ -518,7 +518,7 @@ class SelfImprovingCoTPipeline:
             self.reason_agent.model_backend.model_config_dict['n'] = (
                 self.rejection_sampling_n
             )
-            # Generate multiple condidate traces in one call using parameter n
+            # Generate multiple candidate traces in one call using parameter n
             responses = self.reason_agent.step(prompt)
             # Extract cancidate traces
             candidate_traces = [choice.content for choice in responses.msgs]

{camel_ai-0.2.38 → camel_ai-0.2.40}/camel/datasets/__init__.py

@@ -14,6 +14,7 @@
 from .base_generator import BaseGenerator
 from .few_shot_generator import FewShotGenerator
 from .models import DataPoint
+from .self_instruct_generator import SelfInstructGenerator
 from .static_dataset import StaticDataset
 
 __all__ = [
@@ -21,4 +22,5 @@ __all__ = [
     "DataPoint",
     "FewShotGenerator",
     "StaticDataset",
+    "SelfInstructGenerator",
 ]

{camel_ai-0.2.38 → camel_ai-0.2.40}/camel/datasets/base_generator.py

@@ -39,6 +39,7 @@ class BaseGenerator(abc.ABC, IterableDataset):
     def __init__(
         self,
         seed: int = 42,
+        buffer: int = 20,
         cache: Union[str, Path, None] = None,
         data_path: Union[str, Path, None] = None,
         **kwargs,
@@ -47,6 +48,8 @@ class BaseGenerator(abc.ABC, IterableDataset):
 
         Args:
             seed (int): Random seed for reproducibility. (default: :obj:`42`)
+            buffer (int): Amount of DataPoints to be generated when the
+                iterator runs out of DataPoints in data. (default:  :obj:`20`)
             cache (Union[str, Path, None]): Optional path to save generated
                 datapoints during iteration. If None is provided, datapoints
                 will be discarded every 100 generations.
@@ -56,7 +59,7 @@ class BaseGenerator(abc.ABC, IterableDataset):
         """
         self._rng = random.Random(seed)
         self.cache = Path(cache) if cache else None
-
+        self._buffer = buffer
         self._data: List[DataPoint] = []
         self._batch_to_save: List[DataPoint] = []
 
@@ -72,15 +75,27 @@ class BaseGenerator(abc.ABC, IterableDataset):
                 )
 
     @abc.abstractmethod
-    async def generate_new(self, n: int, **kwargs) -> List[DataPoint]:
-        r"""Generate n new datapoints.
+    async def generate_new(self, n: int, **kwargs) -> None:
+        r"""Generate n new datapoints and append them to self._data.
+
+        Subclass implementations must generate the specified number of
+        datapoints and append them directly to the `self._data` list.
+        This method should not return the datapoints; the iterator
+        relies on `self._data` being populated.
 
         Args:
-            n (int): Number of datapoints to generate.
+            n (int): Number of datapoints to generate and append.
             **kwargs: Additional generation parameters.
 
         Returns:
-            List[DataPoint]: A list of newly generated datapoints.
+            None: This method should not return anything.
+
+        Example:
+            ```python
+            async def generate_new(self, n: int, **kwargs) -> None:
+                new_points = [DataPoint(...) for _ in range(n)]
+                self._data.extend(new_points)
+            ```
         """
         pass
 
@@ -99,8 +114,7 @@ class BaseGenerator(abc.ABC, IterableDataset):
         async def generator():
             while True:
                 if not self._data:
-                    new_datapoints = await self.generate_new(20)
-                    self._data.extend(new_datapoints)
+                    await self.generate_new(self._buffer)
                 datapoint = self._data.pop(0)
                 yield datapoint
                 self._batch_to_save.append(datapoint)
@@ -137,8 +151,7 @@ class BaseGenerator(abc.ABC, IterableDataset):
 
         while True:
             if not self._data:
-                new_datapoints = asyncio.run(self.generate_new(20))
-                self._data.extend(new_datapoints)
+                asyncio.run(self.generate_new(self._buffer))
             datapoint = self._data.pop(0)
             yield datapoint
             self._batch_to_save.append(datapoint)

{camel_ai-0.2.38 → camel_ai-0.2.40}/camel/datasets/few_shot_generator.py

@@ -126,7 +126,7 @@ class FewShotGenerator(BaseGenerator):
         max_retries: int = 10,
         num_examples: int = 3,
         **kwargs,
-    ) -> List[DataPoint]:
+    ) -> None:
         r"""Generates and validates `n` new datapoints through
         few-shot prompting, with a retry limit.
 
@@ -203,7 +203,7 @@ class FewShotGenerator(BaseGenerator):
                 try:
                     verifier_response = await self.verifier.verify(
                         solution=rationale,
-                        ground_truth=None,
+                        reference_answer=None,
                     )
                     if not verifier_response or not verifier_response.result:
                         raise ValueError(
@@ -255,4 +255,3 @@ class FewShotGenerator(BaseGenerator):
         # Thread-safe way to extend the data list
         async with asyncio.Lock():
             self._data.extend(valid_data_points)
-        return valid_data_points