voice tech

Configuring and Testing Voice UIs on Command Line

Ottomatias Peura

Sep 18, 2020

3 min read

We have released a set of command line tools that improve collaboration and makes it easy for developers to integrate Speechly to their current workflow

  • Copy link

  • Mail

  • LinkedIn

  • Facebook

  • Twitter

Speechly offers fast and intuitive development tools for voice user interfaces on the platform most familiar to all developers – command line. You can find the GitHub repository for the tools here

This tutorial shows you how you can prototype and develop voice user interfaces in the command line.

Benefits of command line interface include:

  • Easy integration to any workflow including your favorite code editor tools
  • Easy collaboration with version control tools like Git
  • Actions easy to replicate on any machine
  • Fast user interface

In this tutorial, I’ll show you how you can create and test your first Speechly application on the command line.

1 Download speechly command line tool for your platform

Homebrew (for Mac OS)

If you are using Mac OS, use Homebrew to install speechly with:

$ brew tap speechly/tap
# to get the latest release
$ brew install speechly

After tapping, normal brew updates will include any new versions of speechly.

Scoop (for Windows)

Scoop is a package manager for Windows. speechly can be installed with scoop with:

$scoop bucket add speechly
# to install the latest release
$scoop install speechly

You can update the tool with:

$scoop update

2 Sign up and get your API token

To authenticate against the Speechly API, you’ll need an API token. You can get your API token from the Speechly Dashboard

Sign up (or login, if you are already a Speechly user) and go to Project settings on the top right navigation. Click Create API token and give it a name.

NOTE: After you navigate away from this page, you can’t see the token anymore for security reasons. If you lose your token, you’ll need to create a new one.

3 Create a directory for our application

Now that we have the required tools installed, let’s create an empty directory for our application. This directory will contain the required configuration files.


$ mkdir my-first-speechly-app && cd my-first-speechly-app


$ md my-first-speechly-app
$ cd my-first-speechly-app

4 Authenticate to your project

$ speechly config add --name new --apikey <YOUR_API_TOKEN>

Using this command will create a new application called “new” and authenticates by using your API token that we created in the second step of this tutorial.

5 Create an application inside your project

Our current project doesn’t have any applications, so let’s create the first one. We need to specify the application name with the flag -n and the language with the flag -l. Let’s use en-US as the language.

$ speechly create -n home-automation -l en-US

The command replies with the app ID of your newly created application. Copy this string to the clipboard.

NOTE: You can use $ speechly list to list your applications and to get your app ID.

Listing applications on command line interface

6 Download a working configuration YAML file

Because actually configuring a Speechly application is outside the scope of this tutorial, we’ll be using a ready-made home automation template. Let’s download the file.

NOTE: if you are interested in reading more about configuring your application, refer to the Speechly documentation

$ curl -o home-automation-curl.yaml

7 Use the configuration file to configure your application

As you can see with the $ speechy list command, our application status is currently STATUS_UNSPECIFIED as it doesn’t have valid configuration. Let’s fix that by using the configuration file.

$ speechly deploy . -a <YOUR APP ID>

This command uses the YAML file in your current directory. This should be the YAML file we just downloaded.

We can check the current status of the application by using describe. If you use the -w flag, you will get real-time information about the status of the deployment.

$ speechly describe -w <YOUR APP ID

After waiting for about 83 seconds, the application has been deployed. Yay! You have configured your first Speechly application by using the command line!

You can verify this by using speechly list and your application should now have a status STATUS_TRAINED

8 Test your application

Now you can test the application by using the Speechly Playground! You can sign in to the Dashboard and see your application in the list.

Listing applications on web interface

Try saying something like “Turn off the living room lights” or “Turn on the TV in kitchen”.

For more information on using the Dashboard, see our Quick Start

Latest blog posts

case study

Combating Voice Chat Toxicity in VR Games: Speechly and Gym Class

Gym Class VR is a basketball game that was preparing to launch on Meta Quest after a very successful Beta. Voice chat is an important social element of the game, but the team noticed evidence of toxic behavior emerging. After trying speech recognition from cloud service providers, they quickly learned this was a cost-prohibitive approach and turned to Speechly.

Collin Borns

Mar 20, 2023

5 min read

voice tech

The Dirty Dozen - The Impact of 12 Types of Toxic Behavior in Online Game Voice Chat

Speechly surveyed over 1000 online gamers about toxic behavior in voice and text chat. The results show offensive names, trolling, bullying and annoying behavior top the list with the broadest impact. However, these behaviors are between 50%-200% more frequent in voice chat.

Collin Borns

Mar 09, 2023

3 min read

voice tech

Voice Chat is Popular with Gamers - It's also the Top Source of Toxic Behavior - New Report

Speechly commissioned a survey of a nationally representative sample of over 1000 gamers. The survey found that nearly 70% of gamers have used voice chat at least once. Of those, 72% said they've experienced a toxic incident. Read more today in the Full Report.

Otto Söderlund

Mar 08, 2023

3 min read