Files
assistant-ui--assistant-ui/packages/react-ai-sdk

@assistant-ui/react-ai-sdk

This package re-exports @assistant-ui/ai-sdk, the framework-neutral home of the assistant-ui integration for the Vercel AI SDK. Existing imports keep working unchanged; new code should depend on @assistant-ui/ai-sdk directly.

Vercel AI SDK integration for @assistant-ui/react. Wraps the AI SDK chat in an assistant-ui runtime and forwards system messages and frontend tools through AssistantChatTransport. Each release line targets the AI SDK major pinned in its dependencies.

Installation

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

Usage

"use client";

import { AssistantRuntimeProvider } from "@assistant-ui/react";
import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
import { Thread } from "@/components/assistant-ui/thread";

export function Chat() {
  const runtime = useChatRuntime();
  return (
    <AssistantRuntimeProvider runtime={runtime}>
      <Thread />
    </AssistantRuntimeProvider>
  );
}

useChatRuntime defaults to AssistantChatTransport, which forwards frontend system messages and tool definitions to your backend. To customize the API URL, the cache, or other transport settings, pass a configured AssistantChatTransport to keep that forwarding behavior; pass DefaultChatTransport to opt out.

Full reference at assistant-ui.com/docs/runtimes/ai-sdk.