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.

docs: name deprecated SDK packages at the install step (#4232)

Soumya Medapati3ea113b04cf2
diff --git a/docs/content/docs/migration-guide/new-sdk.mdx b/docs/content/docs/migration-guide/new-sdk.mdx
index 0ef60c661..70a96fb85 100644
--- a/docs/content/docs/migration-guide/new-sdk.mdx
+++ b/docs/content/docs/migration-guide/new-sdk.mdx
@@ -6,7 +6,7 @@ written: "December 2025"
---
<Callout type="info">
-This guide covers migrating from the legacy SDK (v1) to the current SDK (v3). The recommended way to use Composio is now through **sessions** — see [Migrating from Direct Tools to Sessions](/docs/migration-guide/direct-to-sessions) or [Configuring Sessions](/docs/configuring-sessions) if you're starting fresh.
+This guide covers migrating from the legacy SDK (v1) — `composio-core` on PyPI and npm — to the current SDK (v3): `composio` on PyPI, `@composio/core` on npm. Provider packages such as `composio-openai` kept their names across the rewrite: current releases work with v3, v1-era releases don't. The recommended way to use Composio is now through **sessions** — see [Migrating from Direct Tools to Sessions](/docs/migration-guide/direct-to-sessions) or [Configuring Sessions](/docs/configuring-sessions) if you're starting fresh.
</Callout>
In the last few months, we have experienced very rapid growth in usage of our platform. As such, our team has been working hard to radically improve the performance and developer experience of our platform.
diff --git a/docs/content/docs/quickstart.mdx b/docs/content/docs/quickstart.mdx
index 321c48d1c..23ead6e2c 100644
--- a/docs/content/docs/quickstart.mdx
+++ b/docs/content/docs/quickstart.mdx
@@ -25,6 +25,10 @@ The TypeScript SDK is ESM-only and requires Node.js 22.22.3 or newer. Use `impor
The Composio Python SDK requires **Python 3.10 or newer**.
<PackageInstall ecosystem="python" packages="python-dotenv composio composio-openai-agents openai-agents" />
+
+<Callout type="warn" title="Do not install composio-core">
+The current Python package is `composio`. The package `composio-core` is the legacy v1 SDK — it calls deprecated APIs and does not work with sessions. If an older tutorial or an AI coding assistant suggests it, install `composio` instead. See the [migration guide](/docs/migration-guide/new-sdk).
+</Callout>
</Tab>
<Tab value="TypeScript">
<PackageInstall
@@ -178,6 +182,10 @@ readline.close();
<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
<Tab value="Python">
<PackageInstall ecosystem="python" packages="python-dotenv composio composio-claude-agent-sdk claude-agent-sdk" />
+
+<Callout type="warn" title="Do not install composio-core">
+The current Python package is `composio`. The package `composio-core` is the legacy v1 SDK — it calls deprecated APIs and does not work with sessions. If an older tutorial or an AI coding assistant suggests it, install `composio` instead. See the [migration guide](/docs/migration-guide/new-sdk).
+</Callout>
</Tab>
<Tab value="TypeScript">
<PackageInstall