Install

pnpm add @supersolutions/super-chat-core @supersolutions/super-chat-react @supersolutions/super-chat-ui
@supersolutions/super-chat-core
Runtime, provider adapters, cards and the proxy handler. No React, no LLM SDK.
@supersolutions/super-chat-react
Thread state and run control for React 18 and 19.
@supersolutions/super-chat-ui
Card renderers, the composer and other parts, and styles.css.
  1. Import the styles

    import "@supersolutions/super-chat-ui/styles.css";
  2. Add the proxy route

    // app/api/agent/route.ts
    import { createProxyHandler } from "@supersolutions/super-chat-server";
    
    export const POST = createProxyHandler({
      providers: {
        openai: {
          baseUrl: "https://api.openai.com/v1",
          apiKey: () => process.env.OPENAI_API_KEY!,
          allowPaths: ["/responses", "/responses/*", "/chat/completions"],
        },
      },
    });
  3. Render a thread

    <AgentProvider client={client}>
      <CardRendererProvider renderers={BUILTIN_RENDERERS}>
        <Thread />
        <Composer />
      </CardRendererProvider>
    </AgentProvider>
Getting started, step by step →