@devries-cameron20 / composio Mirror · read-only / commits / b5ef8dcc7
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 22, 22:00 UTC

feat: update SDK installation instructions and enhance development scripts

- Changed the "dev" script to run build snippets before starting the documentation server. - Added a new "dev:all" task in turbo.json for better dependency management. - Updated installation commands in documentation to reflect the new version 0.8.0 for various Composio packages. - Adjusted authentication snippets and examples for clarity and accuracy.

balyan.sid@gmail.com committed Jul 22, 2025 at 12:15 UTC b5ef8dcc7f75c82a8104c3a2e89c50aeab405957
17 files changed +52 -44
fern/docs/get-started/quickstart.mdx
+2 -2
@@ -30,7 +30,7 @@ First and foremost, install the Composio SDK.
30 npm install @composio/core
31 ```
32 ```python Python
33 -pip install composio==1.0.0rc9
33 +pip install composio==0.8.0
34 ```
35 </CodeGroup>
36
@@ -160,7 +160,7 @@ You may install the OpenAI Agents provider as well!
160
161 **Installation**
162 ```bash
163 -pip install composio_openai_agents==1.0.0rc9
163 +pip install composio_openai_agents==0.8.0
164 ```
165
166 ```python maxLines=60
fern/package.json
+2 -1
@@ -18,7 +18,8 @@
18 "snippets:dev": "bun watch scripts/build-snippets.ts --watch",
19 "add-og": "uv run scripts/add_og_imgs.py",
20 "check": "fern check",
21 - "dev": "fern docs dev",
21 + "dev": "bun run scripts/build-snippets.ts && (bun run scripts/build-snippets.ts --watch & fern docs dev)",
22 + "dev:docs": "fern docs dev",
23 "links": "fern docs broken-links",
24 "build": "echo 'Build orchestrated by Turbo'",
25 "preview": "fern generate --docs --preview --log-level debug",
fern/pages/src/examples/sample-script.mdx
+1 -1
@@ -12,7 +12,7 @@ This tutorial will show you the basics of how to use the Composio SDK to call to
12 SAMPLE
13
14 ```bash
15 -pip install composio==1.0.0rc9
15 +pip install composio==0.8.0
16 ```
17
18 Here's a complete Python example that demonstrates the Composio SDK:
fern/pages/src/examples/sample-webserver/sample-webserver.mdx
+1 -1
@@ -15,7 +15,7 @@ This tutorial shows you a minimal example of a web server that can use Composio.
15 Using `bun` for this example, it is super convenient for rapid prototyping.
16
17 ```bash
18 -bun install @composio/core@next openai hono
18 +bun install @composio/core openai hono
19 ```
20
21 Please set the following environment variables:
fern/pages/src/get-started/providers.mdx
+5 -5
@@ -92,13 +92,13 @@ Different providers may require additional packages:
92 <CodeGroup>
93 ```shell Python
94 # Core SDK (includes OpenAI provider)
95 -pip install composio==1.0.0rc9
95 +pip install composio==0.8.0
96
97 # Additional providers
98 -pip install composio_anthropic==1.0.0rc9
99 -pip install composio_google==1.0.0rc9
100 -pip install composio_langchain==1.0.0rc9
101 -pip install composio_crewai==1.0.0rc9
98 +pip install composio_anthropic==0.8.0
99 +pip install composio_google==0.8.0
100 +pip install composio_langchain==0.8.0
101 +pip install composio_crewai==0.8.0
102 ```
103 ```shell Typescript
104 # Core SDK (includes OpenAI provider)
fern/pages/src/get-started/quickstart.mdx
+3 -3
@@ -31,10 +31,10 @@ First, install the Composio SDK for your preferred language:
31
32 <CodeGroup>
33 ```bash title="Python" for="python"
34 -pip install composio==1.0.0rc9
34 +pip install composio==0.8.0
35 ```
36 ```bash title="TypeScript" for="typescript"
37 -npm install @composio/core@next
37 +npm install @composio/core
38 ```
39 </CodeGroup>
40
@@ -106,7 +106,7 @@ You may install the OpenAI Agents provider as well!
106
107 **Installation**
108 ```bash
109 -pip install composio_openai_agents==1.0.0rc9
109 +pip install composio_openai_agents==0.8.0
110 ```
111
112 <SnippetCode
fern/pages/src/migration-guide.mdx
+1 -1
@@ -73,7 +73,7 @@ Upgrade to the latest SDK version using the appropriate package manager:
73 pip install -U composio
74 ```
75 ```typescript TypeScript
76 -npm install @composio/core@next
76 +npm install @composio/core
77 ```
78 </CodeGroup>
79
fern/pages/src/providers/anthropic.mdx
+1 -1
@@ -14,7 +14,7 @@ The Anthropic provider can be installed for both SDKs.
14
15 <CodeGroup>
16 ```bash title="Python" for="python" maxLines=60 wordWrap
17 -pip install composio_anthropic==1.0.0rc9
17 +pip install composio_anthropic==0.8.0
18 ```
19
20 ```bash title="TypeScript" for="typescript" maxLines=60 wordWrap
fern/pages/src/providers/crewai.mdx
+1 -1
@@ -15,7 +15,7 @@ The CrewAI Provider formats the Composio tools into an object compatible with Cr
15 The CrewAI provider is available for only the Python SDK.
16
17 ```python Python maxLines=60 wordWrap
18 -pip install composio_crewai==1.0.0rc9
18 +pip install composio_crewai==0.8.0
19 ```
20
21 ## Usage
fern/pages/src/providers/langchain.mdx
+1 -1
@@ -11,7 +11,7 @@ The LangChain Provider transforms Composio tools into a format compatible with L
11 ## Setup
12 <CodeGroup>
13 ```bash title="Python" for="python"
14 -pip install composio_langchain==1.0.0rc9 langchain
14 +pip install composio_langchain==0.8.0 langchain
15 ```
16 ```bash title="TypeScript" for="typescript"
17 npm install @composio/langchain
fern/pages/src/providers/openai-agents.mdx
+1 -1
@@ -15,7 +15,7 @@ OpenAI Agents SDK is different from the OpenAI SDK. It helps build agentic AI ap
15 ## Setup
16
17 ```bash
18 -pip install composio_openai_agents==1.0.0rc9 openai-agents
18 +pip install composio_openai_agents==0.8.0 openai-agents
19 ```
20
21 ### Usage
fern/pages/src/providers/openai.mdx
+1 -1
@@ -13,7 +13,7 @@ By default, the OpenAI Provider is installed when you install the Composio SDK.
13
14 <CodeGroup>
15 ```bash title="Python" for="python"
16 -pip install composio_openai==1.0.0rc9
16 +pip install composio_openai==0.8.0
17 ```
18 ```bash title="TypeScript" for="typescript"
19 npm install @composio/openai
fern/pages/src/tool-calling/authenticating-tools.mdx
+2 -2
@@ -91,7 +91,7 @@ If you know the required authentication fields for your toolkit (like `apiKey` f
91 <SnippetCode
92 src="fern/snippets/tool-calling/python/auth-tools.py"
93 startLine={23}
94 - endLine={31}
94 + endLine={34}
95 title="Python"
96 />
97 <SnippetCode
@@ -114,7 +114,7 @@ The auth scheme information is typed and can be configured as follows:
114 <CodeGroup>
115 <SnippetCode
116 src="fern/snippets/tool-calling/python/auth-tools.py"
117 - startLine={32}
117 + startLine={35}
118 endLine={44}
119 title="Python"
120 />
fern/pages/src/tool-calling/custom-tools.mdx
+19 -20
@@ -149,6 +149,25 @@ def get_issue_info(
149 2. Using `connectionConfig` - For making direct API calls when needed:
150
151 <CodeGroup>
152 +```python Python maxLines=60 wordWrap
153 +import requests
154 +
155 +@composio.tools.custom_tool(toolkit="github")
156 +def get_issue_info_direct(
157 + request: GetIssueInfoInput,
158 + execute_request: ExecuteRequestFn,
159 + auth_credentials: dict,
160 +) -> dict:
161 + """Get information about a GitHub issue."""
162 + response = requests.get(
163 + f"https://api.github.com/repos/composiohq/composio/issues/{request.issue_number}",
164 + headers={
165 + "Accept": "application/vnd.github.v3+json",
166 + "Authorization": f"Bearer {auth_credentials['access_token']}",
167 + },
168 + )
169 + return {"data": response.json()}
170 +```
171 ```typescript TypeScript maxLines=60 wordWrap
172 const tool = await composio.tools.createCustomTool({
173 slug: 'GITHUB_DIRECT_API',
@@ -176,26 +195,6 @@ const tool = await composio.tools.createCustomTool({
195 });
196
197 ```
179 -```python Python maxLines=60 wordWrap
180 -import requests
181 -
182 -@composio.tools.custom_tool(toolkit="github")
183 -def get_issue_info_direct(
184 - request: GetIssueInfoInput,
185 - execute_request: ExecuteRequestFn,
186 - auth_credentials: dict,
187 -) -> dict:
188 - """Get information about a GitHub issue."""
189 - response = requests.get(
190 - f"https://api.github.com/repos/composiohq/composio/issues/{request.issue_number}",
191 - headers={
192 - "Accept": "application/vnd.github.v3+json",
193 - "Authorization": f"Bearer {auth_credentials['access_token']}",
194 - },
195 - )
196 - return {"data": response.json()}
197 -```
198 -
198 </CodeGroup>
199
200 ### Using Custom Headers and Query Parameters
fern/snippets/tool-calling/python/auth-tools.py
+4 -2
@@ -27,7 +27,9 @@ serp_auth_config_id = "ac_VWmFEC55Zgv6"
27 user_api_key = "sk_1234567890"
28
29 connection_request = composio.connected_accounts.initiate(
30 - user_id=user_id, auth_config_id=serp_auth_config_id, config=auth_scheme.api_key(user_api_key)
30 + user_id=user_id,
31 + auth_config_id=serp_auth_config_id,
32 + config={"auth_scheme": "API_KEY", "val": user_api_key},
33 )
34
35 # Auth scheme config for Airtable Bearer
@@ -40,5 +42,5 @@ user_bearer_token = "1234567890"
42 airtable_connection_req = composio.connected_accounts.initiate(
43 user_id=user_id,
44 auth_config_id=airtable_auth_config_id,
43 - config=auth_scheme.bearer_token()
45 + config={"auth_scheme": "BEARER_TOKEN", "val": user_bearer_token},
46 )
fern/turbo.json
+6
@@ -19,6 +19,12 @@
19 "cache": false
20 },
21
22 + "dev:all": {
23 + "dependsOn": ["dev:deps"],
24 + "persistent": true,
25 + "cache": false
26 + },
27 +
28 "api:pull": {
29 "outputs": ["apis/openapi.yml", "apis/openapi-mcp.json"],
30 "cache": true
python/examples/auth_configs.py
+1 -1
@@ -25,7 +25,7 @@ auth_config = composio.auth_configs.create(
25 "credentials": {
26 "client_id": "1234567890",
27 "client_secret": "1234567890",
28 - "oauth_redirect_uri": "https://backend.composio.dev/api/v1/auth-apps/add",
28 + "oauth_redirect_uri": "https://backend.composio.dev/api/v3/toolkits/auth/callback",
29 },
30 },
31 )