MURAL Search

A Python Flask app for searching MURAL using IBM Watson Discovery.

This app is part of a larger sample. Read the blog: Searching MURAL

See also: Demo video

 

How to run the sample app on your local computer

1. Download sample code

1. Create a local working directory
2. In your browser, navigate to the MURAL-search GitHub repo
3. Click the button labeled Code and then select "Download ZIP" to download the sample code
4. Uncompress the sample code into your working directory

2. Set up local environment

1. On a command line, in the working directory, create a new local, virtual Python environment:
   python -m venv <virtual-environment-name>

2. Use the virtual environment:
   Windows
   <virtual-environment-name>\Scripts\activate.bat
   UNIX or MacOS
   source <virtual-environment-name>/bin/activate

3. In the src subdirectory of the sample code, install Python libraries required for the sample app:
   pip install -r requirements.txt

4. Set three environment variables:

   DISCOVERY_APIKEY	You can get this from the Manage page of your IBM Watson Discovery intance in IBM Cloud
   DISCOVERY_URL	You can get this from the Manage page of your Discovery intance in IBM Cloud
   DISCOVERY_PROJECT_ID	You can get this from the sample notebook used to create the project or from the Discovery web interface

3. Run the app locally

1. Run the app from the src subdirectory:
   python server.py

2. Open a new browser tab with this address: http://localhost:8080