The Microsoft.Jupyter.Core library makes it easier to write language kernels for Jupyter using .NET Core languages like C# and F#. This library uses .NET Core technologies such as the ASP.NET Core Dependency Injection Framework to help make it straightforward to develop for the Jupyter platform.
Kernels developed using Microsoft.Jupyter.Core can be installed as .NET Core Global Tools. This makes it easy to package, distribute, and install language kernels. For instance, the IEcho sample kernel can be installed into a user's Jupyter environment with two commands:
dotnet tool install -g Microsoft.Jupyter.Example.IEcho dotnet iecho install
Once installed, the IEcho example can then be used like any other Jupyter kernel by running your favorite client:
Making New Language Kernels
Using Microsoft.Jupyter.Core to make a new language kernel follows in several steps:
- Create a new console application project in your favorite .NET Core language.
- Add properties to your project to enable packaging as a .NET Core Global Tool.
Microsoft.Jupyter.Coreas a package reference to your new project.
- Add metadata properties for your new kernel.
- Subclass the
- Pass your metadata and engine to the
Each of these steps has been demonstrated in the example kernels provided with the library:
- IEcho: A simple language kernel that echos its input back as output.
- IMoon: A language kernel for the MoonSharp dialect of Lua.
For more details, see the provided tutorial.
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.