Personality Insights Nodejs Starter Application

The IBM Watson [Personality Insights][service_url] service uses linguistic analysis to extract cognitive and social characteristics from input text such as email, text messages, tweets, forum posts, and more. By deriving cognitive and social preferences, the service helps users to understand, connect to, and communicate with other people on a more personalized level.

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:
  - my-service-instance
  name: <application-name>
  command: npm start
  path: .
  memory: 512M

Connect to Bluemix with the command line tool.

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

Create and retrieve service keys to access the [Personality Insights][service_url] service:

cf create-service personality_insights lite my-pi-service
cf create-service-key my-pi-service myKey
cf service-key my-pi-service myKey

Create a .env file in the root directory by copying the sample .env.example file using the following command:

cp .env.example .env

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

The .env file will look something like the following:

PERSONALITY_INSIGHTS_USERNAME=<username>
PERSONALITY_INSIGHTS_PASSWORD=<password>

Install the dependencies you application need:

npm install

Start the application locally:

npm start

Point your browser to http://localhost:3000.
Optional: Push the application to Bluemix:

cf push

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.

Setting Up the Twitter Application

Create a Twitter application.
Add your application's callback URL:

For Bluemix environment: <application-name>.mybluemix.net/auth/twitter/callback
For Local environment: http://localhost:3000/auth/twitter/callback

Update the .env file and add your twitter application credentials:

TWITTER_CONSUMER_KEY=<consumer-key>
TWITTER_CONSUMER_SECRET=<consumer-secret>

Restart the app locally or push it again to Bluemix.

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 Personality Insights.

Directory structure

.
├── app.js                       // express entry point
├── config                       // express configuration
│   ├── error-handler.js
│   ├── express.js
│   ├── i18n.js
│   ├── passport.js
│   └── security.js
├── helpers                      // utility modules
│   ├── personality-insights.js
│   └── twitter-helper.js
├── i18n                         // internationalization
│   ├── en.json
│   ├── es.json
│   └── ja.json
├── manifest.yml
├── package.json
├── public
│   ├── css
│   ├── data                     // sample text and tweets
│   ├── fonts
│   ├── images
│   └── js
├── router.js                   // express routes
├── server.js                   // application entry point
├── test
└── views                       // ejs views

License

This sample code is licensed under Apache 2.0.

Contributing

See CONTRIBUTING.

Open Source @ IBM

Find more open source projects on the IBM Github Page

Privacy Notice

Sample web applications that include this package may be configured to track deployments to IBM Bluemix and other Cloud Foundry platforms. The following information is sent to a Deployment Tracker 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.

aprilwebster / personality-insights-nodejs