@kayro-ia/widget

Embeddable AI chat widget for your product — powered by Kairo.

Add a fully functional AI assistant to your app in 3 lines of code.

Installation

npm install @kayro-ia/widget

Quick start

import { AIWidget } from '@kayro-ia/widget'

export default function App() {
  return (
    <AIWidget
      apiKey="your_api_key"
      orchestratorUrl="https://kayro.com.ar"
    />
  )
}

Props

| Prop | Type | Required | Default | Description | |------|------|----------|---------|-------------| | apiKey | string | ✅ | — | Your Kairo API key | | orchestratorUrl | string | ✅ | — | Kairo orchestrator base URL | | title | string | | "Asistente" | Chat window header title | | placeholder | string | | "Escribí tu mensaje..." | Input placeholder | | primaryColor | string | | "#6366f1" | Accent color (bubble + user messages) | | position | "bottom-right" \| "bottom-left" | | "bottom-right" | Widget position | | initialOpen | boolean | | false | Open the chat window on load | | zIndex | number | | 9999 | CSS z-index | | userToken | string | | — | End-user auth token (forwarded to your MCP server) | | authHeaders | Record<string, string> | | — | Extra headers forwarded to your MCP server | | userId | string | | — | End-user ID (for analytics) | | userName | string | | — | End-user display name |

Requirements

• React 18+
• Modern browser (Chrome 92+, Firefox 90+, Safari 15+)

License

MIT