Skip to main content
Use the widget when you want threads, messages, actions, and wallet integration in one browser surface.

​
Choose the widget when

  • You want a production-ready interface quickly.
  • A standard thread, message, and composer layout fits your product.
  • You want browser wallet, Para, or Privy authentication.
  • You prefer configuration over building every React component.
Use the headless library when you need a fully custom interface.

​
Cross-origin authentication

A separate-origin host cannot rely on the Portal’s first-party cookie. The widget uses a wallet or provider proof to create an origin-bound session for the embedding application. That session authenticates the widget’s account, thread, and Agent requests without opening another OAuth window on the first message.
Serve production embeds over HTTPS, and add every production and development origin to the selected wallet provider’s allowlist. Never put a provider secret in browser configuration.

​
Continue with the widget guides

Quickstart

Add the widget to a frontend and render the first conversation.

Installation

Configure the package, environment, and authentication provider.

Customization

Change layout, components, and behavior.

Troubleshooting

Diagnose configuration, origin, and runtime issues.
Last modified on August 31, 2026