boazdavid / san-francisco-life

Dev Week 2015 Hack - Hedge

San Francisco Life

San Francisco Life previously hedge is a web application that uses the IBM Watson Tradeoff Analytics service helps you make better choices on where to live in San Francisco.

This repository is a fork of https://github.com/MasonIII/sfLife all credits goes to Ryan Ma. 👯

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

1. Create a Bluemix Account

   Sign up in Bluemix or use an existing account.

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:
  - tradeoff-analytics-service
  name: <application-name>
  memory: 512M

The name you use determines your initial application URL, 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 Tradeoff Analytics service in Bluemix.

$ cf create-service tradeoff_analytics standard tradeoff-analytics-service

6. Push it live!

$ cf push

Running locally

The application uses Python and pip so you will have to download and install them as part of the steps below.

1. Copy the credentials from your tradeoff-analytics-service service in Bluemix to sfLife/views.py, you can see the credentials using:

$ cf env <application-name>

Example output:

System-Provided:
{
"VCAP_SERVICES": {
  "text_to_speech": [{
      "credentials": {
        "url": "<url>",
        "password": "<password>",
        "username": "<username>"
      },
    "label": "text_to_speech",
    "name": "text-to-speech-service-standard",
    "plan": "standard"
 }]
}
}

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

2. Install Python 2.7.9 or later

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

pip install -r requirements.txt

4. Start the application

python server.py

5. 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 MIT. Full license text is available in LICENSE.
This sample code uses jQuery which license is MIT.

Contributing

See CONTRIBUTING.

Open Source @ IBM

Find more open source projects on the IBM Github Page.