Files
Rahul Tarak caef908075 docs: refresh README(s) (#3801)
## Summary

Rewrites the stale root `README.md` against the current docs (structure
modeled on [earendil-works/pi](https://github.com/earendil-works/pi)'s
README).

- **Quickstarts** now use the session-based API (`composio.create()` →
`session.tools()`) that the docs treat as canonical, replacing the
legacy `composio.tools.get()` flow
- **Positioning** matches the docs welcome page: 1000+ pre-authenticated
toolkits, per-user sessions, auth, triggers, and a sandbox
- **New sections**: CLI install (curl / Homebrew / npm),
sessions-via-MCP note, repository layout, minimum runtime versions
- **Provider table** merged with package links; adds the Claude Agent
SDK providers (both SDKs) and the experimental Pi provider
(`@composio/experimental`); documents the Python
`composio-gemini`/`composio-google`/`composio-google-adk` split
- **Removed**: Rube section (no longer in docs), cover banner (replaced
with theme-adaptive brand logomark from brand.composio.dev),
master-branch pointer, internal OpenAPI-pull section, private
`@composio/ts-builders` listing

Docs-only change — no changeset needed.

## Preview

Rendered view: [README.md on this
branch](https://github.com/ComposioHQ/composio/blob/docs/refresh-root-readme/README.md)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 06:14:38 -07:00

2.1 KiB

composio-google-adk

Adapts Composio tools to Google ADK FunctionTool objects, so your ADK agents can take action across 1000+ apps.

Installation

pip install composio composio-google-adk google-adk

Set COMPOSIO_API_KEY (from the dashboard) and GOOGLE_API_KEY in your environment.

Quickstart

from composio import Composio
from composio_google_adk import GoogleAdkProvider
from google.adk.agents import Agent
from google.adk.runners import Runner
from google.adk.sessions import InMemorySessionService
from google.genai import types

composio = Composio(provider=GoogleAdkProvider())

# Each Composio session is scoped to one of your users
composio_session = composio.create(user_id="user_123")
tools = composio_session.tools()

agent = Agent(
    name="personal_assistant",
    model="gemini-2.0-flash",
    instruction="You are a helpful assistant. Use Composio tools to take action.",
    tools=tools,
)

session_service = InMemorySessionService()
session_service.create_session_sync(
    app_name="personal_assistant",
    user_id="user_123",
    session_id="1234",
)
runner = Runner(
    agent=agent,
    app_name="personal_assistant",
    session_service=session_service,
)

events = runner.run(
    user_id="user_123",
    session_id="1234",
    new_message=types.Content(
        role="user",
        parts=[types.Part(text="Star the repository composiohq/composio on GitHub")],
    ),
)
for event in events:
    if event.is_final_response() and event.content and event.content.parts:
        print(event.content.parts[0].text)

For multi-turn use, store composio_session.session_id and reuse it with composio.use(session_id) instead of calling create() again.

How tools are wrapped

GoogleAdkProvider turns each Composio tool into a google.adk.tools.FunctionTool with a Python signature and docstring generated from the tool's schema, so ADK can pass them to Gemini as regular function declarations.