The [Speech to Text][service_url] service uses IBM's speech recognition capabilities to convert speech in multiple languages into text. The transcription of incoming audio is continuously sent back to the client with minimal delay, and it is corrected as more speech is heard. The service is accessed via a WebSocket interface; a REST HTTP interface is also available;

[](https://bluemix.net/deploy?repository=https://github.com/watson-developer-cloud/speech-to-text-nodejs)

1. You need a Bluemix account. If you don't have one, [sign up][sign_up].

2. Download and install the [Cloud-foundry CLI][cloud_foundry] tool if you haven't already.

3. Edit the `manifest.yml` file and change `<application-name>` to something unique. The name you use determines the URL of your application. For example, `<application-name>.mybluemix.net`.

```yaml

applications:

- services:

- my-service-instance

name: <application-name>

command: npm start

path: .

memory: 512M

```

cf api https://api.ng.bluemix.net

cf login

```

5. Create and retrieve service keys to access the [Speech to Text][service_url] service:

```none

```

```none

```

You will update the `.env` with the information you retrieved in steps 5.

The `.env` file will look something like the following:

```none

```

7. Install the dependencies you application need:

```none

```

```none

```

9. Point your browser to [http://localhost:3000](http://localhost:3000).

```none

```

After completing the steps above, you are ready to test your application. Start a browser and enter the URL of your application.

<your application name>.mybluemix.net

For more details about developing applications that use Watson Developer Cloud services in Bluemix, see [Getting started with Watson Developer Cloud and Bluemix][getting_started].

* The main source of troubleshooting and recovery information is the Bluemix log. To view the log, run the following command:

```sh

cf logs <application-name> --recent

```

* For more details about the service, see the [documentation][docs] for the Speech to Text service.

See [CONTRIBUTING](CONTRIBUTING.md).

Sample web applications that include this package may be configured to track deployments to [IBM Bluemix](https://www.bluemix.net/) and other Cloud Foundry platforms. The following information is sent to a [Deployment Tracker](https://github.com/IBM-Bluemix/cf-deployment-tracker-service) service on each deployment:

* Node.js package version

* Node.js repository URL

* Application Name (`application_name`)

* Space ID (`space_id`)

* Application Version (`application_version`)

* Application URIs (`application_uris`)

* Labels of bound services

* Number of instances for each bound service and associated plan information

This data is collected from the `package.json` file in the sample application and the `VCAP_APPLICATION` and `VCAP_SERVICES` environment variables in IBM Bluemix and other Cloud Foundry platforms. This data is used by IBM to track metrics around deployments of sample applications to IBM Bluemix to measure the usefulness of our examples, so that we can continuously improve the content we offer to you. Only deployments of sample applications that include code to ping the Deployment Tracker service will be tracked.

[deploy_track_url]: https://github.com/cloudant-labs/deployment-tracker

[cloud_foundry]: https://github.com/cloudfoundry/cli

[getting_started]: https://www.ibm.com/watson/developercloud/doc/common/index.html

[docs]: http://www.ibm.com/watson/developercloud/speech-to-text/

[sign_up]: https://console.bluemix.net/registration/

iam_url: process.env.SPEECH_TO_TEXT_IAM_URL || 'https://iam.bluemix.net/identity/token',

url: process.env.SPEECH_TO_TEXT_URL || '<url>',