Visual Recognition + AlchemyVision Demo

Visual Recognition partnered with Alchemy Vision, allows you to derive insights from an image based on its visual content. You can organize image libraries, understand an individual image, and create custom classifiers for specific results that are tailored to your needs.

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

Create a Bluemix Account

Download and install the Cloud-foundry CLI tool
Edit the manifest.yml file and change the <application-name> to something unique.

applications:
- services:
- visual-recognition-service
name: <application-name>
command: node app.js
path: .
memory: 512M

The name you use will determine your initial application URL, e.g. <application-name>.mybluemix.net.

Connect to Bluemix in the command line tool

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

Create the Visual Recognition service in Bluemix

$ cf create-service visual_recognition free visual-recognition-service

Create the Alchemy service in Bluemix or copy your existing key into ALCHEMY_KEY in app.js

$ cf create-service alchemy_api free alchemy-service

Push it live!

$ cf push

Optional Security and Performance enhancements

Set NODE_ENV=production to enable view caching and other performance enhancements:

$ cf set-env <application-name> NODE_ENV production

Set SECURE_EXPRESS=1 to enable rate-limiting, HTTPS-only, and several other security features:

$ cf set-env <application-name> SECURE_EXPRESS 1

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

Running locally

The application uses Node.js and npm so you will have to download and install them as part of the steps below.

Copy the credentials from your visual-recognition-service service in Bluemix to app.js, you can see the credentials using:

$ cf env <application-name>

Example output:

System-Provided:
{
"VCAP_SERVICES": {
  "visual_recognition": [{
      "credentials": {
        "url": "<url>",
        "password": "<password>",
        "username": "<username>"
      },
    "label": "visual_recognition",
    "name": "visual-recognition-service",
    "plan": "free"
 }]
}
}

You need to copy username, password and url.

Install Node.js
Go to the project folder in a terminal and run: npm install
Start the application
node app.js
Go to http://localhost:3000

Troubleshooting

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

$ cf logs <application-name> --recent

License

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

Contributing

See CONTRIBUTING.

Open Source @ IBM

Find more open source projects on the IBM Github Page