{"id":21029399,"url":"https://github.com/voxaai/voxa-cli","last_synced_at":"2025-10-15T18:32:32.601Z","repository":{"id":33947314,"uuid":"96364668","full_name":"VoxaAI/voxa-cli","owner":"VoxaAI","description":"⚒️ The perfect toolkit for your Voxa app.","archived":false,"fork":false,"pushed_at":"2022-12-08T14:34:18.000Z","size":1659,"stargazers_count":6,"open_issues_count":25,"forks_count":13,"subscribers_count":15,"default_branch":"staging","last_synced_at":"2025-04-03T08:38:01.292Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VoxaAI.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-07-05T22:01:36.000Z","updated_at":"2022-01-24T20:46:33.000Z","dependencies_parsed_at":"2023-01-15T03:45:59.773Z","dependency_job_id":null,"html_url":"https://github.com/VoxaAI/voxa-cli","commit_stats":null,"previous_names":["mediarain/voxa-cli"],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoxaAI%2Fvoxa-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoxaAI%2Fvoxa-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoxaAI%2Fvoxa-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoxaAI%2Fvoxa-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VoxaAI","download_url":"https://codeload.github.com/VoxaAI/voxa-cli/tar.gz/refs/heads/staging","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254330721,"owners_count":22053034,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T12:12:13.262Z","updated_at":"2025-10-15T18:32:27.570Z","avatar_url":"https://github.com/VoxaAI.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# voxa-cli\n\n\u003e visit: [https://voxaai.github.io/voxa-cli/](https://voxaai.github.io/voxa-cli/)\n\nThe perfect toolkit for your Voxa app.\n\n[![Build Status](https://travis-ci.org/VoxaAI/voxa-cli.svg?branch=staging)](https://travis-ci.org/VoxaAI/voxa-cli)\n[![Code Coverage](https://codecov.io/gh/voxaai/voxa-cli/branch/staging/graph/badge.svg)](https://codecov.io/gh/VoxaAI/voxa-cli)\n\n## Install it in your Voxa app\n\n```\n$ yarn add voxa-cli\n```\n\n## Getting started\n\nvoxa-cli allows you to create a new voxa project or generate the interaction model needed in your alexa, dialogflow project.\n\n### \\$ voxa create\n\nWith the `Voxa-cli create command` you can scaffold a full Voxa project ready to get started to code your voice app for Amazon Alexa, Google Assistant, Telegram and Facebook Messenger.\n\nYou can also create interaction model and publishing information for your Alexa skills. Voxa-cli supports many sources like google spreadsheet, office 365, local .xlsx, .ods, .fods files to manage your interaction model information and publishing information.\n\n#### How to generate a Voxa project\n\nAs simple as:\n\n```\n$ npx voxa create\n```\n\nYou'll be prompt to answer several question like:\n\n- The name of your project\n- The language of preference for your Voxa app (Javascript or Typescript)\n- The platform for your Voxa app\n- Usage of the canfulfill intent if you'll create an Alexa skill\n- Analytics you can use (using Voxa plugins)\n\nOnce done you'll be ready to start working on your next voice app.\n\n#### Having trouble using `npx voxa create`?\n\nWe noticed that on Windows using `npx voxa create` sometimes results on undesired output. You can use `npx voxa-cli create` as a workaround. We haven't found that issue on MacOS and Linux yet.\n\n### \\$ voxa interaction\n\n#### How to connect with Google Spreadsheet\n\nTo programmatically access your spreadsheet, you’ll need to create a service account and OAuth2 credentials from the Google API Console. If you’ve been burned by OAuth2 before, don’t worry; service accounts are way easier to use.\n\nFollow along with the steps and GIF below. You’ll be in and out of the console in 60 seconds.\n\nGo to the Google APIs Console.\nCreate a new project.\nClick Enable API. Search for and enable the Google Drive API and Google Sheet API.\nCreate credentials for a Web Server to access Application Data.\nName the service account and grant it a Project Role of Editor.\nDownload the JSON file.\nCopy the JSON file to your code directory and rename it to client_secret.json\n\n![alt text](https://www.twilio.com/blog/wp-content/uploads/2017/03/z5P3Wgwb468knWrP27VvpiWAAfZGuOu3gbxUrmi4RYQ2UmZr3wbDM1qTDEasNgsZYAhkDRQryo2vJ3LpvYekSbqntIG_YhO1RiIpVFmGrBwzDwASc8UTnGruTmnZTVZgAkGxPRgQ.png)\n\nThere is one last required step to authorize your app, and it’s easy to miss!\n\nFind the client_email inside client_secret.json. Back in your spreadsheet, click the Share button in the top right, and paste the client email into the People field to give it edit rights. Hit Send.\n\n![alt text](https://www.twilio.com/blog/wp-content/uploads/2017/03/2pzVvPzuNHokBSR2KXoPB9XC15xBF-qBCRJJq0Ut987IkqDVeL3sNdqY2oQj-1V1-2X-SdU33jAuwQ88_XxH703HFpoe7slpVUIniinIqbpz2zD6U2pd77C1iXT0Kzd4qFWb9pI0.png)\n\nFinally copy the client_secret.json in the root of the project. `client_secret.json`\n\n#### How to connect with Office 365 workbooks\n\nWe will need an AAD (Azure Active Directory) and register out application. Create one by using the azure.portal. Your Azure Active Directory ID can be found in Azure Portal \u003e AAD Properties\n\n##### Registering an OAuth App\n\n- Sign in to the Azure portal.\n- If your account gives you access to more than one, select your account in the top right corner, and set your portal session to the desired Azure AD tenant.\n- In the left-hand navigation pane, select the Azure Active Directory service.\n- Select App registrations and then select New application registration.\n- When the Create page appears, enter your application's registration information:\n  - Name: Enter a meaningful application name\n  - Application type:\n    - Select Web app/API for client applications and resource/API applications that are installed on a secure server.\n  - Sign-On URL: For this application enter any sign on URL\n- From the Main Panel grab the application ID (client_id)\n\n\u003e More info https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-v1-add-azure-ad-app\n\n- Create a new Client Secret: Navigate to App \u003e Keys \u003e Passwords and add a new key.\n  - Name (description): enter a descriptive name for the key so you later know that the client application is using it.\n  - Expires: Choose \"Never Expire,\" unless you want to change your key every year or two.\n  - Click Save - a new Client Secret will be generated for you. This will be the only time you will see the Client Secret, so you better copy it to a secured location otherwise you won't be able to retrieve it again!\n\n##### Configuring App Permission\n\nNow that we have created an app, we have to configure its permissions.\n\n- Setup app permission: Navigate to App \u003e Required Permission \u003e Add \u003e Select an API \u003e \"Microsoft Graph\" \u003e Select Permission. We see a list of Graph related permissions. Here we can select the permission our app should have.\n- Select the following permissions `Read files in all site collections`, `Read directory data`\n- Click the button `Grant Permissions`.\n- Each time we change permissions we need to give `Admin consent`. With an Admin user go to\n\n```\nhttps://login.microsoftonline.com/{TenantDirectory}.onmicrosoft.com/adminconsent?client_id={ApplicationID}\n```\n\nFinally create a file and name it `azure.secret.json` in the root folder of your project with the following values.\n\n```json\n{\n  \"client_id\": \"XXXXXX\",\n  \"client_secret\": \"YYYYYYY\",\n  \"tenant_directory\": \"ZZZZZZZZ\" // could be tenant directory name or id\n}\n```\n\n#### Interaction.json\n\nOnce you have the OAuth2 you should create the interaction.json.\nCreate a new file on your skill root project `./interaction.json` and paste the following snippet. Replace all the values you need.\n\nBasic structure\n\n```json\n{\n  \"platforms\": [\"alexa\", \"dialogFlow\"],\n  \"spreadsheets\": [\n    \"GOOGLE_SPREADSHEET_URL\",\n    \"OFFICE365_WORKBOOK_URL\",\n    \"LOCAL_EXCEL_FILE_PATH\",\n    \"LOCAL_EXCEL_FOLDER\"\n  ],\n  \"contentPath\": \"src/content\",\n  \"viewsPath\": \"src/languageResources\"\n}\n```\n\nLocal excel file\n\n```json\n{\n  \"platforms\": [\"dialogflow\", \"alexa\"],\n  \"spreadsheets\": [\"./vui/basic-interaction-model.xlsx\"],\n  \"viewsPath\": \"./views/\",\n  \"speechPath\": \"./speech-assets\",\n  \"contentPath\": \"./content\"\n}\n```\n\nGoogle file\n\n```json\n{\n  \"platforms\": [\"dialogflow\", \"alexa\"],\n  \"spreadsheets\": [\n    \"https://docs.google.com/spreadsheets/d/1Jh04EJInZWIbMiRKGyxBO2JC54PlLof6Sxpcc_YkxsA/edit\"\n  ],\n  \"viewsPath\": \"./views/\",\n  \"speechPath\": \"./speech-assets\",\n  \"contentPath\": \"./content\"\n}\n```\n\nFinally execute it and voilà :flushed:\n\n```\n$ npx voxa interaction\n```\n\n### Options\n\n- **spreadsheets**: Array of spreadsheets. Each sheet should be a interaction model for a specific locale. Spreadsheet can also be about publishing information. Make sure to review [Interaction spreadsheet structure](https://voxaai.github.io/voxa-cli/docs/interaction-spreadsheet) and [Publishing spreadsheet structure](https://voxaai.github.io/voxa-cli/docs/publishing-spreadsheet)\n- **platform**: We currently support Alexa and Dialog Flow interaction models. Make sure to review [platform structure](https://voxaai.github.io/voxa-cli/docs/platform)\n\n### spreadsheet samples\n\n- [rock-paper-lizard-interaction-model](https://drive.google.com/open?id=1VNfAn8H0PvSqcouJPrPsXx1kgPfYYAha)\n- [quiz-interaction-model](https://drive.google.com/open?id=1HiG3VPzMwOyJEPi87QtnJjcIujy6p5za)\n- [podcast-interaction-model](https://drive.google.com/open?id=16VvK_P0avgVUjtqbd9X9Yvae6WitgLOm)\n- [advance-interaction](https://drive.google.com/open?id=1JlS2LgOKurinzUN8YsZ6QOpr3JxZlr63)\n- [advance-publishing-infromation](https://drive.google.com/open?id=1JRIlmPIwFlaEgaqUfXqGb2BdRY4QXnw-)\n- [basic-interaction](https://drive.google.com/open?id=1_Aq1h0CMpScmTLeelhw1pCCXnlDvmP2R)\n- [basic-publishing-information](https://drive.google.com/open?id=1sptXVbpC4JoG46LVj7bEmTSus87YIObc)\n\n### Other links\n\n- [Interaction spreadsheet structure](https://voxaai.github.io/voxa-cli/docs/interaction-spreadsheet)\n- [Publishing spreadsheet structure](https://voxaai.github.io/voxa-cli/docs/publishing-spreadsheet)\n- [Content structure](https://voxaai.github.io/voxa-cli/docs/interaction-spreadsheet#tabs-to-download-should-have-the-following-structure)\n- [Local manifest](https://voxaai.github.io/voxa-cli/docs/local-manifest)\n- [Platform](https://voxaai.github.io/voxa-cli/docs/platform)\n\n\u003e visit: [https://voxaai.github.io/voxa-cli/](https://voxaai.github.io/voxa-cli/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxaai%2Fvoxa-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoxaai%2Fvoxa-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxaai%2Fvoxa-cli/lists"}