@itannix/svelte

@itannix/svelte

Svelte SDK for the ItanniX Voice AI platform. Add real-time voice interactions to your Svelte app with a single component.

Installation

npm install @itannix/svelte

Quick Start

<script>
  import { VoiceAssistant } from '@itannix/svelte';

  let assistant;
  let status = 'disconnected';
  let messages = [];

  function handleConnect() {
    assistant.connect();
  }

  function handleDisconnect() {
    assistant.disconnect();
  }
</script>

<VoiceAssistant
  workspaceKey="your-workspace-key"
  clientId="your-client-id"
  clientSecret="your-client-secret"
  bind:this={assistant}
  on:statusChange={(e) => status = e.detail}
  on:transcript={(e) => messages = [...messages, { role: 'user', text: e.detail }]}
  on:assistantMessage={(e) => {
    if (e.detail.done) {
      messages = [...messages, { role: 'assistant', text: e.detail.text }];
    }
  }}
/>

<p>Status: {status}</p>

<button onclick={handleConnect} disabled={status !== 'disconnected'}>
  Connect
</button>
<button onclick={handleDisconnect} disabled={status === 'disconnected'}>
  Disconnect
</button>

{#each messages as msg}
  <p><strong>{msg.role}:</strong> {msg.text}</p>
{/each}

Props

Prop	Type	Default	Description
workspaceKey	string	required	Your workspace API key from workspace settings
clientId	string	required	Your ItanniX client ID
clientSecret	string	required	Your client secret
serverUrl	string	'https://api.itannix.com'	API server URL

Events

Event	Detail	Description
statusChange	string	Connection status: 'connecting', 'connected', 'disconnected'
transcript	string	User's speech transcription
assistantMessage	{ text: string, done: boolean }	Assistant response (streaming)
functionCall	{ name: string, args: object, callId: string }	Function call from assistant

Methods

Access via bind:this:

<VoiceAssistant bind:this={assistant} ... />

<script>
  // Connect to the voice service
  assistant.connect();

  // Disconnect
  assistant.disconnect();

  // Send function call result back to assistant
  assistant.sendFunctionResult(callId, { success: true, data: ... });
</script>

License

MIT