Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 04:45 UTC
| 1 | # composio-gemini |
| 2 | |
| 3 | Adapts Composio tools to the [`google-genai`](https://pypi.org/project/google-genai/) SDK as Python callables compatible with Gemini's Automatic Function Calling. |
| 4 | |
| 5 | ## Installation |
| 6 | |
| 7 | ```bash |
| 8 | pip install composio composio-gemini google-genai |
| 9 | ``` |
| 10 | |
| 11 | Set `COMPOSIO_API_KEY` (create one at https://dashboard.composio.dev/settings) and `GOOGLE_API_KEY` (from https://aistudio.google.com/apikey) in your environment. |
| 12 | |
| 13 | ## Quickstart |
| 14 | |
| 15 | `GeminiProvider` wraps each Composio tool as a typed Python callable. Pass the callables to `GenerateContentConfig(tools=...)` and the `google-genai` SDK derives function declarations from their signatures and executes tool calls automatically inside the chat loop; there is no manual tool-call handling. |
| 16 | |
| 17 | ```python |
| 18 | from composio import Composio |
| 19 | from composio_gemini import GeminiProvider |
| 20 | from google import genai |
| 21 | from google.genai import types |
| 22 | |
| 23 | composio = Composio(provider=GeminiProvider()) |
| 24 | client = genai.Client() |
| 25 | |
| 26 | # Create a session for your user |
| 27 | session = composio.create(user_id="user_123") |
| 28 | tools = session.tools() |
| 29 | |
| 30 | config = types.GenerateContentConfig(tools=tools) |
| 31 | chat = client.chats.create(model="gemini-3-pro-preview", config=config) |
| 32 | |
| 33 | response = chat.send_message( |
| 34 | "Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'" |
| 35 | ) |
| 36 | print(response.text) |
| 37 | ``` |
| 38 | |
| 39 | If you disable Automatic Function Calling and handle function calls yourself, `composio.provider.handle_response(response, session=session)` executes the function calls in a Gemini response the way that session's tools would, and returns `Part` objects ready to send back. For tools fetched with `composio.tools.get(user_id=...)`, pass `user_id=` instead: |
| 40 | |
| 41 | ```python |
| 42 | function_responses, executed = composio.provider.handle_response( |
| 43 | response, user_id="user_123" |
| 44 | ) |
| 45 | ``` |
| 46 | |
| 47 | A Gemini response does not record which user it belongs to, so pass the user or session whenever one `Composio` instance serves more than one. Without one, `handle_response` raises a `ValueError` once the provider has wrapped tools for more than one user or session. |
| 48 | |
| 49 | ## composio-gemini vs composio-google |
| 50 | |
| 51 | This package targets the `google-genai` SDK (`from google import genai`). [`composio-google`](../google) targets the older Vertex AI SDK (`vertexai.generative_models`). For new projects, Google recommends `google-genai`, so use this package. |
| 52 | |
| 53 | ## Links |
| 54 | |
| 55 | - Google provider docs: https://docs.composio.dev/docs/providers/google |
| 56 | - Composio docs: https://docs.composio.dev |