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.