In November 2019, we announced .NET support for Jupyter notebooks with both C# and F# support. Today we are excited to announce Preview 2 of the .NET Notebook experience.
What’s new
New Name – Meet .NET interactive
As our scenarios grew in Try .NET, we wanted a new name that encompassed all our new experiences from the runnable snippets on the web powered by Blazor (as seen on the .NET page) , to interactive documentation for .NET Core with the dotnet try global tool, to .NET Notebooks.
Today we are announcing our official name change to .NET interactive.
.NET interactive is a group of CLI tools and APIs that enable users to create interactive experiences across the web, markdown, and notebooks.
.NET Interactive Breakdown
dotnet interactiveglobal tool : For .NET Notebooks (Jupyter and nteract)dotnet tryglobal tool : For Workshops and offline docs. Interactive markdown with a backing project.trydotnet.jsAPI (not publicly available yet): Online documentation. For example, on docs and .NET page. Currently, only used internally at Microsoft.
New Repo – dotnet/interactive
Moving forward, we have decided to split dotnet try and dotnet interactive tools into separate repos.
- For any issues, feature requests, and contributions to .NET Notebooks, please visit the .NET Interactive repo.
- For any issues, feature requests, and contributions on interactive markdown and trydotnet.js, please visit the Try .NET repo.
New Global Tool – dotnet interactive
How Install .NET Interactive
First, make sure you have the following installed:
- The .NET 3.1 SDK.
-
Jupyter. Jupyter can be installed using Anaconda.
-
Open the Anaconda Prompt (Windows) or Terminal (macOS) and verify that Jupyter is installed and present on the path:
> jupyter kernelspec list
python3 ~\jupyter\kernels\python3
- Next, in an ordinary console, install the
dotnet interactiveglobal tool:
> dotnet tool install --global Microsoft.dotnet-interactive
- Install the .NET kernel by running the following within your Anaconda Prompt:
> dotnet interactive jupyter install
[InstallKernelSpec] Installed kernelspec .net-csharp in ~\jupyter\kernels\.net-csharp
.NET kernel installation succeeded
[InstallKernelSpec] Installed kernelspec .net-fsharp in ~\jupyter\kernels\.net-fsharp
.NET kernel installation succeeded
[InstallKernelSpec] Installed kernelspec .net-powershell in ~\jupyter\kernels\.net-powershell
.NET kernel installation succeeded
- You can verify the installation by running the following again in the Anaconda Prompt:
> 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
Please Note: If you are looking for dotnet try experience please visit dotnet/try.
New language support – PowerShell
PowerShell Notebooks
PowerShell notebooks combine the management capabilities of PowerShell with the rich visual experience of notebooks. The integration of PowerShell’s executable experience with rich text and visualization open up scenarios for PowerShell users to integrate and amplify their teaching, and support documents. As an example, this demo of a new PowerShell feature was easily transformed into a shareable, interactive teaching tool.
With the multi-kernel experience provided by the .NET interactive kernel a single notebook, now with PowerShell support, can efficiently target both the management plane and the data plane.
DBAs, sysadmins, and support engineers alike have found PowerShell notebooks useful for resource manipulation and management. For example, this notebook teachers the user how to create an Azure VM from PowerShell.
We look forward to seeing what our customers to do with this experience. Read the PowerShell blog post for more information.
Run .NET Code in nteract.io
In addition to writing .NET Code in Jupyter Notebooks, users can now write their code in nteract. nteract is an open-source organization that builds SDKs, applications, and libraries that helps people make the most of interactive notebooks and REPLs. We are excited to have our .NET users take advantage of the rich REPL experience nteract provides,including the nteract desktop app.
To get started with .NET Interactive in nteract please download the nteract desktop app and install the .NET kernels.
Resources
- Try sample .NET notebooks online using Binder. This also allows you try out .NET Interactive daily builds.
- Create and run .NET notebooks on your machine.
- Share your own .NET notebooks with others online using Binder.
- .NET Interactive with nteract
Our team can’t wait to see what you do with .NET Interactive. Please check out our repo to learn more and let us know what you build.
Happy interactive programming !
The trials and tribulations of a New Guy.
Following the blog post, I
1. Download and install Anaconda
2. Download and install dotnet Core SDK (v. 3.1.201)
3. (At the Anaconda prompt), run jupyter kernelspec list. And receive
python3 ~\jupyter\kernels\python3
4. (In the command shell), I invoke > dotnet tool install --global Microsoft.dotnet-interactive
5. I return to the Anaconda prompt to run > "C:\Program Files\dotnet> dotnet interactive jupyter install
6. And I'm rewarded for my efforts with:
Could not execute because...
Please open an issue at https://github.com/dotnet/interactive/issues and we’ll take a look. One additional piece of information that would be helpful is what version of dotnet-interactive you’re using, which you can find by running this at the command prompt:
dotnet-interactive –version
Can anybody tell me how to make intellisense(auto completion) of this(.NET Interactive) Case-Insensitive?
In lieu of an emoji for back-flip somersaults, YESSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS!
This technology is what I’ve wanted for so long.
Thank you.
I absolutely love the work that's being done here, thanks to the Interactive team for making this a reality.
I also love the new Jupyter support (currently in the Python extension for) VS Code.
It would be wonderful to have Interactive work with Jupyter in VS Code.
I posted this request on the Interactive and vscode-python GitHub sites but wanted to share my request here as well. There seems to be an intent to make this happen, one way or another, which is great. (Though, I might have poked a wasps nest with my questions. :)
https://github.com/dotnet/interactive/issues/179
https://github.com/microsoft/vscode-python/issues/5078#issuecomment-588437582
VS Code with Jupyter .NET Interactive is a must-have feature. Please make it available ASAP :). Thanks a lot.
Keep an eye on our PRs: https://github.com/dotnet/interactive/pull/412