An open API service indexing awesome lists of open source software.

https://github.com/devoxx/watsonsherlockdemo

The nodeJS DeVoxxEd Watson project demo
https://github.com/devoxx/watsonsherlockdemo

Last synced: 4 months ago
JSON representation

The nodeJS DeVoxxEd Watson project demo

Awesome Lists containing this project

README

          

# Concept Insights Nodejs

The IBM Watson [Concept Insights][service_url] 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.

[![Deploy to Bluemix](https://bluemix.net/deploy/button.png)](https://bluemix.net/deploy?repository=https://github.com/watson-developer-cloud/concept-insights-nodejs)

## Getting Started

1. Create a Bluemix Account

[Sign up][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][cloud_foundry] tool

3. Edit the `manifest.yml` file and change the `` to something unique.
```none
applications:
- name:
path: .
memory: 256M
```
The name you use will determinate your application url initially, e.g. `.mybluemix.net`.

4. Connect to Bluemix in the command line tool
```sh
$ cf api https://api.ng.bluemix.net
$ cf login -u
```

5. Create the following five Watson services in Bluemix

```sh
$ cf create-service concept_insights standard concept-insights-standard
$ cf create-service speech_to_text standard speech-to-text-std
$ cf create-service language_translation standard language-translation-std
$ cf create-service alchemy_api free alchemy-api-free
$ cf create-service watson_vision_combined free watson-vision-free
```

6. Push it live!
```sh
$ cf push
```

## Running locally
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-standard` service in Bluemix to `app.js`, you can see the credentials using:

```sh
$ cf env
```
Example output:
```sh
System-Provided:
{
"VCAP_SERVICES": {
"concept_insights": [{
"credentials": {
"url": "",
"password": "",
"username": ""
},
"label": "concept_insights",
"name": "concept-insights-standard",
"plan": "standard"
}]
}
}
```

You need to copy `username`, `password` and `url`.

2. Install [Node.js](http://nodejs.org/)
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`

## Troubleshooting

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

```sh
$ cf logs --recent
```

## License

This sample code is licensed under Apache 2.0. Full license text is available in [COPYING](LICENSE).

## Contributing

See [CONTRIBUTING](CONTRIBUTING.md).

## Open Source @ IBM
Find more open source projects on the [IBM Github Page](http://ibm.github.io/)

[service_url]: http://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/concept-insights.html
[cloud_foundry]: https://github.com/cloudfoundry/cli
[sign_up]: https://apps.admin.ibmcloud.com/manage/trial/bluemix.html?cm_mmc=WatsonDeveloperCloud-_-LandingSiteGetStarted-_-x-_-CreateAnAccountOnBluemixCLI