camel-ai 0.2.59__tar.gz → 0.2.60__tar.gz

{camel_ai-0.2.59 → camel_ai-0.2.60}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: camel-ai
-Version: 0.2.59
+Version: 0.2.60
 Summary: Communicative Agents for AI Society Study
 Project-URL: Homepage, https://www.camel-ai.org/
 Project-URL: Repository, https://github.com/camel-ai/camel
@@ -16,6 +16,7 @@ Requires-Dist: httpx<1.0.0dev,>=0.28.0
 Requires-Dist: jsonschema<5,>=4
 Requires-Dist: mcp>=1.3.0
 Requires-Dist: openai<2,>=1.68.0
+Requires-Dist: pillow<11.0.0,>=10.1.0
 Requires-Dist: psutil<6,>=5.9.8
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: tiktoken<0.8,>=0.7.0
@@ -77,14 +78,13 @@ Requires-Dist: neo4j<6,>=5.18.0; extra == 'all'
 Requires-Dist: networkx<4,>=3.4.2; extra == 'all'
 Requires-Dist: newspaper3k<0.3,>=0.2.8; extra == 'all'
 Requires-Dist: notion-client<3,>=2.2.1; extra == 'all'
-Requires-Dist: numpy~=1.26; extra == 'all'
+Requires-Dist: numpy<=2.2,>=1.2; extra == 'all'
 Requires-Dist: openapi-spec-validator<0.8,>=0.7.1; extra == 'all'
 Requires-Dist: opencv-python<5,>=4; extra == 'all'
 Requires-Dist: openpyxl>=3.1.5; extra == 'all'
 Requires-Dist: outlines<0.2,>=0.1.7; extra == 'all'
 Requires-Dist: pandas<2,>=1.5.3; extra == 'all'
 Requires-Dist: pandasai<3,>=2.3.0; extra == 'all'
-Requires-Dist: pillow<11.0.0,>=10.1.0; extra == 'all'
 Requires-Dist: playwright>=1.50.0; extra == 'all'
 Requires-Dist: prance<24,>=23.6.21.0; extra == 'all'
 Requires-Dist: praw<8,>=7.7.1; extra == 'all'
@@ -150,7 +150,7 @@ 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: numpy<=2.2,>=1.2; extra == 'data-tools'
 Requires-Dist: pandas<2,>=1.5.3; extra == 'data-tools'
 Requires-Dist: rouge<2,>=1.0.1; extra == 'data-tools'
 Requires-Dist: stripe<12,>=11.3.0; extra == 'data-tools'
@@ -198,7 +198,7 @@ Requires-Dist: docx2txt<0.9,>=0.8; extra == 'document-tools'
 Requires-Dist: docx>=0.2.4; extra == 'document-tools'
 Requires-Dist: fpdf>=1.7.2; extra == 'document-tools'
 Requires-Dist: markitdown==0.1.1; extra == 'document-tools'
-Requires-Dist: numpy~=1.26; extra == 'document-tools'
+Requires-Dist: numpy<=2.2,>=1.2; extra == 'document-tools'
 Requires-Dist: openapi-spec-validator<0.8,>=0.7.1; extra == 'document-tools'
 Requires-Dist: openpyxl>=3.1.5; extra == 'document-tools'
 Requires-Dist: pandasai<3,>=2.3.0; extra == 'document-tools'
@@ -219,7 +219,6 @@ Requires-Dist: transformers<5,>=4; extra == 'huggingface'
 Provides-Extra: media-tools
 Requires-Dist: ffmpeg-python<0.3,>=0.2.0; extra == 'media-tools'
 Requires-Dist: imageio[pyav]<3,>=2.34.2; extra == 'media-tools'
-Requires-Dist: pillow<11.0.0,>=10.1.0; extra == 'media-tools'
 Requires-Dist: pydub<0.26,>=0.25.1; extra == 'media-tools'
 Requires-Dist: scenedetect>=0.6.5.2; extra == 'media-tools'
 Requires-Dist: yt-dlp<2025,>=2024.11.4; extra == 'media-tools'
@@ -249,14 +248,13 @@ Requires-Dist: imageio[pyav]<3,>=2.34.2; extra == 'owl'
 Requires-Dist: mcp-server-fetch==2025.1.17; extra == 'owl'
 Requires-Dist: mcp-simple-arxiv==0.2.2; extra == 'owl'
 Requires-Dist: newspaper3k<0.3,>=0.2.8; extra == 'owl'
-Requires-Dist: numpy~=1.26; extra == 'owl'
+Requires-Dist: numpy<=2.2,>=1.2; extra == 'owl'
 Requires-Dist: openapi-spec-validator<0.8,>=0.7.1; extra == 'owl'
 Requires-Dist: opencv-python<5,>=4; extra == 'owl'
 Requires-Dist: openpyxl>=3.1.5; extra == 'owl'
 Requires-Dist: outlines<0.2,>=0.1.7; extra == 'owl'
 Requires-Dist: pandas<2,>=1.5.3; extra == 'owl'
 Requires-Dist: pandasai<3,>=2.3.0; extra == 'owl'
-Requires-Dist: pillow<11.0.0,>=10.1.0; extra == 'owl'
 Requires-Dist: playwright>=1.50.0; extra == 'owl'
 Requires-Dist: prance<24,>=23.6.21.0; extra == 'owl'
 Requires-Dist: pyautogui<0.10,>=0.9.54; extra == 'owl'
@@ -284,7 +282,7 @@ Requires-Dist: crawl4ai>=0.3.745; extra == 'rag'
 Requires-Dist: google-genai>=1.13.0; extra == 'rag'
 Requires-Dist: nebula3-python==3.8.2; extra == 'rag'
 Requires-Dist: neo4j<6,>=5.18.0; extra == 'rag'
-Requires-Dist: numpy~=1.26; extra == 'rag'
+Requires-Dist: numpy<=2.2,>=1.2; extra == 'rag'
 Requires-Dist: pandasai<3,>=2.3.0; extra == 'rag'
 Requires-Dist: pymilvus<3,>=2.4.0; extra == 'rag'
 Requires-Dist: pyobvector>=0.1.18; extra == 'rag'

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/__init__.py

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

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/configs/cohere_config.py

@@ -74,4 +74,4 @@ class CohereConfig(BaseConfig):
     p: Optional[float] = None
 
 
-COHERE_API_PARAMS = {param for param in CohereConfig().model_fields.keys()}
+COHERE_API_PARAMS = {param for param in CohereConfig.model_fields.keys()}

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/configs/mistral_config.py

@@ -76,4 +76,4 @@ class MistralConfig(BaseConfig):
         return response_format
 
 
-MISTRAL_API_PARAMS = {param for param in MistralConfig().model_fields.keys()}
+MISTRAL_API_PARAMS = {param for param in MistralConfig.model_fields.keys()}

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/configs/openai_config.py

@@ -104,6 +104,8 @@ class ChatGPTConfig(BaseConfig):
         parallel_tool_calls (bool, optional): A parameter specifying whether
             the model should call tools in parallel or not.
             (default: :obj:`None`)
+        extra_headers: Optional[Dict[str, str]]: Extra headers to use for the
+            model. (default: :obj:`None`)
     """
 
     temperature: Optional[float] = None
@@ -120,6 +122,7 @@ class ChatGPTConfig(BaseConfig):
     tool_choice: Optional[Union[Dict[str, str], str]] = None
     reasoning_effort: Optional[str] = None
     parallel_tool_calls: Optional[bool] = None
+    extra_headers: Optional[Dict[str, str]] = None
 
 
 OPENAI_API_PARAMS = {param for param in ChatGPTConfig.model_fields.keys()}

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/configs/reka_config.py

@@ -66,4 +66,4 @@ class RekaConfig(BaseConfig):
     use_search_engine: Optional[bool] = None
 
 
-REKA_API_PARAMS = {param for param in RekaConfig().model_fields.keys()}
+REKA_API_PARAMS = {param for param in RekaConfig.model_fields.keys()}

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/configs/samba_config.py

@@ -65,7 +65,7 @@ class SambaVerseAPIConfig(BaseConfig):
 
 
 SAMBA_VERSE_API_PARAMS = {
-    param for param in SambaVerseAPIConfig().model_fields.keys()
+    param for param in SambaVerseAPIConfig.model_fields.keys()
 }
 
 
@@ -160,5 +160,5 @@ class SambaCloudAPIConfig(BaseConfig):
 
 
 SAMBA_CLOUD_API_PARAMS = {
-    param for param in SambaCloudAPIConfig().model_fields.keys()
+    param for param in SambaCloudAPIConfig.model_fields.keys()
 }

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/datagen/cot_datagen.py

@@ -204,26 +204,23 @@ class CoTDataGenerator:
         logger.info("Answer verification result: %s", is_correct)
         return is_correct
 
-    def monte_carlo_tree_search(
+    def evaluate_partial_solution(
         self, question: str, partial_solution: str = ""
     ) -> float:
-        r"""Perform Monte Carlo Tree Search to find the best solution.
+        r"""Evaluate the quality of a partial solution against the
+        golden answer.
 
-        Process:
-        a. Selection: Choose promising partial solutions based on previous
-        scores
-        b. Expansion: Generate new solution steps using the generator agent
-        c. Simulation: Evaluate solution quality using similarity scores
-        d. Backpropagation: Update solution tree with new findings
+        This function generates a similarity score between the given partial
+        solution and the correct answer (golden answer).
 
         Args:
-            question (str): The question to solve.
-            partial_solution (str): The current partial solution.
+            question (str): The question being solved.
+            partial_solution (str): The partial solution generated so far.
                 (default::obj:`""`)
 
         Returns:
-            float: The similarity score between the current
-                solution and golden answer.
+            float: A similarity score between 0 and 1, indicating how close the
+                partial solution is to the golden answer.
         """
         if question not in self.golden_answers:
             raise ValueError(
@@ -293,10 +290,21 @@ class CoTDataGenerator:
         r"""Solve a question using a multi-step approach.
 
         The solution process follows these steps:
-        1. Try to solve directly - if correct, return the solution
-        2. If not correct, use Monte Carlo Tree Search to find a good solution
-        3. If the solution isn't perfect, use binary search to locate errors
-        4. Generate a new solution based on the correct part
+        1. Try to solve directly - if correct, return the solution.
+        2. If not correct, perform a search by iteratively generating
+        new solutions and evaluating their similarity scores to
+        find a good solution. The search process involves:
+            a. Generation: Generate new solution candidates using
+            the generator agent.
+            b. Evaluation: Score each solution candidate for similarity
+            to the golden answer.
+            c. Selection: Keep the best-scoring candidate found so far.
+            d. Early stopping: If a sufficiently high-scoring solution
+            is found (score > 0.9), stop early.
+        3. If the solution isn't perfect, use binary search to locate
+        errors.
+        4. Generate a new solution based on the correct part of the
+        initial solution.
 
         Args:
             question (str): The question to solve.
@@ -304,14 +312,14 @@ class CoTDataGenerator:
         Returns:
             str: The best solution found.
         """
+
         # 1. Try direct solution first
         solution = self.get_answer(question)
         if self.verify_answer(question, solution):
             logger.info("Initial solution is correct")
             return solution
 
-        # 2. If direct solution fails, try Monte Carlo Tree Search
-        # to find a solution with high similarity score
+        # 2. If direct solution fails, iteratively search for a better solution
         best_solution = ""
         best_score: float = 0.0
         for i in range(self.search_limit):
@@ -319,23 +327,10 @@ class CoTDataGenerator:
             current_solution = self.get_answer(question, best_solution)
 
             # Evaluate solution similarity score
-            prompt = (
-                f"Please evaluate this solution and "
-                f"give a score between 0-1:\n"
-                f"Question: {question}\n"
-                f"Solution: {current_solution}\n"
-                f"Correct answer: {self.golden_answers.get(question, '')}\n"
-                f"Return a JSON object with a single field 'score' containing "
-                f"a float between 0 and 1, like this: {{'score': 0.85}}\n"
-            )
-            self.generator_agent.reset()
-            response = self.generator_agent.step(prompt)
             try:
-                response = self.generator_agent.step(
-                    prompt, response_format=AgentResponse
+                score = self.evaluate_partial_solution(
+                    question, current_solution
                 )
-                agent_response = response.msgs[0].parsed.score  # type: ignore [union-attr]
-                score = agent_response
 
                 # Exit early if we find a very good solution (score > 0.9)
                 if score > 0.9:
@@ -357,7 +352,7 @@ class CoTDataGenerator:
                     best_score,
                 )
             except Exception as e:
-                logger.error("Error parsing agent response: %s", str(e))
+                logger.error("Error evaluating partial solution: %s", str(e))
                 continue
 
         # 3. If the answer is not completely correct,

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/embeddings/jina_embedding.py

@@ -12,6 +12,9 @@
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 
+# Enables postponed evaluation of annotations (for string-based type hints)
+from __future__ import annotations
+
 import base64
 import io
 import os
@@ -104,6 +107,7 @@ class JinaEmbedding(BaseEmbedding[Union[str, Image.Image]]):
             ValueError: If the input type is not supported.
             RuntimeError: If the API request fails.
         """
+
         input_data = []
         for obj in objs:
             if isinstance(obj, str):
@@ -111,7 +115,10 @@ class JinaEmbedding(BaseEmbedding[Union[str, Image.Image]]):
                     input_data.append({"text": obj})
                 else:
                     input_data.append(obj)  # type: ignore[arg-type]
-            elif isinstance(obj, Image.Image):
+            elif (
+                obj.__class__.__module__ == "PIL.Image"
+                and obj.__class__.__name__ == "Image"
+            ):
                 if self.model_type != EmbeddingModelType.JINA_CLIP_V2:
                     raise ValueError(
                         f"Model {self.model_type} does not support "

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/embeddings/sentence_transformers_embeddings.py

@@ -15,8 +15,6 @@ from __future__ import annotations
 
 from typing import Any
 
-from numpy import ndarray
-
 from camel.embeddings.base import BaseEmbedding
 
 
@@ -61,6 +59,8 @@ class SentenceTransformerEncoder(BaseEmbedding[str]):
             list[list[float]]: A list that represents the generated embedding
                 as a list of floating-point numbers.
         """
+        from numpy import ndarray
+
         if not objs:
             raise ValueError("Input text list is empty")
         embeddings = self.model.encode(

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/embeddings/vlm_embedding.py

@@ -11,6 +11,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+
+# Enables postponed evaluation of annotations (for string-based type hints)
+from __future__ import annotations
+
 from typing import Any, List, Optional, Union
 
 from PIL import Image
@@ -70,7 +74,7 @@ class VisionLanguageEmbedding(BaseEmbedding[Union[str, Image.Image]]):
     def embed_list(
         self, objs: List[Union[Image.Image, str]], **kwargs: Any
     ) -> List[List[float]]:
-        """Generates embeddings for the given images or texts.
+        r"""Generates embeddings for the given images or texts.
 
         Args:
             objs (List[Image.Image|str]): The list of images or texts for
@@ -98,7 +102,10 @@ class VisionLanguageEmbedding(BaseEmbedding[Union[str, Image.Image]]):
 
         result_list = []
         for obj in objs:
-            if isinstance(obj, Image.Image):
+            if (
+                obj.__class__.__module__ == "PIL.Image"
+                and obj.__class__.__name__ == "Image"
+            ):
                 image_input = self.processor(
                     images=obj,
                     return_tensors="pt",

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/memories/records.py

@@ -12,6 +12,9 @@
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 
+# Enables postponed evaluation of annotations (for string-based type hints)
+from __future__ import annotations
+
 from dataclasses import asdict
 from datetime import datetime, timezone
 from typing import Any, ClassVar, Dict

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/messages/base.py

@@ -11,13 +11,24 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+
+# Enables postponed evaluation of annotations (for string-based type hints)
+from __future__ import annotations
+
 import base64
 import io
 import re
 from dataclasses import dataclass
-from typing import Any, Dict, List, Literal, Optional, Tuple, Union
+from typing import (
+    Any,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    Tuple,
+    Union,
+)
 
-import numpy as np
 from PIL import Image
 from pydantic import BaseModel
 
@@ -48,7 +59,7 @@ class BaseMessage:
         role_name (str): The name of the user or assistant role.
         role_type (RoleType): The type of role, either :obj:`RoleType.
             ASSISTANT` or :obj:`RoleType.USER`.
-        meta_dict (Optional[Dict[str, str]]): Additional metadata dictionary
+        meta_dict (Optional[Dict[str, Any]]): Additional metadata dictionary
             for the message.
         content (str): The content of the message.
         video_bytes (Optional[bytes]): Optional bytes of a video associated
@@ -457,6 +468,7 @@ class BaseMessage:
 
         if self.video_bytes:
             import imageio.v3 as iio
+            import numpy as np
 
             base64Frames: List[str] = []
             frame_count = 0

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/models/azure_openai_model.py

@@ -62,6 +62,7 @@ class AzureOpenAIModel(BaseModelBackend):
             environment variable or default to 180 seconds.
             (default: :obj:`None`)
 
+
     References:
         https://learn.microsoft.com/en-us/azure/ai-services/openai/
     """

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/models/model_factory.py

@@ -14,8 +14,6 @@
 import json
 from typing import ClassVar, Dict, Optional, Type, Union
 
-import yaml
-
 from camel.models.aiml_model import AIMLModel
 from camel.models.anthropic_model import AnthropicModel
 from camel.models.aws_bedrock_model import AWSBedrockModel
@@ -221,6 +219,8 @@ class ModelFactory:
 
     @classmethod
     def __load_yaml(cls, filepath: str) -> Dict:
+        import yaml
+
         r"""Loads and parses a YAML file into a dictionary.
 
         Args:

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/retrievers/bm25_retriever.py

@@ -13,8 +13,6 @@
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 from typing import Any, Dict, List
 
-import numpy as np
-
 from camel.loaders import UnstructuredIO
 from camel.retrievers import BaseRetriever
 from camel.utils import dependencies_required
@@ -106,6 +104,7 @@ class BM25Retriever(BaseRetriever):
                 model has not been initialized by calling `process`
                 first.
         """
+        import numpy as np
 
         if top_k <= 0:
             raise ValueError("top_k must be a positive integer.")

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/retrievers/hybrid_retrival.py

@@ -13,8 +13,6 @@
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 from typing import Any, Collection, Dict, List, Optional, Sequence, Union
 
-import numpy as np
-
 from camel.embeddings import BaseEmbedding
 from camel.retrievers import BaseRetriever, BM25Retriever, VectorRetriever
 from camel.storages import BaseVectorStorage
@@ -96,6 +94,8 @@ class HybridRetriever(BaseRetriever):
             https://medium.com/@devalshah1619/mathematical-intuition-behind-reciprocal-rank-fusion-rrf-explained-in-2-mins-002df0cc5e2a
             https://colab.research.google.com/drive/1iwVJrN96fiyycxN1pBqWlEr_4EPiGdGy#scrollTo=0qh83qGV2dY8
         """
+        import numpy as np
+
         text_to_id = {}
         id_to_info = {}
         current_id = 1

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/storages/vectordb_storages/oceanbase.py

@@ -16,8 +16,6 @@ import json
 import logging
 from typing import TYPE_CHECKING, Any, Dict, List, Literal, Optional
 
-from sqlalchemy import JSON, Column, Integer
-
 if TYPE_CHECKING:
     from pyobvector.client import ObVecClient
 
@@ -80,6 +78,7 @@ class OceanBaseStorage(BaseVectorStorage):
             IndexParams,
         )
         from pyobvector.schema import VECTOR
+        from sqlalchemy import JSON, Column, Integer
 
         self.vector_dim: int = vector_dim
         self.table_name: str = table_name

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/toolkits/async_browser_toolkit.py

@@ -11,6 +11,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+
+# Enables postponed evaluation of annotations (for string-based type hints)
+from __future__ import annotations
+
 import asyncio
 import datetime
 import io
@@ -1336,7 +1340,7 @@ class AsyncBrowserToolkit(BaseToolkit):
 
     def _initialize_agent(self) -> Tuple["ChatAgent", "ChatAgent"]:
         r"""Initialize the agent."""
-        from camel.agents import ChatAgent
+        from camel.agents.chat_agent import ChatAgent
 
         if self.web_agent_model is None:
             web_agent_model = ModelFactory.create(

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/toolkits/browser_toolkit.py

@@ -12,6 +12,9 @@
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 
+# Enables postponed evaluation of annotations (for string-based type hints)
+from __future__ import annotations
+
 import datetime
 import io
 import json
@@ -38,8 +41,6 @@ from typing import (
 
 from PIL import Image, ImageDraw, ImageFont
 
-if TYPE_CHECKING:
-    from camel.agents import ChatAgent
 from camel.logger import get_logger
 from camel.messages import BaseMessage
 from camel.models import BaseModelBackend, ModelFactory
@@ -53,6 +54,9 @@ from camel.utils import (
     sanitize_filename,
 )
 
+if TYPE_CHECKING:
+    from camel.agents import ChatAgent
+
 logger = get_logger(__name__)
 
 TOP_NO_LABEL_ZONE = 20
@@ -577,7 +581,6 @@ class BaseBrowser:
             image and the path to the image file if saved, otherwise
             :obj:`None`.
         """
-
         image_data = self.page.screenshot(timeout=60000)
         image = Image.open(io.BytesIO(image_data))
 

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/toolkits/dalle_toolkit.py

@@ -11,6 +11,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+
+# Enables postponed evaluation of annotations (for string-based type hints)
+from __future__ import annotations
+
 import base64
 import os
 import uuid

{camel_ai-0.2.59 → camel_ai-0.2.60}/camel/toolkits/excel_toolkit.py

@@ -12,15 +12,20 @@
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 
-from typing import List, Optional
+# Enables postponed evaluation of annotations (for string-based type hints)
+from __future__ import annotations
 
-import pandas as pd
+from typing import TYPE_CHECKING, List, Optional
 
 from camel.logger import get_logger
 from camel.toolkits.base import BaseToolkit
 from camel.toolkits.function_tool import FunctionTool
 from camel.utils import MCPServer
 
+# Import only for type hints (not executed at runtime)
+if TYPE_CHECKING:
+    import pandas as pd
+
 logger = get_logger(__name__)
 
 
@@ -71,6 +76,7 @@ class ExcelToolkit(BaseToolkit):
         Returns:
             str: Extracted excel information, including details of each sheet.
         """
+        import pandas as pd
         from openpyxl import load_workbook
         from xls2xlsx import XLS2XLSX