#AssemblyAI Voice Search Widget

Using this widget, you can effortlessly add voice search to your website and/or app.

• Getting Started
• Supported Platforms/Browsers
• Supported Languages
• Getting an AssemblyAI API Token
• Feedback/Support

#Getting Started

#1: Include AssemblyAI

<script src="https://cdn.jsdelivr.net/gh/assemblyai/assemblyai-algolia-voice-widget/public/assemblyai-voice-helper.js"></script>

#2. Configure Algolia InstantSearch

The below Voice Search Widget requires you have an AssemblyAI Token, which you can get here

const search = instantsearch({
    indexName: '...',
    searchClient: algoliasearch('...', '...'),
});

search.addWidgets([
    instantsearch.widgets.hits({
      container: '#hits',
    }),
    instantsearch.widgets.searchBox({
      container: '#searchbox'
    }),
    instantsearch.widgets.voiceSearch({
      container: '#voicesearch',
      createVoiceSearchHelper: window.assemblyAIHelper(
        'xxxxxxxxxxxxxxx', // Your AssemblyAI API Token
        {
          word_boost: ['AssemblyAI', 'Google', 'Facebook'], // AssemblyAI word_boost parameter. See: https://docs.assemblyai.com/all-guides/synchronous-transcription-for-short-audio-files#boost
          format_text: true // AssemblyAI format_text parameter. See: https://docs.assemblyai.com/all-guides/synchronous-transcription-for-short-audio-files#format
        }
      ),
      cssClasses: {
        root: ['AssemblyAIHelper'] // Add AssemblyAI stylings or use your own
      },
      templates: {
        status: ({errorCode}) => Boolean(errorCode) ? `<div>${errorCode}</div>` : '' // AssemblyAI error handling
      }
    }),
    // ... other configurations
]);

search.start();

#Supported Platforms Browsers

#Supported Languages

At this time, only English (all accents) is supported.

#Getting an AssemblyAI API Token

AssemblyAI is a Speech-to-Text API that can convert voice into text. You must have an AssemblyAI API Token to use this voice search widget.

1. Register for an AssemblyAI API token here
2. Add a credit card to your AssemblyAI account here
3. Pricing is billed at $0.008 per request to AssemblyAI.

#Feedback and Support

For questions about AssemblyAI, please email support@assemblyai.com. For questions about Algolia, please visit Algolia's support center here.

#Dev

#Build

https://github.com/AssemblyAI/assemblyai-algolia-voice-widget
cd assemblyai-voice-widget
npm install
npm run build

#Development

https://github.com/AssemblyAI/assemblyai-algolia-voice-widget
cd assemblyai-voice-widget
npm install
npm run dev // Server is running with webpack-dev-server (http://localhost:3000)