ML.NET is an open source and cross-platform machine learning framework for .NET.
Clone or download
wschin Enable implicit-feedback recommendation via one-class matrix factoriz…
…ation (#1664)

Sync with the latest LIBMF to enable implicit-feedback recommendation
Latest commit df1c2af Nov 21, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build Complete VBuffer redesign (#1650) Nov 19, 2018
docs Update macOS Prerequisites (#1674) Nov 19, 2018
pkg Adding training statistics for LR in the HAL learners package. (#1392) Nov 13, 2018
src Enable implicit-feedback recommendation via one-class matrix factoriz… Nov 20, 2018
test Enable implicit-feedback recommendation via one-class matrix factoriz… Nov 20, 2018
tools-local/Microsoft.ML.InternalCodeAnalyzer Adding training statistics for LR in the HAL learners package. (#1392) Nov 13, 2018
.gitattributes Initial commit May 4, 2018
.gitignore switch housing dataset to wine (#170) May 23, 2018
.gitmodules Making MF to be a part of ML.NET (#1263) Oct 26, 2018
.vsts-dotnet-ci.yml Make whitening tests work on hosted macs (#1530) Nov 6, 2018
BuildToolsVersion.txt Update buildtools to 3.0.0-preview1-03129-01 (#767) Aug 30, 2018
CONTRIBUTING.md Fixed a spelling from adressing to addressing. (#651) Aug 6, 2018
Directory.Build.props Move towards being able to build for x86 (#1008) Oct 10, 2018
Directory.Build.targets Update documentation for LightGBM and add missing binary references t… Jul 2, 2018
DotnetCLIVersion.txt Move to netcoreapp2.1 (#690) Aug 21, 2018
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md May 7, 2018
LICENSE Initial commit May 4, 2018
Microsoft.ML.sln Movement and Internalization Phase 2 (#1626) Nov 16, 2018
PULL_REQUEST_TEMPLATE.md Update PULL_REQUEST_TEMPLATE.md May 7, 2018
README.md Update Readme.md Nov 16, 2018
ROADMAP.md Suggest a typo in "Update ROADMAP.md" (#1414) Nov 16, 2018
THIRD-PARTY-NOTICES.TXT Making MF to be a part of ML.NET (#1263) Oct 26, 2018
build.cmd Fixes build errors caused by spaces in the project path (#196) May 23, 2018
build.proj Make whitening tests work on hosted macs (#1530) Nov 6, 2018
build.sh Fixes build error when path contains space on Linux (#247) May 30, 2018
config.json Fix test output during CI. (#652) Aug 6, 2018
dir.traversal.targets Initial commit May 4, 2018
init-tools.cmd Introducing PR verification x86 CI build (#1309) Oct 26, 2018
init-tools.msbuild Initial commit May 4, 2018
init-tools.sh Update buildtools to 3.0.0-preview1-03129-01 (#767) Aug 30, 2018
run.cmd Moves dotnet-server shutdown to official build yml file (#1432) Oct 30, 2018
run.sh Fixes build error when path contains space on Linux (#247) May 30, 2018

README.md

Machine Learning for .NET

ML.NET is a cross-platform open-source machine learning framework which makes machine learning accessible to .NET developers.

ML.NET allows .NET developers to develop their own models and infuse custom machine learning into their applications, using .NET, even without prior expertise in developing or tuning machine learning models.

ML.NET was originally developed in Microsoft Research, and evolved into a significant framework over the last decade and is used across many product groups in Microsoft like Windows, Bing, PowerPoint, Excel and more.

ML.NET enables machine learning tasks like classification (for example: support text classification, sentiment analysis) and regression (for example, price-prediction).

Along with these ML capabilities, this first release of ML.NET also brings the first draft of .NET APIs for training models, using models for predictions, as well as the core components of this framework such as learning algorithms, transforms, and ML data structures.

Installation

NuGet Status

ML.NET runs on Windows, Linux, and macOS using .NET Core, or Windows using .NET Framework. 64 bit is supported on all platforms. 32 bit is supported on Windows, except for TensorFlow, LightGBM, and ONNX related functionality.

The current release is 0.7. Check out the release notes and blog post to see what's new.

First, ensure you have installed .NET Core 2.1 or later. ML.NET also works on the .NET Framework 4.6.1 or later, but 4.7.2 or later is recommended.

Once you have an app, you can install the ML.NET NuGet package from the .NET Core CLI using:

dotnet add package Microsoft.ML

or from the NuGet package manager:

Install-Package Microsoft.ML

Or alternatively, you can add the Microsoft.ML package from within Visual Studio's NuGet package manager or via Paket.

Daily NuGet builds of the project are also available in our MyGet feed:

https://dotnet.myget.org/F/dotnet-core/api/v3/index.json

Building

To build ML.NET from source please visit our developers guide.

x64 Debug x64 Release
Linux x64-debug x64-release
macOS x64-debug x64-release
Windows x64-debug x64-release

Contributing

We welcome contributions! Please review our contribution guide.

Community

Please join our community on Gitter Join the chat at https://gitter.im/dotnet/mlnet

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct.

Examples

Here's an example of code to train a model to predict sentiment from text samples. (You can find a sample of the legacy API here):

var mlContext = new MLContext();
var reader = mlContext.Data.TextReader(new TextLoader.Arguments
        {
        Column = new[] {
            new TextLoader.Column("SentimentText", DataKind.Text, 1),
            new TextLoader.Column("Label", DataKind.Bool, 0),
        },
        HasHeader = true,
        Separator = ","
});
var data = reader.Read(dataPath);
var learningPipeline = mlContext.Transforms.Text.FeaturizeText("SentimentText", "Features")
        .Append(mlContext.BinaryClassification.Trainers.FastTree());
var model = learningPipeline.Fit(data);

Now from the model we can make inferences (predictions):

var predictionFunc = model.MakePredictionFunction<SentimentData, SentimentPrediction>(mlContext);
var prediction = predictionFunc.Predict(new SentimentData
{
    SentimentText = "Today is a great day!"
});
Console.WriteLine("prediction: " + prediction.Prediction);

A cookbook that shows how to use these APIs for a variety of existing and new scenarios can be found here.

Samples

We have a repo of samples that you can look at.

License

ML.NET is licensed under the MIT license.

.NET Foundation

ML.NET is a .NET Foundation project.

There are many .NET related projects on GitHub.

  • .NET home repo - links to 100s of .NET projects, from Microsoft and the community.