gofannon 0.25.14__py3-none-any.whl → 0.25.15__py3-none-any.whl

gofannon/base/__init__.py

@@ -5,11 +5,16 @@ from typing import Any, Callable
 import json
 import logging
 from pathlib import Path
+
+import anyio
+
 from ..config import ToolConfig
 
 from .smol_agents import SmolAgentsMixin
 from .langchain import LangchainMixin
 from .bedrock import BedrockMixin
+from .langflow import LangflowMixin
+from .mcp import MCPMixin
 
 
 @dataclass
@@ -62,7 +67,12 @@ class WorkflowContext:
         self.execution_log.append(entry)
 
 
-class BaseTool(SmolAgentsMixin, LangchainMixin, BedrockMixin, ABC):
+class BaseTool(SmolAgentsMixin,
+               LangchainMixin,
+               BedrockMixin,
+               LangflowMixin,
+               MCPMixin,
+               ABC):
     def __init__(self, **kwargs):
         self.logger = logging.getLogger(
             f"{self.__class__.__module__}.{self.__class__.__name__}"
@@ -111,3 +121,6 @@ class BaseTool(SmolAgentsMixin, LangchainMixin, BedrockMixin, ABC):
             return ToolResult(success=True, output=result)
         except Exception as e:
             return ToolResult(success=False, output=None, error=str(e), retryable=True)
+
+    async def execute_async(self, arguments: dict):
+        return await anyio.to_thread.run_sync(self.fn, **arguments)

gofannon/base/langflow.py

@@ -0,0 +1,111 @@
+try:
+    from langflow.custom import Component
+    from langflow.io import MessageTextInput, IntInput, BoolInput, FloatInput, Output
+    from langflow.schema import Data
+
+    _HAS_LANGFLOW = True
+except ImportError:
+    _HAS_LANGFLOW = False
+
+
+class LangflowMixin:
+    def import_from_langflow(self, langflow_component):
+        """Adapt a Langflow component to a Gofannon tool"""
+        if not _HAS_LANGFLOW:
+            raise RuntimeError(
+                "langflow is not installed. Install with `pip install langflow`"
+            )
+
+        self.name = langflow_component.display_name.replace(" ", "_").lower()
+        self.description = langflow_component.description
+
+        # Extract parameters from component inputs
+        parameters = {
+            "type": "object",
+            "properties": {},
+            "required": []
+        }
+
+        for component_input in langflow_component.inputs:
+            if component_input.name in ["self", "context"]:
+                continue
+
+            param_type = "string"
+            if isinstance(component_input, (IntInput, FloatInput)):
+                param_type = "number"
+            elif isinstance(component_input, BoolInput):
+                param_type = "boolean"
+
+            parameters["properties"][component_input.name] = {
+                "type": param_type,
+                "description": component_input.info or ""
+            }
+
+            if component_input.required:
+                parameters["required"].append(component_input.name)
+
+        self.definition = {
+            "function": {
+                "name": self.name,
+                "description": self.description,
+                "parameters": parameters
+            }
+        }
+
+        # Create execution wrapper
+        def adapted_fn(**kwargs):
+            result = langflow_component.build()(**kwargs)
+            return result.data if isinstance(result, Data) else result
+
+        self.fn = adapted_fn
+
+    def export_to_langflow(self):
+        """Convert Gofannon tool to Langflow component"""
+        if not _HAS_LANGFLOW:
+            raise RuntimeError(
+                "langflow is not installed. Install with `pip install langflow`"
+            )
+
+        parameters = self.definition.get("function", {}).get("parameters", {})
+        param_properties = parameters.get("properties", {})
+        required_params = parameters.get("required", [])
+
+        # Create input fields
+        component_inputs = []
+        type_map = {
+            "string": MessageTextInput,
+            "number": FloatInput,
+            "integer": IntInput,
+            "boolean": BoolInput
+        }
+
+        for param_name, param_def in param_properties.items():
+            input_type = param_def.get("type", "string")
+            InputClass = type_map.get(input_type, MessageTextInput)
+
+            component_inputs.append(
+                InputClass(
+                    name=param_name,
+                    display_name=param_name.replace("_", " ").title(),
+                    info=param_def.get("description", ""),
+                    required=param_name in required_params,
+                    tool_mode=True
+                )
+            )
+
+            # Define component class
+        class ExportedComponent(Component):
+            display_name = self.definition["function"]["name"].title()
+            description = self.definition["function"]["description"]
+            icon = "tool"
+
+            inputs = component_inputs
+            outputs = [Output(display_name="Result", name="result", method="run_tool")]
+
+            def run_tool(self, **kwargs):
+                result = self.tool.execute(context=None, **kwargs)
+                return Data(data=result.output)
+
+                # Attach tool instance to component class
+        ExportedComponent.tool = self
+        return ExportedComponent

gofannon/base/mcp.py

@@ -0,0 +1,6 @@
+from json import dumps
+
+class MCPMixin:
+    def export_to_mcp(self, fast_mcp_server=None):
+        """Convert Gofannon tool definition to MCP Tool schema"""
+        fast_mcp_server.add_tool(fn=self.fn, name=self.name, description=dumps(self.definition))

gofannon/config.py

@@ -13,7 +13,8 @@ class ToolConfig:
             'deepinfra_api_key': os.getenv('DEEPINFRA_API_KEY'),
             'arxiv_api_key': os.getenv('ARXIV_API_KEY'),
             'google_search_api_key': os.getenv('GOOGLE_SEARCH_API_KEY'),
-            'google_search_engine_id': os.getenv('GOOGLE_SEARCH_ENGINE_ID')
+            'google_search_engine_id': os.getenv('GOOGLE_SEARCH_ENGINE_ID'),
+            'nasa_apod_api_key': os.getenv('NASA_APOD_API_KEY'),
         }
 
     @classmethod

gofannon/nasa/apod.py

@@ -0,0 +1,68 @@
+from ..base import BaseTool
+from ..config import FunctionRegistry, ToolConfig
+import logging
+import requests
+
+logger = logging.getLogger(__name__)
+
+"""Fetch the Astronomy Picture of the Day (APOD) from NASA's API.
+
+This tool retrieves the daily astronomy image, including metadata such as the 
+title, explanation, date, and media type. It interacts with NASA's APOD API 
+and returns the data as a structured dictionary.
+
+Authentication:
+        Requires an API key from NASA, available at https://api.nasa.gov/
+        The API key should be set in the environment as NASA_APOD_API_KEY
+        or passed as an argument during initialization.
+"""
+
+@FunctionRegistry.register
+class AstronomyPhotoOfTheDayTool(BaseTool):
+    def __init__(self, api_key=None ,name='apod'):
+        super().__init__()
+        self.name = name
+        self.api_key = api_key or ToolConfig.get("nasa_apod_api_key")
+
+    @property
+    def definition(self):
+        return {
+            "type": "function",
+            "function": {
+                "name": self.name,
+                "description": "Get the Astronomy Picture of the Day from NASA",
+                "parameters":{
+                    "type": "object",
+                    "properties": {},
+                    "required": []
+                }
+            }
+        }
+    
+    def fn(self):
+        logger.debug("Fetching NASA APOD data")
+        if not self.api_key:
+            logger.error("API key is missing. Cannot fetch APOD data.")
+            return {"error": "API key is missing. Please set it in the environment or pass it as an argument."}
+        url = "https://api.nasa.gov/planetary/apod"
+        params = {
+            "api_key": self.api_key
+        }
+
+        try:
+            response = requests.get(url, params=params)
+            response.raise_for_status()
+            data = response.json()
+
+            return{
+                "title": data.get("title", "No title available"),
+                "date": data.get("date", "No date available"),
+                "explanation": data.get("explanation", "No explanation available"),
+                "url": data.get("url", None),
+                "media_type": data.get("media_type", "unknown"),
+            }
+        except requests.exceptions.RequestException as e:
+            logger.error(f"Error fetching data from NASA APOD: {e}")
+            return {
+                "error": str(e)
+            }

{gofannon-0.25.14.dist-info → gofannon-0.25.15.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: gofannon
-Version: 0.25.14
+Version: 0.25.15
 Summary: A collection of tools for LLMs
 License: ASFv2
 Author: Trevor Grant
@@ -16,17 +16,18 @@ Provides-Extra: aws
 Provides-Extra: google
 Provides-Extra: headless-browser
 Provides-Extra: langchain
+Provides-Extra: langflow
 Provides-Extra: smolagents
 Provides-Extra: testing
 Requires-Dist: GitPython (>=3.1.43,<4.0.0)
 Requires-Dist: boto3 (>=1.34.97,<2.0.0) ; extra == "aws"
-Requires-Dist: google-api-python-client (>=2.161.0,<3.0.0) ; extra == "google"
+Requires-Dist: google-api-python-client (>=2.154.0,<3.0.0) ; extra == "google"
 Requires-Dist: jsonschema (>=4.23.0,<5.0.0)
-Requires-Dist: langchain (>=0.3.16,<0.4.0) ; extra == "langchain"
+Requires-Dist: langchain-core (>=0.3.16,<0.4.0) ; (python_version < "3.13") and (extra == "langchain")
 Requires-Dist: openai (>=1.60.2,<2.0.0)
 Requires-Dist: pydantic (>=2.10.6,<3.0.0) ; extra == "langchain"
 Requires-Dist: pygithub (>=2.6.1,<3.0.0)
-Requires-Dist: pytest (>=8.3.4,<9.0.0) ; extra == "testing"
+Requires-Dist: pytest (>=8.3.5,<9.0.0) ; extra == "testing"
 Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
 Requires-Dist: requests (>=2.32.3,<3.0.0)
 Requires-Dist: requests-mock (>=1.12.1,<2.0.0) ; extra == "testing"
@@ -60,7 +61,7 @@ functionality for various tasks.
 3. New Contributor Friendly
    - [Curated contribution pathways](https://the-ai-alliance.github.io/gofannon/developers/) 
    - [Gamified Contributor Process](https://the-ai-alliance.github.io/gofannon/leaderboard.html)
-## 🎓🎓 Why the name `gofanon`? 🎓🎓
+## 🎓🎓 Why the name `gofannon`? 🎓🎓
 
 See [`why_the_name_gofannon`](https://the-ai-alliance.github.io/gofannon/about/the_name_gofannon/) for the rich story on why we chose to honor this Celtic Diety
 

{gofannon-0.25.14.dist-info → gofannon-0.25.15.dist-info}/RECORD

@@ -2,9 +2,11 @@ gofannon/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gofannon/arxiv/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gofannon/arxiv/get_article.py,sha256=SRGTXFXdXdXTIOLZKWUTXxZEYEqZFWFJEV2nTsU5qqU,1167
 gofannon/arxiv/search.py,sha256=37Zx1y2vAX1xYIKaAxzBGXE3qPHUZdAD2XR0H1Acs-4,4225
-gofannon/base/__init__.py,sha256=8-uJsYAbLD-2e4clX73QZ8eip9S2PJlQ9JMRNWFHxSI,3387
+gofannon/base/__init__.py,sha256=gFBxYPxhyy1yLyXIEgbVPqQSgnr6PzXnEb1S054IYQM,3685
 gofannon/base/bedrock.py,sha256=Z2c36R8jaIusgpmegbYVz2eR7lDBc0IhTtwiqUGOcT4,25646
 gofannon/base/langchain.py,sha256=25z9opy7E7qWP-DSn6oYAqKDg8i21az-kAKrsYLfyiQ,2704
+gofannon/base/langflow.py,sha256=0WfNJ9MnndyLJ-yUAStIuXZpCzOPItsGKgtxdNifmLM,3833
+gofannon/base/mcp.py,sha256=2e7f1FiD_M7wk4gOd7YNt4zLBgdLQTnWWYL0Kf5CzTY,253
 gofannon/base/smol_agents.py,sha256=p2YU5BrscavGk5X9R7HSJmtVR5OpOsQwCd9hwC9eBMk,2229
 gofannon/basic_math/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 gofannon/basic_math/addition.py,sha256=zA-xtUBNnGnQVqTJkBvjZwX0gnGZ6mrUGhrlTbsH1ts,1148
@@ -13,7 +15,7 @@ gofannon/basic_math/exponents.py,sha256=w4qDlFZ9M1lf6X-tjG-ndpECfCOS7Qtc_VLICw0o
 gofannon/basic_math/multiplication.py,sha256=PJ5sKWMCVlBaTeZ_j3gwYOEQXAhN-qIXhnrNcyhWGKM,1168
 gofannon/basic_math/subtraction.py,sha256=gM1_N1mZ3qAXC6qnkzfijKXiOx27Gg93-CaB_ifMbOQ,1164
 gofannon/cli.py,sha256=-T-jjBNl_74TsGRcrjxsQnG0-wA2neYhncnaqCiEzPo,1733
-gofannon/config.py,sha256=N1xmWTbcyDPZT3r_ZuwW1RI0VRhDcbf3qIasEZZNwyc,1718
+gofannon/config.py,sha256=KPVtjBnpwfM39EQg-_xiqL1UFxcuQehrQIUS6HHBP6k,1784
 gofannon/github/__init__.py,sha256=VFw4sJIt4Zc0-__eYnksN8Ku9qMhbPpHJEkXMWUiD30,4
 gofannon/github/commit_file.py,sha256=jdQGQHbrZx4521XgTbx5N0Ss8fDyl7hvp9sjDW15v9U,2573
 gofannon/github/commit_files.py,sha256=OZclhhSejRB1CYmd7IGYvdJZEWBzpaRRKK5S8NQxALU,4554
@@ -27,6 +29,8 @@ gofannon/google_search/google_search.py,sha256=WRaGSLoeZjy5Qtn89Sp01nNugiGI0NL1Z
 gofannon/headless_browser/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gofannon/headless_browser/base.py,sha256=bgvBvkTNCqRnhC8Ffc6oZ3yoxpOl6fkAq0doDKnQtt8,1721
 gofannon/headless_browser/headless_browser_get.py,sha256=kOnHxfoZayfCuS6OKloLdwxehiInwcd5dM0HbKAeM5U,1182
+gofannon/nasa/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gofannon/nasa/apod.py,sha256=YhH3pdAoIGvteJt6krYzfjNsIx0g4Y4yOTh2DvRuzEo,2404
 gofannon/nhsta/__init__.py,sha256=jTV6arXumVgJagKOq6GnYhHwcX9t7Jjqq5JvsE5-zxQ,1925
 gofannon/open_notify_space/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 gofannon/open_notify_space/iss_locator.py,sha256=STLNSD5HriRR6grpRpiTRDbqVRtWMPVoGuV8SygHGNY,4734
@@ -39,7 +43,7 @@ gofannon/reasoning/sequential_cot.py,sha256=m9c8GnyTtmI-JntCuhkoFfULAabVOxsYgTRU
 gofannon/reasoning/tree_of_thought.py,sha256=TRhRJQNsFVauCLw4TOvQCDcX1nGmp_wSg9H67GJn1hs,10574
 gofannon/wikipedia/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gofannon/wikipedia/wikipedia_lookup.py,sha256=J6wKPbSivCF7cccaiRaJW1o0VqNhQAGfrh5U1ULLesg,2869
-gofannon-0.25.14.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-gofannon-0.25.14.dist-info/METADATA,sha256=1kkXxb_c_NmP30eDMPwktODU5SwQ2uaPIKH1b9pPX9s,5352
-gofannon-0.25.14.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-gofannon-0.25.14.dist-info/RECORD,,
+gofannon-0.25.15.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+gofannon-0.25.15.dist-info/METADATA,sha256=vyfSJCkUQCWoM_KNFCwjikONrV7kcVo7rv8vVvY0DWE,5415
+gofannon-0.25.15.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+gofannon-0.25.15.dist-info/RECORD,,