`assistant-cloud`

Server- and client-side SDK for Assistant Cloud, the managed thread-history, telemetry, and file-storage backend for @assistant-ui/react.

Installation

npm install @assistant-ui/react @assistant-ui/react-ai-sdk assistant-cloud

Usage

Pass an AssistantCloud instance to your runtime hook (typically useChatRuntime from @assistant-ui/react-ai-sdk):

import { AssistantCloud, AssistantRuntimeProvider } from "@assistant-ui/react";
import { useChatRuntime } from "@assistant-ui/react-ai-sdk";

const cloud = new AssistantCloud({
  baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,
  anonymous: true,
});

export function Provider({ children }: { children: React.ReactNode }) {
  const runtime = useChatRuntime({ cloud });
  return <AssistantRuntimeProvider runtime={runtime}>{children}</AssistantRuntimeProvider>;
}

Authentication

Mode	Required fields	Use case
Anonymous	`baseUrl`, `anonymous: true`	Demos and unauthenticated playgrounds.
JWT	`baseUrl`, `authToken: () => Promise<string \| null>`	Browser apps with their own auth.
API key (server)	`apiKey`, `userId`, `workspaceId`	Server-side admin and data-plane jobs.

For advanced persistence adapters and MCP sampling instrumentation, see the docs.