Skip to content
ArionTalk

Getting Started

ArionTalk adds voice conversations to any website. Visitors click a floating button, speak to an AI agent that understands your page content, and hear a spoken response — all with just a few lines of code.

Quick Start

The fastest way to get started is with the CDN. Add these three lines to any HTML page:

<ariontalk-widget></ariontalk-widget>
<script
  type="module"
  src="https://cdn.jsdelivr.net/npm/@ariontalk/widget@latest/dist/ariontalk.js"
  async
></script>

That’s it. A floating action button appears in the bottom-right corner. Click it to start a voice session.

Install via Package Manager

Terminal window
pnpm add @ariontalk/widget

Then import it and add the element to your page:

import '@ariontalk/widget';
<ariontalk-widget></ariontalk-widget>

Headless Usage (Core Only)

If you want the voice engine without the widget UI, install @ariontalk/core directly:

Terminal window
pnpm add @ariontalk/core
import { VoiceEngine, isVoiceChatSupported } from '@ariontalk/core';

This gives you full programmatic control over sessions, speech recognition, synthesis, and AI responses.

What to Expect

When a visitor clicks the floating button:

  1. Speech Recognition captures their voice and converts it to text
  2. Gemini Nano (on-device) processes the message using your page content as context
  3. Speech Synthesis speaks the AI response back to the visitor

The widget extracts your page content (text and images) automatically so the AI can answer questions about what the visitor sees.

Next Steps

  • Installation — All the ways to add ArionTalk to your project
  • Configuration — Widget attributes and settings
  • Theming — Customize colors, fonts, and appearance
  • Events — Listen for session lifecycle events