assistant-cloud

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

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