Interfaces

Jupyter and IPython

To use LineaPy in an interactive computing environment such as Jupyter Notebook/Lab or IPython, launch the environment with the lineapy command, like so:

$ lineapy jupyter notebook

$ lineapy jupyter lab

$ lineapy ipython

Each will automatically load the LineaPy extension in the corresponding interactive shell application.

Or, if the application is already running without the extension loaded, which can happen when we start the Jupyter server with jupyter notebook or jupyter lab without lineapy, you can load it on the fly with:

%load_ext lineapy

executed at the top of your session. Please note:

  • You will need to run this as the first command in a given session; executing it in the middle of a session will lead to erroneous behaviors by LineaPy.

  • This loads the extension to the current session only, i.e., it does not carry over to different sessions; you will need to repeat it for each new session.

Hosted Jupyter Environment

In hosted Jupyter notebook environments such as JupyterHub, Google Colab, Kaggle or other environments that you do not start your notebook from CLI (such as Jupyter extension within VS Code), you need to install lineapy directly within your notebook first via:

!pip install lineapy

Then you can manually load lineapy extension with :

%load_ext lineapy

For environments with older versions IPython<7.0 like Google Colab, we need to upgrade the IPython>=7.0 module before the above steps, we can upgrade IPython via:

!pip install --upgrade ipython

and restart the notebook runtime:

exit()

Finally, we can start setting up LineaPy as described previously.

CLI

We can also use LineaPy as a CLI command. Run:

$ lineapy python --help

to see available options.