There are two ways to use .NET notebooks on your machine with .NET Interactive:
- Install .NET Interactive as a Jupyter kernel for use with Jupyter Notebook, JupyterLab, nteract, Azure Data Studio, and others.
or
- Install the .NET Interactive Notebooks extension
Both of these methods can read and write .ipynb
files, which are fully portable between them.
First, make sure you have the following installed:
-
The .NET 6 SDK.
-
Jupyter. An easy way to install Jupyter is through Anaconda.
-
You can verify the installations by opening the Anaconda Prompt (Windows) or a terminal (macOS, Linux) and running the following commands to ensure that Jupyter and .NET are installed and present on the path:
> jupyter kernelspec list
python3 ~\jupyter\kernels\python3
> dotnet --version
6.0.100
(The minor version isn't important.)
- Next, in an ordinary console, install the
dotnet interactive
global tool:
> dotnet tool install -g Microsoft.dotnet-interactive
- Switch back to your Anaconda prompt and install the .NET kernel by running the following:
> dotnet interactive jupyter install
Installing using jupyter kernelspec module.
Installed ".NET (C#)" kernel.
Installing using jupyter kernelspec module.
Installed ".NET (F#)" kernel.
Installing using jupyter kernelspec module.
Installed ".NET (PowerShell)" kernel.
- You can verify the installation by running the following again in the Anaconda Prompt. You should now see a
kernelspec
entry for each of the default supported .NET languages:
> jupyter kernelspec list
.net-csharp ~\jupyter\kernels\.net-csharp
.net-fsharp ~\jupyter\kernels\.net-fsharp
.net-powershell ~\jupyter\kernels\.net-powershell
python3 ~\jupyter\kernels\python3
To update to the latest version of .NET Interactive open an ordinary console and run the following code:
> dotnet tool update -g Microsoft.dotnet-interactive
To launch Jupyter, you can run either jupyter lab
or jupyter notebook
from your Anaconda Prompt, or you can launch Jupyter using the Anaconda Navigator.
Once Jupyter has launched in your browser, you have the option to create notebooks using C#, F#, or PowerShell.
For more information on the .NET notebook experience, please check out our samples and documentation on Binder or in this repo under docs
and samples
.
Once you've created a .NET notebook, you might want to share it with others. In the next document, you will learn how to share your .NET notebook with others using Binder.