Natural Language Classifier Demo

The IBM Watson™ Natural Language Classifier service applies deep learning techniques to make predictions about the best predefined classes for short sentences or phrases. The classes can trigger a corresponding action in an application, such as directing a request to a location or person, or answering a question. After training, the service returns information for texts that it hasn't seen before. The response includes the name of the top classes and confidence values.

Give it a try! Click the button below to fork into IBM DevOps Services and deploy your own copy of this application on Bluemix.

Getting started

You need a Bluemix account. If you don't have one, sign up. Experimental Watson Services are free to use.
Download and install the Cloud-foundry CLI tool if you haven't already.
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.
```
applications:
- services:
  - natural-language-classifier-standard
  name: <application-name>
  command: node app.js
  path: .
  memory: 128M
```

Connect to Bluemix with the command line tool.

$ cf api https://api.ng.bluemix.net
$ cf login -u <your user ID>

Create the Natural Language Classifier service in Bluemix.

$ cf create-service natural_language_classifier standard natural-language-classifier-standard

Push your app to make it live:
```
$ cf push
```
Create and train the NLC service using the weather training data. Take note of the <classifier-id>.
To configure the app.js file to use your classifier, export the classifier ID as an environment variable.
```
$ cf set-env <application-name> CLASSIFIER_ID <classifier-id>
```
Finally, restage the application to ensure the environment variable is set.
```
$ cf restage <application-name>
```
For more details about developing applications that use Watson Developer Cloud services in Bluemix, see Getting started with Watson Developer Cloud and Bluemix.

Running locally

Download and install Node.js and npm.
Create an instance of the Natural Language Classifier service on Bluemix.
Create and train the NLC service using, for example, the weather training data. Note the value of the Classifier ID in the response.

Configure the code to connect to your service:

Copy the credentials from your natural-language-classifier-standard service in Bluemix. Run the following command:

$ cf env <application-name>

Example output:

System-Provided:
{
  "VCAP_SERVICES": {
	"natural_language_classifier": [
	  {
		"credentials": {
		  "password": "<password>",
		  "url": "<url>",
		  "username": "<username>"
		}
		"label": "natural-language-classifier",
		"name": "natural-language-classifier-standard",
		"plan": "standard",
		"tags": [
		  ...
		]
	  }
	]
  }
}

Copy username, password, and url from the credentials.
Open the app.js file and paste the username, password, and url credentials for the service.
In the app.js file paste the "Classifier ID". Save the app.js file.

Install the Natural Language Classifier Node.js package:
1. Change to the new directory that contains the project.
2. Run the following command:node
```
$ npm install
```
Run the following command to start the application:
```
npm start
```
Point your browser to http://localhost:3000.
Train the classifier, if you haven't already. See the step earlier under Getting started.

Troubleshooting

The main source of troubleshooting and recovery information is the Bluemix log. To view the log, run the following command:
```
$ cf logs <application-name> --recent
```
For more details about the service, see the documentation for the Natural Language Classifier.

License

This sample code is licensed under Apache 2.0. Full license text is available in LICENSE.
This sample uses jquery which is MIT license

Contributing

See CONTRIBUTING.

Open Source @ IBM

Find more open source projects on the IBM Github Page

Privacy Notice

This node sample web application includes code to track deployments to Bluemix and other Cloud Foundry platforms. The following information is sent to a Deployment Tracker service on each deployment:

Application Name (application_name)
Space ID (space_id)
Application Version (application_version)
Application URIs (application_uris)

This data is collected from the VCAP_APPLICATION environment variable 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. Only deployments of sample applications that include code to ping the Deployment Tracker service will be tracked.

Disabling Deployment Tracking

Deployment tracking can be disabled by removing require('cf-deployment-tracker-client').track(); from the beginning of the server.js file at the root of this repo.

Charlesma/natural-language-classifier-nodejs