README.md

.NET Interactive Documentation

Our documentation is still a work in progress. There are a number of topics listed under Features below that don't have outgoing links yet, but we've included them to give a better sense of the current feature set. Please open an issue if you'd like to know more about one of the topics we haven't gotten around to documenting yet.

Getting started

Jupyter and nteract

There are several ways to get started using .NET Interactive with Jupyter, including Jupyter Notebook, JupyterLab, and nteract.

• Try sample .NET notebooks online using Binder.
• Create and run .NET notebooks on your machine.
• Share .NET notebooks online using Binder.

Visual Studio Code

Work is underway to add support for the new Visual Studio Code native notebook feature. While we are still in the early stages of this effort, if you'd like to experiment with it you can find instructions here.

Small factor devices

We support running on devices like Raspberry Pi and pi-top [4]. You can find instructions here.

Telemetry

Telemetry is collected when .NET Interactive is started. Once .NET Interactive is running, we do not collect telemetry from any further user actions. The telemetry is anonymous and reports only the values for a specific subset of the verbs in the .NET Interactive CLI. Those verbs are:

• dotnet interactive jupyter
• dotnet interactive jupyter install
• dotnet interactive http
• dotnet interactive stdio

How to opt out

The .NET Interactive telemetry feature is enabled by default. To opt out of the telemetry feature, set the DOTNET_INTERACTIVE_CLI_TELEMETRY_OPTOUT environment variable to 1 or true.

Disclosure

The .NET Interactive tool displays text similar to the following when you first run one of the .NET Interactive CLI commands (for example, dotnet interactive jupyter install). Text may vary slightly depending on the version of the tool you're running. This "first run" experience is how Microsoft notifies you about data collection.

Telemetry
---------
The .NET Core tools collect usage data in order to help us improve your experience.The data is anonymous and doesn't include command-line arguments. The data is collected by Microsoft and shared with the community. You can opt-out of telemetry by setting the DOTNET_INTERACTIVE_CLI_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.

To disable this message and the .NET Core welcome message, set the DOTNET_INTERACTIVE_CLI_TELEMETRY_OPTOUT environment variable to true. Note that this variable has no effect on telemetry opt out.

Features

• Support for multiple languages
• Display output (C# | F# | PowerShell)
• Create plots with with Xplot
• "Magic commands"
• Import NuGet packages
• Language-specific features
  • C#
    • The C# scripting dialect
    • PocketView
  • F#
    • F# Interactive (FSI)
  • HTML and JavaScript
  • PowerShell
    • PowerShell profile support
    • PowerShell host support
    • AzShell support
• Getting input from the user
• Multi-language notebooks
  • Switching between languages
    • Per-cell
    • Within a single cell
  • .NET variable sharing
  • Accessing kernel variables from the client with JavaScript

Technical details

• Architecture
• How Jupyter kernel installation works

Visualization

• XPlot
• Visualization with JavaScript libraries

.NET Interactive API Guides

• Using the .NET Interactive command-line interface

.NET API Guide (TODO)

• Commands and events
• Formatter APIs
  • Working with MIME types
• PocketView
• Magic commands
• Kernel APIs
  • Variable sharing
• JSON API for Standard I/O and HTTP modes (TODO)

JavaScript API Guide (TODO)

• Accessing kernel data from client-side JavaScript
• Loading modules / RequireJS support
• Accessing static resources
• Sending kernel commands and consuming kernel events

Extending .NET Interactive

• Overview
• Building your own extension
  • Adding magic commands
• Publishing your extension using NuGet