CD2H gitForager

jupyterlab/jupyterlab

Name: jupyterlab

Description: JupyterLab computational environment. This is a very early preview, and is not suitable for general usage yet.

Created: 2016-06-03 20:09:17.0

Updated: 2018-01-18 20:50:28.0

Pushed: 2018-01-18 19:43:30.0

Homepage:

Size: 54371

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

JupyterLab

An extensible environment for interactive and reproducible computing, based on the Jupyter Notebook and Architecture.

JupyterLab is the next-generation user interface for Project Jupyter. It offers all the familiar building blocks of the classic Jupyter Notebook (notebook, terminal, text editor, file browser, rich outputs, etc.) in a flexible and powerful user inteface that can be extended through third party extensions. Eventually, JupyterLab will replace the classic Jupyter Notebook after JupyterLab reaches 1.0.

JupyterLab is currently in beta. The beta releases are suitable for general usage. For JupyterLab extension developers, the extension APIs will continue to evolve until the 1.0 release.

For a good overview of JupyterLab, please see this link to a recent talk we gave about JupyterLab at PyData Seattle (2017).

Getting started

Installation

If you use conda, you can install as:

a install -c conda-forge jupyterlab

If you use pip, you can install it as:

install jupyterlab

Note: For all methods of installation, if you are using a version of Jupyter Notebook earlier than 5.3, then you must also run the following command after installation to enable the JupyterLab server extension:

ter serverextension enable --py jupyterlab --sys-prefix

Instructions on how to install the project from the git sources are available in our contributor documentation.

Note: If installing using pip install --user, you must add the user-level bin directory to your PATH environment variable in order to launch jupyter lab.

If you use pipenv, you can install it as:

nv install jupyterlab
nv shell

or from a git checkout:

nv install git+git://github.com/jupyterlab/jupyterlab.git#egg=jupyterlab
nv shell

When using pipenv, in order to launch jupyter lab, you must activate the project's virtualenv. For example, in the directory where pipenv's Pipfile and Pipfile.lock live (i.e., where you ran the above commands):

nv shell
ter lab

Running

Start up JupyterLab using:

ter lab

JupyterLab will open automatically in your browser. You may also access JupyterLab by entering the notebook server's URL (http://localhost:8888) in the browser.

Prerequisites

Jupyter notebook version 4.3 or later. To check the notebook version:

ter notebook --version

Supported runtimes

The runtime versions which are currently known to work:

Firefox Latest
Chrome Latest
Safari Latest

Earlier browser versions may also work, but come with no guarantees.

JupyterLab uses CSS Variables for styling, which is one reason for the minimum versions listed above. IE 11+ or Edge 14 do not support CSS Variables, and are not directly supported at this time. A tool like postcss can be used to convert the CSS files in the jupyterlab/build directory manually if desired.

Documentation

Read our documentation on ReadTheDocs.

Development

Contributing

If you would like to contribute to the project, please read our contributor documentation.

JupyterLab follows the official Jupyter Code of Conduct.

Extensions

JupyterLab can be extended using extensions that are npm packages and use our public APIs. See our documentation for users and developers.

License

We use a shared copyright model that enables all contributors to maintain the copyright on their contributions. All code is licensed under the terms of the revised BSD license.

Team

JupyterLab is part of Project Jupyter and is developed by an open community of contributors. JupyterLab's current maintainers are as follows:

(listed in alphabetical order, with affiliation, and main areas of contribution)

Chris Colbert, Project Jupyter (co-creator, application/low-level architecture, technical leadership, vision, phosphor.js)
Afshin Darian, Project Jupyter (co-creator, settings, inspector, completer, prolific contributions throughout the code base).
Jessica Forde, Project Jupyter (demo, documentation)
Brian Granger, Cal Poly (co-creator, strategy, vision, management, UI/UX design, architecture).
Jason Grout, Bloomberg (co-creator, vision, general development).
Cameron Oelsen, Cal Poly (UI/UX design).
Fernando Perez, UC Berkeley (co-creator, vision).
Ian Rose, UC Berkeley (Real-time collaboration, document architecture).
Steven Silvester, Quansight (co-creator, release management, packaging, prolific contributions throughout the code base).

This list is provided to help provide context about who we are and how our team functions. This team is accompanied by a much larger group of contributors to JupyterLab and Project Jupyter as a whole. If you would like to be listed here, please submit a pull request with your information.

Getting help

We encourage you to ask questions on the mailing list, and you may participate in development discussions or get live help on Gitter.

Resources

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.