Setting up the Python client on Windows

  • In order to setup Python 2.7 for Windows, first download it from

  • After installing Python, add to your PATH the location of the Python directory and the Scripts directory within it.

    For example, if Python is installed in C:\Python27, proceed by right-clicking on My Computer on the Start Menu and select “Properties”. Select “Advanced system settings” and then click on the “Environment Variables” button. In the window that comes up, append the following to the system variable PATH (if you chose a different installation location, change this path accordingly):

  • Get the api-client-python code onto your machine by cloning the repository:

    git clone

Running the client with App Engine

Only follow the instructions in this section if you want to run the Python client with App Engine.

  • Download the “Google App Engine SDK for Python” for Windows from and install it.

  • From within the api-client-python directory that you clones, run the script. If we assume the installation directory for your app engine SDK was C:\Google\google_appengine, then you would run the following command:

    python C:\Google\google_appengine\ .

    If you get an error like Unable to bind localhost:8000, try specifying a specific port with this command:

    python C:\Google\google_appengine\ --admin_port=12000 .
  • To view your running server, open your browser to localhost:8080.

Running the client without App Engine

Only follow the instructions in this section if you do not want to use App Engine. See the section above for App Engine instructions.

  • First you will need to download Pip from

  • To install Pip, open up a cmd.exe window by selecting Start->Run->cmd and type the following (replace with the location of where resides):

  • Afterwards in the same command window, type the following command to update your Python environment with the required modules:

    pip install WebOb Paste webapp2 jinja2
  • You should then be able to run the localserver with the following commands:

    cd api-client-python

Enabling the Google API provider

If you want to pull in data from Google Genomics API you will need to set API_KEY in to a valid Google API key.

  • First apply for access to the Genomics API by following the instructions at

  • Then create a project in the Google Cloud Platform Console or select an existing one.

  • On the APIs & auth tab, select APIs and turn the Genomics API to ON

  • On the Credentials tab, click create new key under the Public API access section.

  • Select Server key in the dialog that pops up, and then click Create. (You don’t need to enter anything in the text box)

  • Copy the API key field value that now appears in the Public API access section into the top of the file inside of your api-client-python directory. It should look something like this:

    API_KEY = "abcdef12345abcdef"

    Note: You can also reuse an existing API key if you have one. Just make sure the Genomics API is turned on.

  • Run your server as before, and view your server at localhost:8080.

  • Google should now show up as an option in the Readset choosing dialog.

Have feedback or corrections? All improvements to these docs are welcome! You can click on the “Edit on GitHub” link at the top right corner of this page or file an issue.

Need more help? Please see