<!--
{
  "availability" : [
    "macOS: 10.15.0 -",
    "Xcode: 16.0.0 -"
  ],
  "documentType" : "article",
  "framework" : "MetalPerformanceShaders",
  "identifier" : "/documentation/MetalPerformanceShaders/training-a-neural-network-with-metal-performance-shaders",
  "metadataVersion" : "0.1.0",
  "role" : "sampleCode",
  "title" : "Training a Neural Network with Metal Performance Shaders"
}
-->

# Training a Neural Network with Metal Performance Shaders

Use an MPS neural network graph to train a simple neural network digit classifier.

## Overview

The sample code describes how to write a neural network using [`MPSNNGraph`](doc://com.apple.documentation/documentation/MetalPerformanceShaders/MPSNNGraph) and how to train the network to recognize a digit in an image.
The sample trains a network for 300 iterations on a batch size of 40 images.
You’ll see how to set up training of weights and biases using data sources, including how to initialize and update weights.
You’ll also see how to validate the network using a test dataset.

> Note: This sample code project is associated with WWDC 2019 session [614: Metal for Machine Learning](https://developer.apple.com/videos/play/wwdc19/614/).

You can use any dataset of your choice to train this model.  The following dataset works well for this purpose:

[MNIST Dataset](http://yann.lecun.com/exdb/mnist/)

Please note that Apple does not own the copyright to this dataset nor makes any representations about the applicable terms of use for this dataset.

If you choose to use this dataset, the sample includes a script that downloads the dataset from that location and pass it as input to the model.

### Configure the Sample Code Project

Before you run the sample code project in Xcode:

- Make sure your Mac is running macOS 10.15 or later.
- Make sure you are running Xcode 11 or later.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)