Command Line Configuration Tool

Use the Speechly Command Line tool to integrate Speechly to your development workflow for easier and more productive collaboration.

Once you’ve created your first application on the Speechly Dashboard and start inviting more developers to collaborate with your configuration, you might find yourself missing Git and other familiar collaboration tools.

The solution is to start using our command line configuration tool that enables developers to integrate Speechly to their current workflow.

Installing the tool

There are binary releases for macOS, Linux and Windows, see releases.

Homebrew (for macOS)

If you are using macOS, the easiest way to install is by using Homebrew.

  • brew tap speechly/tap
  • brew install speechly to get the latest release

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

Scoop (for Windows)

speechly can be installed for Windows with Scoop by using:

  • scoop bucket add speechly
  • scoop install speechly to install the latest release

You can update the tool by using scoop update.


You need an API token to access the API

You can find instructions for getting the token here

speechly config add --name default --apikey <API Token> [--host]

The latest context added will be used as the current context.


Supported commands

  • config manage the Speechly API access configurations
  • create create a new application in the current context (project)
  • delete delete an existing application
  • deploy deploy to upload a directory containing SAL configuration file(s), train a model out of them and take the model into use.
  • describe describe apps to get their status
  • list list apps in project
  • sample sample a set of examples from the given SAL configuration
  • validate validate the given SAL configuration for syntax errors

The versioning of the SAL configuration files should be done properly, i.e., keep them in a version control system. Consider the deploy/download functionality to be a tool for the training pipeline instead of collaboration or versioning.

Suggested workflow

  1. Create a directory for your application’s configuration
  2. Save files in git or other versioning tool
  3. Use speechly deploy in your CI for deploying the configuration

More information

Read our tutorial for downloading and using the Command Line Tool

Profile image for samutamm

Last updated by samutamm on February 10, 2021 at 15:31 +0200

Found an error on our documentation? Please file an issue or make a pull request