@devries-cameron20 / composio Mirror · read-only
Fork 0

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

next
md 56 lines 2.43 KB
Rendered Raw
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