@xeven-solutions/ai-interview-widget

Embeddable AI avatar interview UI (Vapi) for Taqwi host apps.

Install

npm install @xeven-solutions/ai-interview-widget

Peer dependencies: react and react-dom ^18.

Usage

import { AiInterviewWidget } from "@xeven-solutions/ai-interview-widget";
import "@xeven-solutions/ai-interview-widget/styles.css";

<AiInterviewWidget
  config={{
    candidateName: "Alex",
    jobDescription: "Frontend Engineer…",
    roomId: "room-123",
    interviewDurationMinutes: 20,
    vapiPublicKey: process.env.VITE_VAPI_PUBLIC_KEY,
    // optional: vapiAssistantId, openAiApiKey, theme, redirectURL
  }}
  autoStart
  onComplete={(result) => {}}
  onError={(err) => {}}
/>

The host must import styles.css (or ./styles.css export). The package does not auto-inject CSS.

Host environment

Provide Vapi (and optional analysis) keys in the host app — they are not bundled:

| Host env (Vite example) | Purpose | | --- | --- | | VITE_VAPI_PUBLIC_KEY | Required for voice interview | | VITE_AI_INTERVIEW_OPENAI_KEY | Optional post-interview analysis | | VITE_VISION_INFERENCE_URL | Optional vision overlay |

Develop / publish (from this monorepo)

# from video-interview/
npm run widget:build
npm run widget:publish

Or from packages/ai-interview-widget:

npm run build
npm publish --access public

Requires npm login with access to the @xeven-solutions org and 2FA (or a granular publish token).

License

UNLICENSED — Taqwi / Xeven authorized hosts only.