@amodalai/react

React components, hooks, and clients for a deployed Amodal agent.

Install

npm install @amodalai/react

Requires React and React DOM 18 or 19.

Usage

import { ChatWidget } from '@amodalai/react/widget';
import '@amodalai/react/widget/style.css';

export function AgentChat({ getAppToken }: { getAppToken: () => Promise<string> }) {
  return <ChatWidget serverUrl="https://app.example.com/api/agent" getToken={getAppToken} position="floating" />;
}

getAppToken supplies your application token to your proxy, which must authenticate each request and authorize its scope, session, and operation. Keep runtime credentials on the backend.

Main exports

• ChatWidget renders chat in floating, inline, right, or bottom layout.
• AmodalProvider configures clients for data, action, session, and event hooks. AmodalChat renders inline chat inside it.
• ArtifactHost shares files between ChatWidget and your own panels.
• RuntimeClient, SdkClient, and ChatClient provide imperative access.

See the React reference, chat reference, and embedding guide.

License

MIT