Home

Awesome

Jovo CLI

To view this page on the Jovo website, visit https://v3.jovo.tech/marketplace/jovo-cli

The Jovo Command Line Tools offer the ability to create, prototype, test, and deploy your voice app quickly. Learn more about all the commands here.

Introduction

This is the CLI for Jovo v3, which you can now access using jovo3. Learn more here: https://www.jovo.tech/docs/migration-from-v3#use-v4-and-v3-in-parallel

The Jovo CLI (GitHub Repository: jovotech/jovo-cli) is the center of voice app development with the Jovo Framework. With it, you can quickly create new Jovo projects, create language models and deploy them to the voice platforms, and run your voice apps locally for easy prototyping and testing.

Installation

To make best use of the Jovo CLI, install it globally via npm:

$ npm install -g jovo-cli

After successful installation, you should be able to see the menu by just typing the following into your command line:

$ jovo3

You can check the version number (and compare it to the jovo-cli npm package version) with this command:

$ jovo3 -V

Troubleshooting

Find out more about technical requirements in our Installation Guide.

If you had the CLI installed with an outdated major version and are running into problems after updating it to the latest one, please try to uninstall it globally before you install it again:

$ npm uninstall -g jovo-cli

If you run into other problems, please submit an issue here: jovotech/jovo-cli. Thank you!

Command Types

Jovo CLI commands can be divided into basic commands (to create and run projects) and platform commands (to interact with a voice platform).

CommandDescription
Basic Commandsjovo3 newCreates a new Jovo project
jovo3 runRuns a local development server (webhook)
jovo3 updateUpdate all of the Jovo packages in your project
Platform Commandsjovo3 buildBuilds platform-specific language model files into /platforms based on /models folder
jovo3 getDownloads an existing platform project into the /platforms folder
jovo3 deployDeploys the /platforms project files to the voice platforms

Basic Commands

These are the basic commands that help you develop Jovo voice apps faster, without interacting with the voice platforms (see platform commands for features that are language model specific).

jovo new

jovo new command

You can create a Jovo project into a new directory with the following command:

## Default
$ jovo3 new <directory>

Learn more about this command here: cli/new.

jovo run

jovo run command

You can use the jovo run command to start the development server in your index.js file, and then add the Jovo Webhook as an endpoint to the respective developer consoles.

Learn more here: Docs: Configuration > Hosting.

# Default
$ jovo3 run

Learn more about this command here: cli/run.

jovo update

To update to the latest minor version (updating either x or y in 2.x.y) of the framework, you can use the following command:

# Update all Jovo packages
$ jovo3 update

This is are necessary (as opposed to $ npm install jovo-framework) because the framework is now split into different modules.

Learn more about upgrading Jovo here.

Platform Commands

Platform commands are used to interact with the voice platforms (Amazon Alexa or Google Assistant/Dialogflow). You don't have to use these commands if you just want to maintain the language/interaction models on the respective developer platforms.

See the following tutorials for alternative ways to create language models on the respective developer platforms:

jovo build

jovo build command

jovo build is the command to create and update the platform specific interaction models using the Jovo model. Using the files in the /models folder and converting them into files in the /platforms folder.

To learn more about Jovo Language Models, take a look at App Configuration > Models.

You can either run build separately for each platform, or just let the CLI fetch the right information from the project.js file.

# Default
$ jovo3 build

Learn more about this command here: cli/build.

jovo get

jovo get command

jovo get will import an existing Alexa Skill (Skill Information and Interaction Model) or Dialogflow agent (work in progress) into the /platforms folder.

To get the Skill from the Amazon developer console, you have to set up ASK CLI first.

# Choose from list of Skills
$ jovo3 get <alexaSkill|googleAction>

Learn more about this command here: cli/get.

jovo deploy

jovo deploy command

jovo deploy is used to upload the platform folders to their respective developer consoles.

# Default
$ jovo3 deploy

Learn more about this command here: cli/deploy.