/pydatalab

Google Datalab Library

Primary LanguagePythonApache License 2.0Apache-2.0

datalab Build Status PyPI Package

Google Cloud Datalab Python package. Used in Google Cloud Datalab and can be used in Jupyter Notebook.

This adds a number of Python modules such as google.datalab.bigquery, google.datalab.storage, etc, for accessing Google Cloud Platform services as well as adding some new cell magics such as %chart, %bigquery, %storage, etc.

See https://github.com/googledatalab/notebooks for samples of using this package.

Installation

This package is available on PyPI as datalab:

pip install datalab

Using in Jupyter

After datalab installation, enable datalab's frontend in Jupyter by running:

jupyter nbextension install --py datalab.notebook --sys-prefix

See further details Jupyter Kernel and Notebook Extensions.

Then in a notebook cell, enable datalab's magics with:

%load_ext google.datalab.kernel

(Note: If you hit an error "module traceback cannot be imported", try setting the following environment variable: CLOUDSDK_PYTHON_SITEPACKAGES=1)

Alternatively add this to your ipython_config.py file in your profile:

c = get_config()
c.InteractiveShellApp.extensions = [
    'google.datalab.kernel'
]

You will typically put this under ~/.ipython/profile_default. See the IPython docs for more about IPython profiles.

If you want to access Google Cloud Platform services such as BigQuery, you will also need to install gcloud. You will need to use gcloud to authenticate; e.g. with:

gcloud auth login

You will also need to set the project ID to use; either set a PROJECT_ID environment variable to the project name, or call set_datalab_project_id(name) from within your notebook.

Documentation

You can read the Sphinx generated docs at: http://googledatalab.github.io/pydatalab/

Development installation

If you'd like to work on the package, it's useful to be able to install from source. You will need the Typescript compiler installed.

First:

git clone https://github.com/googledatalab/pydatalab.git
cd pydatalab

Then do one of the folowing:

./install-virtualenv.sh  # For use in Python virtual environments
./install-no-virtualenv.sh  # For installing in a non-virtual environment

You can ignore the message about running jupyter nbextension enable; it is not required.