Skip to content
Library for writing Jupyter kernels in .NET Core
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
ci
docs Skeleton for DocFX build. Jan 3, 2019
examples
src
tests Adding try/catch to make sure kernel does not die with runtime except… Mar 19, 2019
.gitignore
LICENSE
README.md
docfx.json
jupyter-core.sln
tutorial.md Merged PR 1181: Initial commit Dec 20, 2018

README.md

Microsoft.Jupyter.Core Preview

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:

jupyter notebook

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.
  • Add Microsoft.Jupyter.Core as a package reference to your new project.
  • Add metadata properties for your new kernel.
  • Subclass the BaseEngine class.
  • Pass your metadata and engine to the KernelApplication class.

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.

Contributing

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.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

You can’t perform that action at this time.