Installation

NPM (React/Next.js/Vite)

npm install sidenetai-sdk

import { initSidenet } from 'sidenetai-sdk';

// `tokens` is the body your backend got from POST /v1/token — see Authentication.
initSidenet({
  copilotId: 'your-copilot-id',
  auth: { ...tokens },
});

Peer dependencies (NPM package only): the only peers are react and react-dom (>=18) — which your React/Next/Vite app already has. Everything else (assistant-ui, the AI SDK, Radix, animation, icons, syntax highlighting, etc.) is bundled into the package, so there’s nothing else to install. The SDK renders in its own React root inside a Shadow DOM and never shares those libraries with your app — this is what avoids version-skew crashes (e.g. duplicate React contexts blanking the panel).

Using the CDN standalone bundle below instead? It bundles React too — so it has no peer dependencies at all and works in Vue, Angular, or vanilla JS with nothing else installed.

CDN (Static sites, WordPress, vanilla JS)

<script src="https://unpkg.com/sidenetai-sdk@latest/dist/sidenetai-sdk.standalone.umd.js"></script>
<script>
  Sidenet.initSidenet({
    copilotId: 'your-copilot-id',
    auth: { ...tokens },   // from your backend — see Authentication
  });
</script>

The standalone bundle (~13MB uncompressed, ~2.8MB gzipped) includes React and all dependencies. Use the NPM package if you already have React.

Next step: mint a session token on your backend. It is the one thing the SDK cannot start without.

Getting Started

Methods

Customization

NPM (React/Next.js/Vite)

CDN (Static sites, WordPress, vanilla JS)

​NPM (React/Next.js/Vite)

​CDN (Static sites, WordPress, vanilla JS)

NPM (React/Next.js/Vite)

CDN (Static sites, WordPress, vanilla JS)