1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
.. Copyright (c) 2017, Martin Renou, Johan Mabille, Sylvain Corlay, and
Wolf Vollprecht
Distributed under the terms of the BSD 3-Clause License.
The full license is in the file LICENSE, distributed with this software.
.. raw:: html
<style>
.rst-content .section>img {
width: 30px;
margin-bottom: 0;
margin-top: 0;
margin-right: 15px;
margin-left: 15px;
float: left;
}
</style>
Installation
============
With Conda
----------
`xeus-python` has been packaged for the conda package manager.
To ensure that the installation works, it is preferable to install `xeus-python` in a fresh conda environment.
It is also needed to use a miniconda_ installation because with the full anaconda_ you may have a conflict with
the `zeromq` library which is already installed in the anaconda distribution.
The safest usage is to create an environment named `xeus-python` with your miniconda installation
.. code::
conda create -n xeus-python
conda activate xeus-python # Or `source activate xeus-python` for conda < 4.6
Then you can install in this freshly created environment `xeus-python` and its dependencies
.. code::
conda install xeus-python notebook -c conda-forge
or, if you prefer to use JupyterLab_
.. code::
conda install xeus-python jupyterlab -c conda-forge
From PyPI
---------
Depending on the platform, PyPI wheels may be available for xeus-python.
.. code::
pip install xeus-python notebook
However, the wheels uploaded on PyPI are **experimental**.
In general we strongly recommend using a package manager instead. We maintain the conda-forge package,
and nothing prevents you from creating a package your favorite Linux distribution or FreeBSD.
The ongoing effort to package xeus-python for pip takes place in the `xeus-python-wheel`_ repository.
From Source
-----------
You can install ``xeus-python`` from source with cmake. This requires that you have all the dependencies installed in the same prefix.
.. code::
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/path/to/prefix ..
make install
On Windows platforms, from the source directory:
.. code::
mkdir build
cd build
cmake -G "NMake Makefiles" -DCMAKE_INSTALL_PREFIX=/path/to/prefix ..
nmake
nmake install
Installing the Kernel Spec
==========================
When installing xeus-python in a given installation prefix, the corresponding Jupyter kernelspecs are installed in the same environment and are automatically picked up by Jupyter if it is installed in the same prefix.
However, if Jupyter is installed in a different location, it will not pick up the new kernel. The xeus-python can be registered with the following command:
.. code::
jupyter kernelspec install PREFIX/share/jupyter/xpython --sys-prefix
For more information on the ``jupyter kernelspec`` command, please consult the ``jupyter_client`` documentation.
.. _miniconda: https://conda.io/miniconda.html
.. _anaconda: https://www.anaconda.com
.. _JupyterLab: https://jupyterlab.readthedocs.io
.. _xeus-python-wheel: https://github.com/jupyter-xeus/xeus-python-wheel
|
