The IBM Watson Concept Insights service links documents that you provide with a pre-existing graph of concepts based on Wikipedia (e.g. 'Solar Energy', 'Cognitive Systems', etc.). Two types of links are identified: explicit links when a document directly mentions a concept, and implicit links which connect your documents to relevant concepts that are not directly mentioned in them. Users of this service can also search for documents that are relevant to a concept or collection of concepts by exploring the explicit and implicit links.

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

1. Create a Bluemix Account

Sign up in Bluemix, or use an existing account. Watson Services in Beta are free to use.

2. Download and install the Cloud-foundry CLI tool

3. Edit the manifest.yml file and change the <application-name> to something unique.

applications:
- services:
  - concept-insights-service
  name: <application-name>
  path: .
  memory: 256M

The name you use will determinate your application url initially, e.g. <application-name>.mybluemix.net.

4. Connect to Bluemix in the command line tool

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

5. Create the Concept Insights service in Bluemix

$ cf create-service concept_insights free concept-insights-service

6. Push it live!

$ cf push

See the full Getting Started documentation for more details, including code snippets and references.

The application uses [Node.js][http://nodejs.org/] and [npm][https://www.npmjs.com/] so you will have to download and install them as part of the steps below.

1. Copy the credentials from your concept-insights-service service in Bluemix to app.js, you can see the credentials using:

   $ cf env <application-name>

   Example output:

   System-Provided:
   {
   "VCAP_SERVICES": {
     "concept_insights": [{
         "credentials": {
           "url": "<url>",
           "password": "<password>",
           "username": "<username>"
         },
       "label": "concept_insights",
       "name": "concept-insights-service",
       "plan": "free"
    }]
   }
   }

   You need to copy username, password and url.

2. Install Node.js

3. Go to the project folder in a terminal and run: npm install

4. Start the application

5. node app.js

6. Go to http://localhost:3000

To troubleshoot your Bluemix app the main useful source of information are the logs, to see them, run:

$ cf logs <application-name> --recent

This sample code is licensed under Apache 2.0. Full license text is available in COPYING.

See CONTRIBUTING.

Find more open source projects on the IBM Github Page