/machinelearning-samples

Samples for ML.NET, an open source and cross-platform machine learning framework for .NET.

Primary LanguagePowerShellMIT LicenseMIT

Note: We'd love to hear your thoughts about MLOps. Let us know in this survey.

ML.NET Samples

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

In this GitHub repo, we provide samples which will help you get started with ML.NET and how to infuse ML into existing and new .NET apps.

Note: Please open issues related to ML.NET framework in the Machine Learning repository. Please create the issue in this repo only if you face issues with the samples in this repository.

There are two types of samples/apps in the repo:

  • Getting Started : ML.NET code focused samples for each ML task or area, usually implemented as simple console apps.

  • End-End apps : End-user sample web and desktop apps infused with Machine Learning models based on ML.NET.

The official ML.NET samples are divided in multiple categories depending on the scenario and machine learning problem/task, accessible through the following tables:

Binary classification
Binary classification chart
Getting started icon
Sentiment Analysis
C#     F#
Movie Recommender chart
Getting started icon
Spam Detection
C#     F#
Power Anomaly detection chart
Getting started icon
Credit Card Fraud Detection
(Binary Classification)
C#    F#
disease detection chart
Getting started icon
Heart Disease Prediction
C#
Multi-class classification
Issue Labeler chart
End-to-end app icon
Issues Classification
C#  F#
Movie Recommender chart
Getting started icon
Iris Flowers Classification
C#    F#
Movie Recommender chart
Getting started icon
MNIST
C#
Recommendation
Product Recommender chart
Getting started icon
Product Recommendation
C#
Movie Recommender chart
Getting started icon
Movie Recommender
(Matrix Factorization)
C#
Movie Recommender chart
End-to-end app icon
Movie Recommender
(Field Aware Factorization Machines)
C#
Regression
Price Prediction chart
Getting started icon
Price Prediction
C#     F#

Sales ForeCasting chart
End-to-end app icon
Sales Forecasting (Regression)
C#

Demand Prediction chart
Getting started icon
Demand Prediction
C#    F#
Time Series Forecasting

Sales ForeCasting chart
End-to-end app icon
Sales Forecasting (Time Series)
C#

Anomaly Detection
Spike detection chart

Sales Spike Detection
Getting started icon C#      End-to-end app icon C#
Spike detection chart
Getting started icon
Power Anomaly Detection
C#
Power Anomaly detection chart
Getting started icon
Credit Card Fraud Detection
(Anomaly Detection)
C#
Clustering
Customer Segmentation chart
Getting started icon
Customer Segmentation
C#     F#
IRIS Flowers chart
Getting started icon
IRIS Flowers Clustering
C#     F#
Ranking
Ranking chart
Getting started icon
Rank Search Engine Results
C#
Computer Vision
Image Classification chart
Image Classification Training
(High-Level API)
Getting started icon C# F#      
Image Classification chart
Image Classification Predictions
(Pretrained TensorFlow model scoring)
Getting started icon C#   F#       End-to-end app icon C#
Image Classification chart
Image Classification Training
(TensorFlow Featurizer Estimator)
Getting started icon C#   F#

Object Detection chart
Object Detection
(ONNX model scoring)
Getting started icon C#      End-to-end app icon C#


Cross Cutting Scenarios
web image
End-to-end app icon
Scalable Model on WebAPI
C#
web image
End-to-end app icon
Scalable Model on Razor web app
C#
Azure functions logo
End-to-end app icon
Scalable Model on Azure Functions
C#
Database chart
End-to-end app icon
Scalable Model on Blazor web app
C#
large file chart
Getting started icon
Large Datasets
C#
Database chart
Getting started icon
Loading data with DatabaseLoader
C#
Database chart
Getting started icon
Loading data with LoadFromEnumerable
C#
Model explainability chart
End-to-end app icon
Model Explainability
C#
Extensibility icon
End-to-end app icon
Export to ONNX
C#

Automate ML.NET models generation (Preview state)

The previous samples show you how to use the ML.NET API 1.0 (GA since May 2019).

However, we're also working on simplifying ML.NET usage with additional technologies that automate the creation of the model for you so you don't need to write the code by yourself to train a model, you simply need to provide your datasets. The "best" model and the code for running it will be generated for you.

These additional technologies for automating model generation are in PREVIEW state and currently only support Binary-Classification, Multiclass Classification and Regression. In upcoming versions we'll be supporting additional ML Tasks such as Recommendations, Anomaly Detection, Clustering, etc..

CLI samples: (Preview state)

The ML.NET CLI (command-line interface) is a tool you can run on any command-prompt (Windows, Mac or Linux) for generating good quality ML.NET models based on training datasets you provide. In addition, it also generates sample C# code to run/score that model plus the C# code that was used to create/train it so you can research what algorithm and settings it is using.

CLI (Command Line Interface) samples
Binary Classification sample
MultiClass Classification sample
Regression sample

AutoML API samples: (Preview state)

THESE SAMPLES USE THE 0.1.x VERSION OF THE AUTOML API. WHILE THESE APIS STILL WORK IN VERSION 0.2.x WE RECOMMEND USING THE NEW APIS INTRODUCED IN 0.2.x AND LATER. FOR 0.2.x SAMPLES, SEE ML.NET 2.0 Samples.

ML.NET AutoML API is basically a set of libraries packaged as a NuGet package you can use from your .NET code. AutoML eliminates the task of selecting different algorithms, hyperparameters. AutoML will intelligently generate many combinations of algorithms and hyperparameters and will find high quality models for you.

AutoML API samples
Binary Classification sample
MultiClass Classification sample
Ranking sample
Regression sample
Advanced experiment sample

Additional ML.NET Community Samples

In addition to the ML.NET samples provided by Microsoft, we're also highlighting samples created by the community showcased in this separated page: ML.NET Community Samples

Those Community Samples are not maintained by Microsoft but by their owners. If you have created any cool ML.NET sample, please, add its info into this REQUEST issue and we'll publish its information in the mentioned page, eventually.

Translations of Samples:

Learn more

See ML.NET Guide for detailed information on tutorials, ML basics, etc.

API reference

Check out the ML.NET API Reference to see the breadth of APIs available.

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.

License

ML.NET Samples are licensed under the MIT license.