Runtime Hooks

Runtime hooks create the AssistantRuntime passed to AssistantRuntimeProvider.

import {
  AssistantRuntimeProvider,
  useLocalRuntime,
} from "@assistant-ui/react";

function App() {
  const runtime = useLocalRuntime(chatModelAdapter);

  return (
    <AssistantRuntimeProvider runtime={runtime}>
      {children}
    </AssistantRuntimeProvider>
  );
}

Core Runtime Hooks

• useLocalRuntime creates a runtime from a ChatModelAdapter.
• useRemoteThreadListRuntime adds backend-backed thread list management.
• useExternalStoreRuntime adapts an external message store.
• useAssistantTransportRuntime consumes assistant-stream transport events.

Integration Runtime Hooks

• useChatRuntime adapts AI SDK chat helpers.
• useDataStreamRuntime adapts assistant-stream data streams.
• useLangGraphRuntime adapts LangGraph.
• useCloudThreadListRuntime uses Assistant Cloud for thread persistence.

Runtime Options

Most runtime hooks accept adapters for persistence, attachments, speech, dictation, feedback, and suggestions. See Adapters for the adapter map.