@nexo-labs/chat-agent

Floating chat agent component for React applications with AI integration. Built on @assistant-ui/react.

Installation

pnpm add @nexo-labs/chat-agent

Usage

import { FloatingChatManager, ChatProvider, NexoPayloadChatAdapter } from '@nexo-labs/chat-agent'
import '@nexo-labs/chat-agent/styles.css'

const adapter = new NexoPayloadChatAdapter({ baseUrl: '/api/chat' })

function App() {
  return (
    <ChatProvider adapter={adapter}>
      <FloatingChatManager />
    </ChatProvider>
  )
}

Exports

Main (.)

• FloatingChatManager - Floating chat widget component
• ChatProvider / useChat - React context for chat state
• useAssistantRuntime - Hook for assistant runtime adapter
• NexoPayloadChatAdapter - Payload CMS adapter with RAG support
• MockAdapter - Mock adapter for testing
• Thread, Composer, AssistantMessage, UserMessage, MarkdownText - Pre-built UI components

Styles (./styles.css)

Tailwind CSS stylesheet. Import it in your app's entry point.

Features

• Adapter-based architecture for pluggable chat backends
• Payload CMS integration with RAG-enabled document search
• Pre-built UI components with markdown rendering and source citations
• Floating chat widget with chat history and session management
• Fully typed with TypeScript

Peer Dependencies

• react ^19.0.0
• react-dom ^19.0.0

License

MIT