gofannon 0.25.14__tar.gz → 0.25.15__tar.gz

{gofannon-0.25.14 → gofannon-0.25.15}/PKG-INFO

@@ -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 → gofannon-0.25.15}/README.md

@@ -24,7 +24,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 → gofannon-0.25.15}/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-0.25.15/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-0.25.15/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-0.25.14 → gofannon-0.25.15}/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-0.25.15/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 → gofannon-0.25.15}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "gofannon"
-version = "0.25.14"
+version = "0.25.15"
 description = "A collection of tools for LLMs"
 authors = ["Trevor Grant <trevor.d.grant@gmail.com>"]
 license = "ASFv2"
@@ -8,7 +8,7 @@ readme = "README.md"
 packages = [{include = "gofannon"}]
 
 [tool.poetry.dependencies]
-python = "^3.10"
+python = ">=3.10,<4.0"
 openai = "^1.60.2"
 requests = "^2.32.3"
 GitPython = "^3.1.43"
@@ -16,26 +16,31 @@ python-dotenv = "^1.0.1"
 jsonschema = "^4.23.0"
 pygithub = "^2.6.1"
 
-pytest = { version = "^8.3.4", optional = true }
-langchain = { version = "^0.3.16", optional = true }
+# Optional dependencies
+pytest = { version = "^8.3.5", optional = true }
+langchain-core = { version = "^0.3.16", optional = true, python = "<3.13" }
 pydantic = { version = "^2.10.6", optional = true }
 smolagents = { version = "^1.6.0", optional = true }
 selenium = { version = "^4.10.0", optional = true }
-google-api-python-client = { version = "^2.161.0", optional = true}
-requests-mock = {version = "^1.12.1", optional = true}
+google-api-python-client = { version = "^2.154.0", optional = true }
+requests-mock = { version = "^1.12.1", optional = true }
 boto3 = { version = "^1.34.97", optional = true }
+anyio = { version = "^4.9.0", optional = true}
 
 [tool.poetry.extras]
-testing = ["pytest","requests-mock"]
-langchain = ["langchain", "pydantic"]
+testing = ["pytest", "requests-mock"]
+langchain = ["langchain-core", "pydantic"]
 smolagents = ["smolagents"]
 headless_browser = ["selenium"]
 google = ["google-api-python-client"]
 aws = ["boto3"]
+langflow = []
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.3.5"
 responses = "^0.25.7"
+pytest-asyncio = "0.26.0"
+mcp = "1.5.0"
 
 [build-system]
 requires = ["poetry-core"]