Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

feat(docs): add framework selector to quickstart page

Sushmithamallesh696f813f4770
diff --git a/docs/app/global.css b/docs/app/global.css
index eeebe83b7..22f9fb6d2 100644
--- a/docs/app/global.css
+++ b/docs/app/global.css
@@ -472,7 +472,6 @@ nav a[href*="app.composio"]:focus-visible {
--color-fd-primary: var(--composio-orange);
}
-
@layer base {
* {
@apply border-border outline-ring/50;
diff --git a/docs/components/quickstart/framework-selector.tsx b/docs/components/quickstart/framework-selector.tsx
new file mode 100644
index 000000000..f7aef3125
--- /dev/null
+++ b/docs/components/quickstart/framework-selector.tsx
@@ -0,0 +1,107 @@
+'use client';
+
+import Image from 'next/image';
+import { useState } from 'react';
+
+export type Framework =
+ | 'openai-agents'
+ | 'claude-agents'
+ | 'langchain'
+ | 'vercel-ai';
+
+interface FrameworkOption {
+ id: Framework;
+ name: string;
+ logo: string;
+}
+
+const frameworks: FrameworkOption[] = [
+ {
+ id: 'openai-agents',
+ name: 'OpenAI Agents',
+ logo: '/images/providers/openai-logo.svg',
+ },
+ {
+ id: 'claude-agents',
+ name: 'Claude Agents',
+ logo: '/images/providers/anthropic-logo.svg',
+ },
+ {
+ id: 'langchain',
+ name: 'LangChain',
+ logo: '/images/providers/langchain-logo.svg',
+ },
+ {
+ id: 'vercel-ai',
+ name: 'Vercel AI',
+ logo: '/images/providers/vercel-logo.svg',
+ },
+];
+
+interface FrameworkCardProps {
+ framework: FrameworkOption;
+ selected: boolean;
+ onSelect: () => void;
+}
+
+function FrameworkCard({ framework, selected, onSelect }: FrameworkCardProps) {
+ return (
+ <button
+ type="button"
+ onClick={onSelect}
+ className={`
+ flex flex-col items-start gap-4 rounded-xl border-2 p-5 text-left transition-all
+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2
+ ${selected
+ ? 'border-[var(--composio-orange)] bg-fd-card'
+ : 'border-fd-border bg-fd-card hover:bg-fd-accent/50'
+ }
+ `}
+ >
+ <div className="flex h-10 w-10 shrink-0 items-center justify-center">
+ <Image
+ src={framework.logo}
+ alt={`${framework.name} logo`}
+ width={40}
+ height={40}
+ className="h-8 w-auto dark:invert"
+ />
+ </div>
+
+ <span className="text-sm font-medium text-fd-foreground">
+ {framework.name}
+ </span>
+ </button>
+ );
+}
+
+interface FrameworkSelectorProps {
+ value?: Framework;
+ onChange?: (framework: Framework) => void;
+}
+
+export function FrameworkSelector({ value = 'openai-agents', onChange }: FrameworkSelectorProps) {
+ const [selected, setSelected] = useState<Framework>(value);
+
+ const handleSelect = (framework: Framework) => {
+ setSelected(framework);
+ onChange?.(framework);
+ };
+
+ return (
+ <div className="not-prose">
+ <div className="grid grid-cols-2 gap-3 sm:grid-cols-4">
+ {frameworks.map((framework) => (
+ <FrameworkCard
+ key={framework.id}
+ framework={framework}
+ selected={selected === framework.id}
+ onSelect={() => handleSelect(framework.id)}
+ />
+ ))}
+ </div>
+ </div>
+ );
+}
+
+export { frameworks };
diff --git a/docs/components/quickstart/index.tsx b/docs/components/quickstart/index.tsx
new file mode 100644
index 000000000..3cbd0d73d
--- /dev/null
+++ b/docs/components/quickstart/index.tsx
@@ -0,0 +1,3 @@
+export { FrameworkSelector, frameworks } from './framework-selector';
+export { QuickstartFlow, FrameworkOption } from './quickstart-flow';
+export type { Framework } from './framework-selector';
diff --git a/docs/components/quickstart/quickstart-flow.tsx b/docs/components/quickstart/quickstart-flow.tsx
new file mode 100644
index 000000000..c969a725d
--- /dev/null
+++ b/docs/components/quickstart/quickstart-flow.tsx
@@ -0,0 +1,160 @@
+'use client';
+
+import Image from 'next/image';
+import {
+ createContext,
+ useContext,
+ useState,
+ useEffect,
+ useRef,
+ type ReactNode,
+} from 'react';
+
+// Types
+interface FrameworkData {
+ id: string;
+ name: string;
+ logo: string;
+}
+
+interface QuickstartContextValue {
+ selectedId: string;
+ setSelectedId: (id: string) => void;
+ registerFramework: (data: FrameworkData) => void;
+ frameworks: FrameworkData[];
+}
+
+// Context to share state between QuickstartFlow and FrameworkOption
+const QuickstartContext = createContext<QuickstartContextValue | null>(null);
+
+export function useQuickstartFramework() {
+ const context = useContext(QuickstartContext);
+ return context?.selectedId ?? null;
+}
+
+// Framework option component - registers itself and conditionally renders content
+interface FrameworkOptionProps {
+ id: string;
+ name: string;
+ logo: string;
+ children: ReactNode;
+}
+
+export function FrameworkOption({ id, name, logo, children }: FrameworkOptionProps) {
+ const context = useContext(QuickstartContext);
+ const hasRegistered = useRef(false);
+
+ useEffect(() => {
+ if (context && !hasRegistered.current) {
+ context.registerFramework({ id, name, logo });
+ hasRegistered.current = true;
+ }
+ }, [context, id, name, logo]);
+
+ // Only render if this framework is selected
+ if (!context || context.selectedId !== id) {
+ return null;
+ }
+
+ return <>{children}</>;
+}
+
+// Card component for framework selection
+interface FrameworkCardProps {
+ id: string;
+ name: string;
+ logo: string;
+ selected: boolean;
+ onSelect: () => void;
+}
+
+function FrameworkCard({ name, logo, selected, onSelect }: FrameworkCardProps) {
+ return (
+ <button
+ type="button"
+ onClick={onSelect}
+ className={`
+ flex items-center gap-3 rounded-lg border px-3 py-2.5 text-left transition-all
+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2
+ ${selected
+ ? 'border-[var(--composio-orange)] bg-fd-accent/30'
+ : 'border-fd-border bg-fd-card hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)]'
+ }
+ `}
+ >
+ <div className="flex h-6 w-6 shrink-0 items-center justify-center">
+ <Image
+ src={logo}
+ alt={`${name} logo`}
+ width={24}
+ height={24}
+ className="h-5 w-auto dark:invert"
+ />
+ </div>
+ <span className="text-sm font-medium text-fd-foreground">{name}</span>
+ </button>
+ );
+}
+
+// Main wrapper component
+interface QuickstartFlowProps {
+ children: ReactNode;
+}
+
+export function QuickstartFlow({ children }: QuickstartFlowProps) {
+ const [frameworks, setFrameworks] = useState<FrameworkData[]>([]);
+ const [selectedId, setSelectedId] = useState<string>('');
+ const registeredIds = useRef<Set<string>>(new Set());
+
+ const registerFramework = (data: FrameworkData) => {
+ if (!registeredIds.current.has(data.id)) {
+ registeredIds.current.add(data.id);
+ setFrameworks((prev) => {
+ // Check if already exists
+ if (prev.some((f) => f.id === data.id)) {
+ return prev;
+ }
+ return [...prev, data];
+ });
+ }
+ };
+
+ // Set default selection to first framework once registered
+ useEffect(() => {
+ if (frameworks.length > 0 && !selectedId) {
+ setSelectedId(frameworks[0].id);
+ }
+ }, [frameworks, selectedId]);
+
+ const contextValue: QuickstartContextValue = {
+ selectedId,
+ setSelectedId,
+ registerFramework,
+ frameworks,
+ };
+
+ return (
+ <QuickstartContext.Provider value={contextValue}>
+ {/* Framework selector */}
+ {frameworks.length > 0 && (
+ <div className="not-prose mb-6">
+ <div className="grid grid-cols-2 gap-3 sm:grid-cols-4">
+ {frameworks.map((framework) => (
+ <FrameworkCard
+ key={framework.id}
+ id={framework.id}
+ name={framework.name}
+ logo={framework.logo}
+ selected={selectedId === framework.id}
+ onSelect={() => setSelectedId(framework.id)}
+ />
+ ))}
+ </div>
+ </div>
+ )}
+
+ {/* Render all children - FrameworkOption will conditionally show based on selection */}
+ {children}
+ </QuickstartContext.Provider>
+ );
+}
diff --git a/docs/content/docs/quickstart.mdx b/docs/content/docs/quickstart.mdx
index e68be7535..d87b93607 100644
--- a/docs/content/docs/quickstart.mdx
+++ b/docs/content/docs/quickstart.mdx
@@ -1,261 +1,431 @@
---
title: Quickstart
-description: Add composio tools to your AI agents
-keywords: [tutorial, setup, install, first agent]
+description: Build an AI agent with access to 1000+ tools
+keywords: [tutorial, setup, first agent]
---
-This guide walks you through **authenticated tool calling**—the foundation of how Composio connects your AI agents to real-world actions.
+Build your first AI agent with Composio Tools.
-You'll learn how to:
-1. **Discover and add tools** relevant to your use case (e.g., Slack, GitHub, Notion) to your AI agent
-2. **Authenticate tools** securely on behalf of a specific user, with fine-grained access control
-3. **Enable your LLM** (like OpenAI, Claude, or LangChain) to invoke these tools reliably using structured tool call formats
+<QuickstartFlow>
-## Prerequisites
-
-Before you begin, ensure you have:
-
-1. **A Composio account** - [Sign up here](https://platform.composio.dev) if you haven't already
-2. **Python 3.10+** or **Node.js 18+** installed on your system
-3. **Your API key** - Get it from the [developer dashboard](https://platform.composio.dev?next_page=/settings) and set it as an environment variable:
+<FrameworkOption id="openai-agents" name="OpenAI Agents" logo="/images/providers/openai-logo.svg">
+<Steps>
+<Step>
+### Install
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+<Tab value="Python">
```bash
-export COMPOSIO_API_KEY=your_api_key
+pip install composio composio-openai-agents openai-agents
```
+</Tab>
+<Tab value="TypeScript">
+```bash
+npm install @composio/core @composio/openai-agents @openai/agents
+```
+</Tab>
+</Tabs>
+</Step>
-## Install the SDK
+<Step>
+### Create session and run agent
-First, install the Composio SDK for your preferred language:
+[Sessions](/tool-router/users-and-sessions) are ephemeral, user-scoped and manage connections and tools for that user.
<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
- ```bash
- pip install composio
- ```
- </Tab>
- <Tab value="TypeScript">
- ```bash
- npm install @composio/core
- ```
- </Tab>
-</Tabs>
-
-## Authorize Tools & Run Them with an Agent
-
-Composio supports multiple LLM providers. Here's how to use Composio with some of the most popular ones:
+<Tab value="Python">
+```python
+import asyncio
+from composio import Composio
+from agents import Agent, Runner
+from composio_openai_agents import OpenAIAgentsProvider
+
+# Initialize Composio with OpenAI Agents provider
+composio = Composio(api_key="{{apiKey}}", provider=OpenAIAgentsProvider())
+
+external_user_id = "{{userId}}"
+
+# Create a tool router session
+session = composio.create(
+ user_id=external_user_id,
+)
+
+# Get tools from the session (native)
+tools = session.tools()
+
+# Create agent with tools
+agent = Agent(
+ name="Email Manager",
+ instructions="You are a helpful assistant that helps users manage their Gmail accounts.",
+ tools=tools,
+)
+
+# Run the agent
+async def main():
+ result = await Runner.run(
+ starting_agent=agent,
+ input="Send an email to {{email}} with the subject 'Hello from Composio' and the body 'This is a test email!'",
+ )
+ print(result.final_output)
-<Tabs items={['OpenAI Agents (Python)', 'Anthropic (TypeScript)', 'Vercel AI SDK (TypeScript)']}>
- <Tab value="OpenAI Agents (Python)">
- Install the OpenAI Agents provider:
+asyncio.run(main())
+```
+</Tab>
+<Tab value="TypeScript">
+```typescript
+import { Composio } from "@composio/core";
+import { Agent, run } from "@openai/agents";
+import { OpenAIAgentsProvider } from "@composio/openai-agents";
+
+// Initialize Composio with OpenAI Agents provider
+const composio = new Composio({
+ apiKey: "{{apiKey}}",
+ provider: new OpenAIAgentsProvider(),
+});
+
+const externalUserId = "{{userId}}";
+
+// Create a tool router session
+const session = await composio.create(externalUserId);
+
+// Get tools from the session (native)
+const tools = await session.tools();
+
+// Create agent with tools
+const agent = new Agent({
+ name: "Email Manager",
+ model: "gpt-4o",
+ instructions: "You are a helpful assistant. Use Composio tools to execute tasks.",
+ tools: tools,
+});
+
+// Run the agent
+console.log(`🔄 Running agent...`);
+const result = await run(
+ agent,
+ "Send an email to {{email}} with the subject 'Hello from Composio' and the body 'This is a test email!'"
+);
+
+console.log(`✅ Received response from agent`);
+if (result.finalOutput) {
+ console.log(result.finalOutput);
+}
+```
+</Tab>
+</Tabs>
+</Step>
+</Steps>
+</FrameworkOption>
- ```bash
- pip install composio openai-agents composio-openai-agents
- ```
+<FrameworkOption id="claude-agents" name="Claude Agents" logo="/images/providers/anthropic-logo.svg">
+<Steps>
+<Step>
+### Install
- ```python
- import asyncio
- from composio import Composio
- from agents import Agent, Runner
- from composio_openai_agents import OpenAIAgentsProvider
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+<Tab value="Python">
+```bash
+pip install composio composio-claude-agent-sdk claude-agent-sdk
+```
+</Tab>
+<Tab value="TypeScript">
+```bash
+npm install @composio/core @composio/claude-agent-sdk @anthropic-ai/claude-agent-sdk
+```
+</Tab>
+</Tabs>
+</Step>
- composio = Composio(api_key="your-api-key", provider=OpenAIAgentsProvider())
+<Step>
+### Create session and run agent
- # Id of the user in your system
- externalUserId = "pg-test-6dadae77-9ae1-40ca-8e2e-ba2d1ad9ebc4"
+[Sessions](/tool-router/users-and-sessions) are ephemeral, user-scoped and manage connections and tools for that user.
- # Create an auth config for gmail from the dashboard or programmatically
- auth_config_id = "your-auth-config-id"
- connection_request = composio.connected_accounts.link(
- user_id=externalUserId,
- auth_config_id=auth_config_id,
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+<Tab value="Python">
+```python
+import asyncio
+from composio import Composio
+from composio_claude_agent_sdk import ClaudeAgentSDKProvider
+from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, create_sdk_mcp_server
+
+# Initialize Composio
+composio = Composio(
+ api_key="{{apiKey}}",
+ provider=ClaudeAgentSDKProvider()
+)
+
+external_user_id = "{{userId}}"
+
+# Create a tool router session
+session = composio.create(
+ user_id=external_user_id,
+)
+
+# Get tools from the session (native)
+tools = session.tools()
+custom_server = create_sdk_mcp_server(name="composio", version="1.0.0", tools=tools)
+
+# Query Claude with MCP tools
+async def main():
+ options = ClaudeAgentOptions(
+ system_prompt="You are a helpful assistant",
+ permission_mode="bypassPermissions",
+ mcp_servers={
+ "composio": custom_server,
+ },
)
- # Redirect user to the OAuth flow
- redirect_url = connection_request.redirect_url
+ async with ClaudeSDKClient(options=options) as client:
+ await client.query(f"Send an email to {{email}} with the subject 'Hello from Composio' and the body 'This is a test email!'")
+ # Extract and print response
+ async for msg in client.receive_response():
+ print(msg)
- print(
- f"Please authorize the app by visiting this URL: {redirect_url}"
- ) # Print the redirect url to the user
+asyncio.run(main())
+```
+</Tab>
+<Tab value="TypeScript">
+```typescript
+import { Composio } from "@composio/core";
+import { ClaudeAgentSDKProvider} from "@composio/claude-agent-sdk";
+import { createSdkMcpServer, query } from "@anthropic-ai/claude-agent-sdk";
+
+// Initialize Composio
+const composio = new Composio({
+ apiKey: "{{apiKey}}",
+ provider: new ClaudeAgentSDKProvider(),
+});
+
+const externalUserId = "{{userId}}";
+
+// Create a tool router session
+const session = await composio.create(externalUserId);
+// Get tools from the session (native)
+const tools = await session.tools();
+
+const customServer = createSdkMcpServer({
+ name: "composio",
+ version: "1.0.0",
+ tools: tools,
+});
+
+// Initialize Claude client
+for await (const content of query({
+ prompt: "Send an email to {{email}} saying hello",
+ options: {
+ mcpServers: { composio: customServer },
+ permissionMode: "bypassPermissions",
+ },
+})) {
+ if (content.type === "assistant") {
+ console.log("Claude:", content.message);
+ }
+}
+
+console.log(`✅ Received response from Claude`);
+```
+</Tab>
+</Tabs>
+</Step>
+</Steps>
+</FrameworkOption>
- # Wait for the connection to be established
- connected_account = connection_request.wait_for_connection()
- print(
- f"Connection established successfully! Connected account id: {connected_account.id}"
- )
+<FrameworkOption id="langchain" name="LangChain" logo="/images/providers/langchain-logo.svg">
+<Steps>
+<Step>
+### Install
- # Get Gmail tools that are pre-configured
- tools = composio.tools.get(user_id=externalUserId, tools=["GMAIL_SEND_EMAIL"])
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+<Tab value="Python">
+```bash
+pip install composio langchain langchain-openai langchain-mcp-adapters
+```
+</Tab>
+<Tab value="TypeScript">
+```bash
+npm install @composio/core langchain @langchain/openai @langchain/mcp-adapters
+```
+</Tab>
+</Tabs>
+</Step>
- agent = Agent(
- name="Email Manager", instructions="You are a helpful assistant", tools=tools
- )
+<Step>
+### Create session and run agent
- # Run the agent
- async def main():
- result = await Runner.run(
- starting_agent=agent,
- input="Send an email to [email protected] with the subject 'Hello from composio' and the body 'Congratulations on sending your first email using AI Agents and Composio!'",
- )
- print(result.final_output)
-
- asyncio.run(main())
- ```
- </Tab>
- <Tab value="Anthropic (TypeScript)">
- Install the Composio Anthropic provider:
-
- ```bash
- npm i @composio/core @composio/anthropic @anthropic-ai/sdk
- ```
-
- ```typescript
- import { Composio } from "@composio/core";
- import { AnthropicProvider } from "@composio/anthropic";
- import Anthropic from "@anthropic-ai/sdk";
-
- // env: ANTHROPIC_API_KEY
- const anthropic = new Anthropic();
-
- const composio = new Composio({
- apiKey: "your-api-key",
- provider: new AnthropicProvider(),
- toolkitVersions: {
- "gmail": "20251111_00",
- }
- });
-
- // Id of the user in your system
- const externalUserId = "pg-test-6dadae77-9ae1-40ca-8e2e-ba2d1ad9ebc4";
-
- // Create an auth config for gmail from the dashboard or programmatically
- const authConfigId = "your-auth-config-id";
-
- const connectionRequest = await composio.connectedAccounts.link(
- externalUserId,
- authConfigId
- );
-
- // redirect the user to the OAuth flow
- const redirectUrl = connectionRequest.redirectUrl;
- console.log(`Please authorize the app by visiting this URL: ${redirectUrl}`);
-
- // wait for connection to be established
- const connectedAccount = await connectionRequest.waitForConnection();
- console.log(
- `Connection established successfully! Connected account id: ${connectedAccount.id}`
- );
-
- // Fetch tools for your user and execute
- const tools = await composio.tools.get(externalUserId, {
- tools: ["GMAIL_SEND_EMAIL"],
- });
-
- console.log(tools);
- const msg = await anthropic.messages.create({
- model: "claude-sonnet-4-5",
- messages: [
- {
- role: "user",
- content: `Send an email to [email protected] with the subject 'Hello from composio' and the body 'Congratulations on sending your first email using AI Agents and Composio!'`,
- },
- ],
- tools: tools,
- max_tokens: 1000,
- });
-
- const res = await composio.provider.handleToolCalls(externalUserId, msg);
- console.log("Email sent successfully!");
- ```
- </Tab>
- <Tab value="Vercel AI SDK (TypeScript)">
- Install the Composio Vercel Provider:
-
- ```bash
- npm i @composio/core @composio/vercel ai @ai-sdk/openai
- ```
-
- ```typescript
- import { Composio } from "@composio/core";
- import { VercelProvider } from "@composio/vercel";
- import { generateText } from "ai";
- import { openai } from "@ai-sdk/openai";
-
- const composio = new Composio({
- apiKey: "your-api-key",
- provider: new VercelProvider(),
- });
-
- // Id of the user in your system
- const externalUserId = "pg-test-6dadae77-9ae1-40ca-8e2e-ba2d1ac9ebc4";
-
- // Create an auth config for gmail from the dashboard or programmatically
- const authConfigId = "your-auth-config-id";
-
- const connectionRequest = await composio.connectedAccounts.link(
- externalUserId,
- authConfigId
- );
-
- // redirect the user to the OAuth flow
- const redirectUrl = connectionRequest.redirectUrl;
- console.log(`Please authorize the app by visiting this URL: ${redirectUrl}`);
-
- // wait for connection to be established
- const connectedAccount = await connectionRequest.waitForConnection();
-
- const tools = await composio.tools.get(externalUserId, "GMAIL_SEND_EMAIL");
-
- // env: OPENAI_API_KEY
- const { text } = await generateText({
- model: openai("gpt-5"),
- messages: [
- {
- role: "user",
- content: `Send an email to [email protected] with the subject 'Hello from composio' and the body 'Congratulations on sending your first email using AI Agents and Composio!'`,
- },
- ],
- tools: tools
- });
+[Sessions](/tool-router/users-and-sessions) are ephemeral, user-scoped and manage connections and tools for that user.
- console.log("Email sent successfully!", { text });
- ```
- </Tab>
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+<Tab value="Python">
+```python
+from composio import Composio
+from langchain.agents import create_agent
+from langchain_openai.chat_models import ChatOpenAI
+
+# Initialize Composio
+composio = Composio(api_key="{{apiKey}}")
+
+external_user_id = "{{userId}}"
+
+# Create a tool router session
+session = composio.create(
+ user_id=external_user_id,
+)
+
+# Get tools from the session (native)
+tools = session.tools()
+
+# Initialize LangChain model
+model = ChatOpenAI(model="gpt-4o")
+
+# Create agent
+agent = create_agent(
+ tools=tools,
+ model=model,
+)
+
+# Run the agent
+result = agent.invoke(
+ {
+ "messages": [
+ {
+ "role": "user",
+ "content": "Send an email to {{email}} with the subject 'Hello from Composio' and the body 'This is a test email!'",
+ }
+ ]
+ }
+)
+
+print("✅ Email sent successfully!")
+print(result)
+```
+</Tab>
+<Tab value="TypeScript">
+```typescript
+import { ChatOpenAI } from "@langchain/openai";
+import { createAgent } from "langchain";
+import { Composio } from "@composio/core";
+
+// Initialize Composio
+const composio = new Composio({
+ apiKey: "{{apiKey}}",
+});
+
+const externalUserId = "{{userId}}";
+
+// Create a tool router session
+const session = await composio.create(externalUserId);
+
+// Initialize LangChain model
+const llm = new ChatOpenAI({
+ model: "gpt-4o",
+});
+
+// Get tools from the session (native)
+const tools = await session.tools();
+
+// Create agent
+const agent = createAgent({
+ name: "Gmail Assistant",
+ systemPrompt: "You are a helpful gmail assistant.",
+ model: llm,
+ tools: tools,
+});
+
+// Run the agent
+console.log(`🔄 Running agent...`);
+const result = await agent.invoke({
+ messages: [
+ {
+ role: "user",
+ content: "Send an email to {{email}} with the subject 'Hello from Composio' and the body 'This is a test email!'",
+ },
+ ],
+});
+
+console.log(`✅ Received response from agent`);
+console.log(result);
+```
+</Tab>
</Tabs>
+</Step>
+</Steps>
+</FrameworkOption>
-<Callout title="What just happened?" type="info">
-You just:
-1. Authorized a user account with Composio
-2. Passed those tool permissions into an LLM framework
-3. Let the LLM securely call real tools on the user's behalf
+<FrameworkOption id="vercel-ai" name="Vercel AI" logo="/images/providers/vercel-logo.svg">
+<Steps>
+<Step>
+### Install
-All OAuth flows and tool execution were automatically handled by Composio.
-</Callout>
+<Tabs groupId="language" items={['TypeScript']} persist>
+<Tab value="TypeScript">
+```bash
+npm install @composio/core @composio/vercel ai @ai-sdk/openai @ai-sdk/mcp
+```
+</Tab>
+</Tabs>
+</Step>
+
+<Step>
+### Create session and run agent
+
+[Sessions](/tool-router/users-and-sessions) are ephemeral, user-scoped and manage connections and tools for that user.
+
+<Tabs groupId="language" items={['TypeScript']} persist>
+<Tab value="TypeScript">
+```typescript
+import { openai } from "@ai-sdk/openai";
+import { Composio } from "@composio/core";
+import { VercelProvider } from "@composio/vercel";
+import { stepCountIs, streamText } from "ai";
+
+// Initialize Composio with Vercel provider
+const composio = new Composio({
+ apiKey: "{{apiKey}}",
+ provider: new VercelProvider(),
+});
+
+const externalUserId = "{{userId}}";
+
+// Create a tool router session
+const session = await composio.create(externalUserId);
+
+// Get tools from the session (native)
+const tools = await session.tools();
+
+// Stream text with tools
+console.log(`🔄 Running agent...`);
+const stream = await streamText({
+ model: openai("gpt-4o-mini"),
+ prompt: "Send an email to {{email}} with the subject 'Hello from Composio' and the body 'This is a test email!'",
+ stopWhen: stepCountIs(10),
+ tools,
+});
+
+// Stream the response
+for await (const textPart of stream.textStream) {
+ process.stdout.write(textPart);
+}
+```
+</Tab>
+</Tabs>
+</Step>
+</Steps>
+</FrameworkOption>
+
+</QuickstartFlow>
## Next steps
<Cards>
<Card
- icon={<Plug />}
- title="Use Providers"
- href="/docs/providers/openai"
- description="Learn how to use Composio with various agent SDK and frameworks."
- />
- <Card
- icon={<Wrench />}
- title="Work with tools"
- href="/docs/executing-tools"
- description="Learn how to work with tools and tool calling on a deeper level with Composio."
- />
- <Card
- icon={<Key />}
- title="Manage authentication"
- href="/docs/custom-auth-configs"
- description="Authorize tools for multiple users."
+ title="Session management"
+ href="/docs/tool-router/users-and-sessions"
+ description="Learn about users, sessions, and how they work."
/>
<Card
- icon={<Zap />}
- title="Triggers"
- href="/docs/using-triggers"
- description="Listen for external events to trigger actions in your agents."
+ title="Tools and toolkits"
+ href="/docs/tool-router/tools-and-toolkits"
+ description="Learn about tools, toolkits, and how to configure them."
/>
</Cards>
diff --git a/docs/mdx-components.tsx b/docs/mdx-components.tsx
index 4984bdde3..dd3120aca 100644
--- a/docs/mdx-components.tsx
+++ b/docs/mdx-components.tsx
@@ -8,6 +8,7 @@ import { Step, Steps } from 'fumadocs-ui/components/steps';
import { Card, Cards } from 'fumadocs-ui/components/card';
import { ImageZoom } from 'fumadocs-ui/components/image-zoom';
import { ProviderCard, ProviderGrid } from '@/components/provider-card';
+import { FrameworkSelector, QuickstartFlow, FrameworkOption } from '@/components/quickstart';
import { Figure } from '@/components/figure';
import { Video } from '@/components/video';
import { CapabilityCard, CapabilityList } from '@/components/capability-card';
@@ -43,6 +44,9 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
Cards,
ProviderCard,
ProviderGrid,
+ FrameworkSelector,
+ QuickstartFlow,
+ FrameworkOption,
Figure,
Video,
CapabilityCard,