swarms 7.5.9__tar.gz → 7.6.1__tar.gz

swarms-7.5.9/README.md → swarms-7.6.1/PKG-INFO

@@ -1,3 +1,43 @@
+Metadata-Version: 2.1
+Name: swarms
+Version: 7.6.1
+Summary: Swarms - TGSC
+Home-page: https://github.com/kyegomez/swarms
+License: MIT
+Keywords: artificial intelligence,deep learning,optimizers,Prompt Engineering,swarms,agents,llms,transformers,multi-agent,swarms of agents,Enterprise-Grade Agents,Production-Grade Agents,Agents,Multi-Grade-Agents,Swarms,Transformers,LLMs,Prompt Engineering,Agents,Generative Agents,Generative AI,Agent Marketplace,Agent Store,quant,finance,algorithmic trading,portfolio optimization,risk management,financial modeling,machine learning for finance,natural language processing for finance
+Author: Kye Gomez
+Author-email: kye@apac.ai
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Dist: PyYAML
+Requires-Dist: aiofiles
+Requires-Dist: asyncio (>=3.4.3,<4.0)
+Requires-Dist: docstring_parser (==0.16)
+Requires-Dist: httpx
+Requires-Dist: litellm
+Requires-Dist: loguru
+Requires-Dist: networkx
+Requires-Dist: numpy
+Requires-Dist: psutil
+Requires-Dist: pydantic
+Requires-Dist: pypdf (==5.1.0)
+Requires-Dist: python-dotenv
+Requires-Dist: rich
+Requires-Dist: setuptools
+Requires-Dist: tenacity
+Requires-Dist: toml
+Requires-Dist: torch
+Project-URL: Documentation, https://docs.swarms.world
+Project-URL: Repository, https://github.com/kyegomez/swarms
+Description-Content-Type: text/markdown
+
 <div align="center">
   <a href="https://swarms.world">
     <img src="https://github.com/kyegomez/swarms/blob/master/images/swarmslogobanner.png" style="margin: 15px; max-width: 300px" width="50%" alt="Logo">
@@ -325,6 +365,84 @@ agent.run(
 ```
 
 
+## Structured Outputs
+
+1. Create a tool schema
+2. Create a function schema
+3. Create a tool list dictionary
+4. Initialize the agent
+5. Run the agent
+6. Print the output
+7. Convert the output to a dictionary
+
+```python
+
+from dotenv import load_dotenv
+
+from swarms import Agent
+from swarms.prompts.finance_agent_sys_prompt import (
+    FINANCIAL_AGENT_SYS_PROMPT,
+)
+from swarms.utils.str_to_dict import str_to_dict
+
+load_dotenv()
+
+tools = [
+    {
+        "type": "function",
+        "function": {
+            "name": "get_stock_price",
+            "description": "Retrieve the current stock price and related information for a specified company.",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "ticker": {
+                        "type": "string",
+                        "description": "The stock ticker symbol of the company, e.g. AAPL for Apple Inc.",
+                    },
+                    "include_history": {
+                        "type": "boolean",
+                        "description": "Indicates whether to include historical price data along with the current price.",
+                    },
+                    "time": {
+                        "type": "string",
+                        "format": "date-time",
+                        "description": "Optional parameter to specify the time for which the stock data is requested, in ISO 8601 format.",
+                    },
+                },
+                "required": [
+                    "ticker",
+                    "include_history",
+                    "time",
+                ],
+            },
+        },
+    }
+]
+
+
+# Initialize the agent
+agent = Agent(
+    agent_name="Financial-Analysis-Agent",
+    agent_description="Personal finance advisor agent",
+    system_prompt=FINANCIAL_AGENT_SYS_PROMPT,
+    max_loops=1,
+    tools_list_dictionary=tools,
+)
+
+out = agent.run(
+    "What is the current stock price for Apple Inc. (AAPL)? Include historical price data.",
+)
+
+print(out)
+
+print(type(out))
+
+print(str_to_dict(out))
+
+print(type(str_to_dict(out)))
+```
+
 -------
 
 ### Misc Agent Settings
@@ -2191,3 +2309,4 @@ Join our growing community around the world, for real-time support, ideas, and d
 # License
 
 APACHE 
+

swarms-7.5.9/PKG-INFO → swarms-7.6.1/README.md

@@ -1,43 +1,3 @@
-Metadata-Version: 2.1
-Name: swarms
-Version: 7.5.9
-Summary: Swarms - TGSC
-Home-page: https://github.com/kyegomez/swarms
-License: MIT
-Keywords: artificial intelligence,deep learning,optimizers,Prompt Engineering,swarms,agents,llms,transformers,multi-agent,swarms of agents,Enterprise-Grade Agents,Production-Grade Agents,Agents,Multi-Grade-Agents,Swarms,Transformers,LLMs,Prompt Engineering,Agents,Generative Agents,Generative AI,Agent Marketplace,Agent Store,quant,finance,algorithmic trading,portfolio optimization,risk management,financial modeling,machine learning for finance,natural language processing for finance
-Author: Kye Gomez
-Author-email: kye@apac.ai
-Requires-Python: >=3.10,<4.0
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Dist: PyYAML
-Requires-Dist: aiofiles
-Requires-Dist: asyncio (>=3.4.3,<4.0)
-Requires-Dist: docstring_parser (==0.16)
-Requires-Dist: httpx
-Requires-Dist: litellm
-Requires-Dist: loguru
-Requires-Dist: networkx
-Requires-Dist: numpy
-Requires-Dist: psutil
-Requires-Dist: pydantic
-Requires-Dist: pypdf (==5.1.0)
-Requires-Dist: python-dotenv
-Requires-Dist: rich
-Requires-Dist: setuptools
-Requires-Dist: tenacity
-Requires-Dist: toml
-Requires-Dist: torch
-Project-URL: Documentation, https://docs.swarms.world
-Project-URL: Repository, https://github.com/kyegomez/swarms
-Description-Content-Type: text/markdown
-
 <div align="center">
   <a href="https://swarms.world">
     <img src="https://github.com/kyegomez/swarms/blob/master/images/swarmslogobanner.png" style="margin: 15px; max-width: 300px" width="50%" alt="Logo">
@@ -365,6 +325,84 @@ agent.run(
 ```
 
 
+## Structured Outputs
+
+1. Create a tool schema
+2. Create a function schema
+3. Create a tool list dictionary
+4. Initialize the agent
+5. Run the agent
+6. Print the output
+7. Convert the output to a dictionary
+
+```python
+
+from dotenv import load_dotenv
+
+from swarms import Agent
+from swarms.prompts.finance_agent_sys_prompt import (
+    FINANCIAL_AGENT_SYS_PROMPT,
+)
+from swarms.utils.str_to_dict import str_to_dict
+
+load_dotenv()
+
+tools = [
+    {
+        "type": "function",
+        "function": {
+            "name": "get_stock_price",
+            "description": "Retrieve the current stock price and related information for a specified company.",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "ticker": {
+                        "type": "string",
+                        "description": "The stock ticker symbol of the company, e.g. AAPL for Apple Inc.",
+                    },
+                    "include_history": {
+                        "type": "boolean",
+                        "description": "Indicates whether to include historical price data along with the current price.",
+                    },
+                    "time": {
+                        "type": "string",
+                        "format": "date-time",
+                        "description": "Optional parameter to specify the time for which the stock data is requested, in ISO 8601 format.",
+                    },
+                },
+                "required": [
+                    "ticker",
+                    "include_history",
+                    "time",
+                ],
+            },
+        },
+    }
+]
+
+
+# Initialize the agent
+agent = Agent(
+    agent_name="Financial-Analysis-Agent",
+    agent_description="Personal finance advisor agent",
+    system_prompt=FINANCIAL_AGENT_SYS_PROMPT,
+    max_loops=1,
+    tools_list_dictionary=tools,
+)
+
+out = agent.run(
+    "What is the current stock price for Apple Inc. (AAPL)? Include historical price data.",
+)
+
+print(out)
+
+print(type(out))
+
+print(str_to_dict(out))
+
+print(type(str_to_dict(out)))
+```
+
 -------
 
 ### Misc Agent Settings
@@ -2231,4 +2269,3 @@ Join our growing community around the world, for real-time support, ideas, and d
 # License
 
 APACHE 
-

{swarms-7.5.9 → swarms-7.6.1}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "swarms"
-version = "7.5.9"
+version = "7.6.1"
 description = "Swarms - TGSC"
 license = "MIT"
 authors = ["Kye Gomez <kye@apac.ai>"]
@@ -83,7 +83,7 @@ swarms = "swarms.cli.main:main"
 
 [tool.poetry.group.lint.dependencies]
 black = ">=23.1,<26.0"
-ruff = ">=0.5.1,<0.9.10"
+ruff = ">=0.5.1,<0.11.1"
 types-toml = "^0.10.8.1"
 types-pytz = ">=2023.3,<2026.0"
 types-chardet = "^5.0.4.6"

{swarms-7.5.9 → swarms-7.6.1}/swarms/agents/__init__.py

@@ -23,6 +23,9 @@ from swarms.structs.stopping_conditions import (
     check_success,
 )
 
+from swarms.agents.flexion_agent import ReflexionAgent
+from swarms.agents.gkp_agent import GKPAgent
+
 __all__ = [
     # "ToolAgent",
     "check_done",
@@ -41,4 +44,6 @@ __all__ = [
     "ReasoningDuo",
     "ReasoningAgentRouter",
     "agent_types",
+    "ReflexionAgent",
+    "GKPAgent",
 ]

swarms-7.6.1/swarms/agents/agent_judge.py

@@ -0,0 +1,119 @@
+from typing import List
+
+from swarms.prompts.agent_judge_prompt import AGENT_JUDGE_PROMPT
+from swarms.structs.agent import Agent
+from swarms.structs.conversation import Conversation
+from swarms.utils.any_to_str import any_to_str
+
+from loguru import logger
+
+
+class AgentJudge:
+    """
+    A class to represent an agent judge that processes tasks and generates responses.
+
+    Attributes:
+        agent_name (str): The name of the agent judge.
+        system_prompt (str): The system prompt for the agent.
+        model_name (str): The model name used for generating responses.
+        conversation (Conversation): An instance of the Conversation class to manage conversation history.
+        max_loops (int): The maximum number of iterations to run the tasks.
+        agent (Agent): An instance of the Agent class that performs the task execution.
+
+    Methods:
+        step(tasks: List[str]) -> str:
+            Processes a list of tasks and returns the agent's response.
+
+        run(tasks: List[str]) -> List[str]:
+            Executes the tasks in a loop, updating context and collecting responses.
+    """
+
+    def __init__(
+        self,
+        agent_name: str = "agent-judge-01",
+        system_prompt: str = AGENT_JUDGE_PROMPT,
+        model_name: str = "openai/o1",
+        max_loops: int = 1,
+    ) -> None:
+        """
+        Initializes the AgentJudge with the specified parameters.
+
+        Args:
+            agent_name (str): The name of the agent judge.
+            system_prompt (str): The system prompt for the agent.
+            model_name (str): The model name used for generating responses.
+            max_loops (int): The maximum number of iterations to run the tasks.
+        """
+        self.agent_name = agent_name
+        self.system_prompt = system_prompt
+        self.model_name = model_name
+        self.conversation = Conversation(time_enabled=False)
+        self.max_loops = max_loops
+
+        self.agent = Agent(
+            agent_name=agent_name,
+            agent_description="You're the agent judge",
+            system_prompt=AGENT_JUDGE_PROMPT,
+            model_name=model_name,
+            max_loops=1,
+        )
+
+    def step(self, tasks: List[str]) -> str:
+        """
+        Processes a list of tasks and returns the agent's response.
+
+        Args:
+            tasks (List[str]): A list of tasks to be processed.
+
+        Returns:
+            str: The response generated by the agent.
+        """
+        prompt = any_to_str(tasks)
+        logger.debug(f"Running step with prompt: {prompt}")
+
+        print(prompt)
+
+        response = self.agent.run(
+            task=f"Evaluate the following output or outputs: {prompt}"
+        )
+        logger.debug(f"Received response: {response}")
+
+        return response
+
+    def run(self, tasks: List[str]) -> List[str]:
+        """
+        Executes the tasks in a loop, updating context and collecting responses.
+
+        Args:
+            tasks (List[str]): A list of tasks to be executed.
+
+        Returns:
+            List[str]: A list of responses generated by the agent for each iteration.
+        """
+        responses = []
+        context = ""
+
+        for _ in range(self.max_loops):
+            # Add context to the tasks if available
+            if context:
+                contextualized_tasks = [
+                    f"Previous context: {context}\nTask: {task}"
+                    for task in tasks
+                ]
+            else:
+                contextualized_tasks = tasks
+
+            # Get response for current iteration
+            current_response = self.step(contextualized_tasks)
+            responses.append(current_response)
+            logger.debug(
+                f"Current response added: {current_response}"
+            )
+
+            # Update context for next iteration
+            context = current_response
+
+            # Add to conversation history
+            logger.debug("Added message to conversation history.")
+
+        return responses