You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<imgclass="img-responsive" src="assets/labpreview.png" id="portal" alt="examples of jupyterlab workspaces in single document and multiple document workspaces"/>
47
+
</div>
48
+
<divclass="col-md-6 nb-highlight-text">
49
+
<h3>JupyterLab - A Next-Generation Notebook Interface</h3>
50
+
<h4class="lab-desc">JupyterLab is a web-based platform that combines live code, text, images, visualizations, and data analysis into a single,
51
+
interactive environment. JupyterLab offers all the building blocks of the classic Jupyter Notebook in an extendable interface.</h4>
52
+
</div>
53
+
<div>
54
+
<aclass="orange-button" href="try">Try it in your browser</a>
<imgclass="img-responsive language" src="assets/easy.svg" id="feature" alt="icon to represent ease of use">
65
+
<h4>Easy to Use</h4>
66
+
<p>Compose notebooks, run terminals or consoles, and edit text files all within your browser. With a simple, straight-forward interface, start programming right away using any language.</p>
67
+
</div>
68
+
<divclass="col-md-3 notebook-feature">
69
+
<imgclass="img-responsive share" src="assets/flexible.svg" alt="icon to flexibility">
70
+
<h4>Share notebooks</h4>
71
+
<p>Test your code as you go; see results immediately and iterate on your explorations. JupyterLab extends the Classic Notebook interface to give a desktop-like work area in which to explore data.</p>
72
+
</div>
73
+
<divclass="col-md-3 notebook-feature">
74
+
<imgclass="img-responsive widget" src="assets/recroducible.svg" alt="icon to represent reproducibility">
75
+
<h4>Reproducible</h4>
76
+
<p>Allow others to replicate and build off your work. Explain your thought process step-by-step, and share it so others can run the same analysis from anywhere in the cloud, or on their own machine.</p>
77
+
</div>
78
+
<divclass="col-md-3 notebook-feature">
79
+
<imgclass="img-responsive data" src="assets/shareable.svg" alt="icon to represent sharing a notebook">
80
+
<h4>Shareable</h4>
81
+
<p>Visualize your work and tell a story in a way that feels simple and fun. Export to a variety of formats, including a webpage, PDF, and Word document, and share it with others.</p>
Copy file name to clipboardExpand all lines: install.md
+50-7
Original file line number
Diff line number
Diff line change
@@ -1,16 +1,59 @@
1
1
---
2
2
layout: page_md
3
-
title: Installing the Jupyter Notebook
4
-
tagline: Get up and running with the Jupyter Notebook on your computer within minutes!
3
+
title: Installing the Jupyter Software
4
+
tagline: Get up and running with the JupyterLab or the classic Jupyter Notebook on your computer within minutes!
5
5
permalink: /install
6
6
---
7
7
8
-
## Prerequisite: Python
9
-
While Jupyter runs code in many programming languages, Python is a requirement
10
-
(Python 3.3 or greater, or Python 2.7) for installing the Jupyter Notebook itself.
8
+
## Getting started with JupyterLab
9
+
10
+
### Installation
11
+
12
+
[install](http://jupyterlab.readthedocs.io/en/stable/getting_started/installation.html) JupyterLab using `conda`, `pip`, or `pipenv`. Conda is recommended if you have no installation preference.
13
+
14
+
Project installation instructions from the git sources are available in the [contributor documentation](CONTRIBUTING.md).
15
+
16
+
#### conda
17
+
18
+
Conda is an open source package management system and environment management system that runs on Windows, macOS, and Linux. Conda packages and distributes software for any language, and by default uses the Anaconda repository managed by Anaconda Inc. To install conda, please [see the conda installation instructions](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html).
19
+
20
+
Install the [JupyterLab `conda` package](https://anaconda.org/conda-forge/jupyterlab) with:
21
+
22
+
```bash
23
+
conda install -c conda-forge jupyterlab
24
+
```
11
25
26
+
#### pip
27
+
28
+
pip is a package management system for installing and updating Python packages, and comes with any Python installation. On Ubuntu, SUSE Enterprise Linux, openSUSE, and Fedora Linux, use the system package manager to install the `python3-pip` package. [\_The Hitchhiker's Guide to Python_provides guidance on how to install Python](https://docs.python-guide.org/starting/installation/); Another option is to [install Python directly from python.org](https://www.python.org/getit/). We suggest you [upgrade pip](https://pip.pypa.io/en/stable/installing/) before using it to install other programs.
29
+
30
+
JupyterLab requires Python 3.5 or higher.
31
+
32
+
1. When using Windows with Python version 3.5 or higher, use the [Python Launcher for Windows](https://docs.python.org/3/using/windows.html?highlight=shebang#python-launcher-for-windows) to use `pip` with Python version 3:
33
+
```bash
34
+
py -3 -m pip install jupyterlab
35
+
```
36
+
2. If the system has a `python3`command (standard on Unix-like systems), install with the comand:
37
+
```bash
38
+
python3 -m pip install jupyterlab
39
+
```
40
+
3. Using the `python`command directly is another option, but this will use the _current_ version of Python (which may be Python version 2 or version 3 if both are installed):
41
+
```bash
42
+
python -m pip install jupyterlab
43
+
```
44
+
45
+
Some systems have a `pip3`command that has the same effect as `python3 -m pip` and/or a `pip`command that behaves the same as `python -m pip`.
46
+
47
+
Adding `--user` after `pip install` will install the files to a local user install directory (typically `~/.local/` or `%APPDATA%\Python` on Windows) instead of the system-wide directory. This can be helpful, especially if writing to the system-wide directory is not permitted. However, the user-level `bin` directory must be added to the `PATH` environment variable in order to launch `jupyter lab`.
48
+
49
+
50
+
## Getting started with the classic Jupyter Notebook
51
+
52
+
### Prerequisite: Python
53
+
While Jupyter runs code in many programming languages, Python is a requirement
54
+
(Python 3.3 or greater, or Python 2.7) for installing the JupyterLab or the classic Jupyter Notebook.
12
55
13
-
## Installing Jupyter using Anaconda
56
+
### Installing Jupyter Notebook using Anaconda
14
57
We **strongly recommend** installing Python and Jupyter using the [Anaconda Distribution](https://www.anaconda.com/downloads),
15
58
which includes Python, the Jupyter Notebook, and other commonly used packages for scientific computing and data science.
16
59
@@ -26,7 +69,7 @@ jupyter notebook
26
69
27
70
See [Running the Notebook](https://jupyter.readthedocs.io/en/latest/running.html#running) for more details.
28
71
29
-
## Installing Jupyter with pip
72
+
### Installing Jupyter Notebook with pip
30
73
As an existing or experienced Python user, you may wish to install Jupyter using Python’s package manager, pip, instead of Anaconda.
31
74
32
75
If you have Python 3 installed (which is recommended):
0 commit comments