composio-gemini 0.7.1__py3-none-any.whl

composio_gemini/__init__.py

@@ -0,0 +1,16 @@
+from composio import WorkspaceType, action
+
+from composio_langchain import Action, App, Tag, Trigger
+
+from .toolset import ComposioToolSet
+
+
+__all__ = (
+    "Action",
+    "App",
+    "Tag",
+    "Trigger",
+    "WorkspaceType",
+    "action",
+    "ComposioToolSet",
+)

composio_gemini/toolset.py

@@ -0,0 +1,118 @@
+import types
+import typing as t
+from inspect import Signature
+
+from composio import ActionType, AppType, TagType
+from composio.client.collections import ActionModel
+from composio.tools import ComposioToolSet as BaseComposioToolSet
+from composio.utils.shared import get_signature_format_from_schema_params
+
+
+class ComposioToolSet(
+    BaseComposioToolSet,
+    runtime="google_gemini",
+    description_char_limit=1024,
+    action_name_char_limit=64,
+):
+    """
+    Composio toolset for Google AI Python Gemini framework.
+
+    Example:
+    ```python
+        from google import genai
+        from google.genai import types
+
+        from composio_gemini import Action, ComposioToolSet
+
+
+        # Create composio client
+        toolset = ComposioToolSet()
+
+        # Create google client
+        client = genai.Client()
+
+        # Create genai client config
+        config = types.GenerateContentConfig(
+            tools=toolset.get_tools(  # type: ignore
+                actions=[
+                    Action.GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER,
+                ]
+            )
+        )
+        # Use the chat interface.
+        chat = client.chats.create(model="gemini-2.0-flash", config=config)
+        response = chat.send_message(
+            "Can you star composiohq/composio repository on github",
+        )
+        print(response.text)
+    ```
+    """
+
+    def _wrap_tool(
+        self,
+        schema: ActionModel,
+        entity_id: t.Optional[str] = None,
+    ) -> t.Callable:
+        """Wraps composio tool as Google Genai SDK compatible function calling object."""
+
+        docstring = schema.description
+        docstring += "\nArgs:"
+        for _param, _schema in schema.parameters.properties.items():
+            docstring += "\n    "
+            docstring += _param + ": " + _schema.get("description", _param.title())
+
+        docstring += "\nReturns:"
+        docstring += "\n    A dictionary containing response from the action"
+
+        def _execute(**kwargs: t.Any) -> t.Dict:
+            return self.execute_action(
+                action=schema.name,
+                params=kwargs,
+                entity_id=entity_id,
+            )
+
+        function = types.FunctionType(
+            code=_execute.__code__,
+            name=schema.name,
+            globals=globals(),
+            closure=_execute.__closure__,
+        )
+        parameters = get_signature_format_from_schema_params(
+            schema_params=schema.parameters.model_dump(),
+        )
+        setattr(function, "__signature__", Signature(parameters=parameters))
+        setattr(
+            function,
+            "__annotations__",
+            {p.name: p.annotation for p in parameters} | {"return": dict},
+        )
+        function.__doc__ = docstring
+        return function
+
+    def get_tools(
+        self,
+        actions: t.Optional[t.Sequence[ActionType]] = None,
+        apps: t.Optional[t.Sequence[AppType]] = None,
+        tags: t.Optional[t.List[TagType]] = None,
+        entity_id: t.Optional[str] = None,
+    ) -> t.List[t.Callable]:
+        """
+        Get composio tools wrapped as Google Genai SDK compatible function calling object.
+
+        :param actions: List of actions to wrap
+        :param apps: List of apps to wrap
+        :param tags: Filter the apps by given tags
+        :param entity_id: Entity ID for the function wrapper
+
+        :return: Composio tools wrapped as python callable
+        """
+        self.validate_tools(apps=apps, actions=actions, tags=tags)
+        return [
+            self._wrap_tool(schema=tool, entity_id=entity_id)
+            for tool in self.get_action_schemas(
+                actions=actions,
+                apps=apps,
+                tags=tags,
+                _populate_requested=True,
+            )
+        ]

composio_gemini-0.7.1.dist-info/METADATA

@@ -0,0 +1,96 @@
+Metadata-Version: 2.2
+Name: composio_gemini
+Version: 0.7.1
+Summary: Use Composio to get an array of tools with your Gemini agent.
+Home-page: https://github.com/ComposioHQ/composio
+Author: Composio
+Author-email: tech@composio.dev
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9,<4
+Description-Content-Type: text/markdown
+Requires-Dist: composio_core<0.8.0,>=0.7.0
+Requires-Dist: google-genai
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+## 🚀🔗 Integrating Composio with Google's Gemini SDK
+
+Streamline the integration of Composio with Google AI Python to enhance the capabilities of Gemini models, allowing them to interact directly with external applications and expanding their operational scope.
+
+### Objective
+
+- **Automate starring a GitHub repository** using conversational instructions via Google AI Python's Function Calling feature.
+
+### Installation and Setup
+
+Ensure you have the necessary packages installed and connect your GitHub account to allow your agents to utilize GitHub functionalities.
+
+```bash
+# Install Composio Gemini package
+pip install composio-gemini
+
+# Connect your GitHub account
+composio add github
+
+# View available applications you can connect with
+composio apps
+```
+
+### Usage Steps
+
+#### 1. Import Base Packages
+
+Prepare your environment by initializing necessary imports from Google AI Python and setting up your client.
+
+```python
+from google import genai
+
+# Create google client
+client = genai.Client()
+```
+
+### Step 2: Integrating GitHub Tools with Composio
+
+This step involves fetching and integrating GitHub tools provided by Composio, enabling enhanced functionality for Google AI Python operations.
+```python
+from google.genai import types
+
+from composio_gemini import Action, ComposioToolSet
+
+# Create composio client
+toolset = ComposioToolSet()
+
+# Create tools
+tools = toolset.get_tools(
+    actions=[
+        Action.GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER,
+    ]
+)
+
+# Create genai client config
+config = types.GenerateContentConfig(
+    tools=tools,  # type: ignore    
+)
+```
+
+### Step 3: Agent Execution
+
+This step involves configuring and executing the agent to carry out actions, such as starring a GitHub repository.
+
+```python
+# Use the chat interface.
+chat = client.chats.create(model="gemini-2.0-flash", config=config)
+response = chat.send_message(
+    "Can you star composiohq/composio repository on github",
+)
+print(response.text)
+```

composio_gemini-0.7.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+composio_gemini/__init__.py,sha256=K-52LhU-kCkRQGeydL0TiO-oWYgDdHjuN_Fua1BenGg,264
+composio_gemini/toolset.py,sha256=aWJaNEj73Vh5C90Kcl9HcFfPjfVKTFTzCXSRUX3F9_4,3777
+composio_gemini-0.7.1.dist-info/METADATA,sha256=KggA07R20U3Bcn_H9KNG8PeLVKK97DR0nvjWbpCg5lk,2692
+composio_gemini-0.7.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+composio_gemini-0.7.1.dist-info/top_level.txt,sha256=OXlT1cwZ_H8zLnD-WjZOokKdqRgsq5cqhx0uCnxCikk,16
+composio_gemini-0.7.1.dist-info/RECORD,,

composio_gemini-0.7.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.8.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

composio_gemini-0.7.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+composio_gemini