Environment:Dotnet Machinelearning Dotnet SDK And Runtime

Knowledge Sources	dotnet/machinelearning ML.NET Documentation
Domains	Infrastructure, Runtime
Last Updated	2026-02-09 11:00 GMT

Overview

.NET SDK 10.0.100 build environment targeting netstandard2.0 and net8.0, with runtime compatibility for .NET 6.0.36 and .NET 8.0.16.

Description

This environment defines the .NET SDK and runtime versions required to build and run ML.NET. The project uses .NET SDK 10.0.100 for building, targets netstandard2.0 for broad compatibility across most ML.NET core packages, and net8.0 for modern GenAI modules. The runtime is tested against .NET 6.0.36 and .NET 8.0.16. Legacy .NET Framework 4.6.1 or later is also supported for consumption.

Usage

Use this environment for any ML.NET development, building, or deployment. All ML.NET packages require this base .NET SDK and runtime environment. It is the foundational prerequisite for every Implementation in this repository.

System Requirements

Category	Requirement	Notes
OS	Windows, Linux, or macOS	Cross-platform support
Hardware	x64 recommended	32-bit Windows supported for some components
Disk	5GB+ free	SDK, NuGet cache, and build artifacts

Dependencies

System Packages

`.NET SDK` = 10.0.100
`Microsoft.DotNet.Arcade.Sdk` = 11.0.0-beta.25626.7
`Microsoft.Build.NoTargets` = 3.7.0
`Microsoft.Build.Traversal` = 3.2.0

NuGet Packages (Core Runtime)

`System.Numerics.Tensors` >= 9.0.4
`Microsoft.Bcl.AsyncInterfaces` >= 9.0.4
`Microsoft.Extensions.DependencyInjection` >= 9.0.4
`Microsoft.Extensions.Logging` >= 9.0.4
`Google.Protobuf` >= 3.30.2

Target Frameworks

`netstandard2.0` (most ML.NET core packages)
`net8.0` (GenAI modules: Microsoft.ML.GenAI.Core, Microsoft.ML.GenAI.LLaMA, etc.)

Credentials

No credentials are required for basic .NET SDK usage. NuGet package restore uses public feeds by default.

Quick Install

# Install .NET SDK 10.0 (or latest compatible)
# See https://dotnet.microsoft.com/download for platform-specific installers

# Verify installation
dotnet --version
# Expected: 10.0.100 or compatible

# Restore all packages
dotnet restore

Code Evidence

SDK version pinning from `global.json:2-4`:

"sdk": {
    "version": "10.0.100"
}

Runtime version declarations from `global.json:5-8`:

"tools": {
    "dotnet": "$(DotNetRuntime60Version)",
    "dotnet": "$(DotNetRuntime80Version)"
}

Resolved runtime versions from `eng/Versions.props:94-95`:

<DotNetRuntime60Version>6.0.36</DotNetRuntime60Version>
<DotNetRuntime80Version>8.0.16</DotNetRuntime80Version>

Target framework from typical .csproj files:

<TargetFramework>netstandard2.0</TargetFramework>

GenAI modules target from `src/Microsoft.ML.GenAI.Core/Microsoft.ML.GenAI.Core.csproj:4`:

<TargetFramework>net8.0</TargetFramework>

Common Errors

Error Message	Cause	Solution
`The SDK 'Microsoft.NET.Sdk' specified could not be found`	.NET SDK not installed or wrong version	Install .NET SDK 10.0.100 from dotnet.microsoft.com
`The framework 'netstandard2.0' is not available`	Incompatible SDK version	Ensure global.json matches installed SDK
`Package restore failed`	NuGet feed connectivity	Check internet connection; verify NuGet.config feeds

Compatibility Notes

netstandard2.0 packages are compatible with .NET Core 2.1+, .NET 5+, and .NET Framework 4.6.1+.
net8.0 packages (GenAI modules) require .NET 8.0 runtime or later.
Assembly version is pinned at `1.0.0.0` across the solution.

Related Pages

Page Connections

Double-click a node to navigate. Hold to expand connections.

Principle

Implementation

Heuristic

Environment