Alchemy Language Node.js Sample Application
HTML CSS JavaScript
Latest commit 7b4837f Jan 20, 2017 @germanattanasio germanattanasio new cta button
Failed to load latest commit information.
.github initial commit May 20, 2016
config Start free in Bluemix button Dec 20, 2016
gulp move to es6 Dec 14, 2016
public Update service icon Jul 5, 2016
src new cta button Jan 20, 2017
test move to es6 Dec 14, 2016
views new cta button Jan 20, 2017
.cfignore move to es6 Dec 14, 2016
.env.example move to es6 Dec 14, 2016
.eslintignore initial commit May 20, 2016
.eslintrc.yml move to es6 Dec 14, 2016
.gitignore 🔥 remove jshint files Jun 23, 2016
.travis.yml Update .travis.yml Dec 14, 2016
GulpFile.js initial commit May 20, 2016
LICENSE initial commit May 20, 2016 move to es6 Dec 14, 2016
app.js update comment app.js Aug 19, 2016
manifest.yml switching to free plan Sep 23, 2016
package.json Start free in Bluemix button Dec 20, 2016
server.js move to es6 Dec 14, 2016

AlchemyLanguage Demo

AlchemyLanguage is a collection of APIs that offer text analysis through natural language processing. The AlchemyLanguage APIs can analyze text and help you to understand its sentiment, keywords, entities, high-level concepts and more.

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

Note: The automatic Deploy to Bluemix process may fail if you already have a free AlchemyAPI instance on your account. In that case, please follow the manual steps below.

Getting started

  1. You need a Bluemix account. If you don't have one, sign up. Experimental Watson Services are free to use.

  2. Download and install the Cloud-foundry CLI 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>

    - services:
      - alchemy-service
      name: <application-name>
      command: npm start
      path: .
      memory: 512M
  4. Connect to Bluemix with the command line tool.

    cf api
    cf login
  5. Create and retrieve service keys to access the AlchemyLanguage service:

    cf create-service alchemy_api standard alchemy-service
    cf create-service-key alchemy-service myKey
    cf service-key alchemy-service myKey

    Note: on Bluemix Trial accounts, you'll need to use the free plan instead:

    cf create-service alchemy_api free alchemy-service

    Bluemix accounts are limited to a single free alchemy_api service instance; if you already have one, then edit your use that api_key in the next step.

  6. 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:

  7. Install the dependencies you application need:

    npm install
  8. Start the application locally:

    npm start
  9. Point your browser to http://localhost:3000.

  10. 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>

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


  • 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][nlc_docs] for the AlchemyLanguage.


This sample code is licensed under Apache 2.0.



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.