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
)