- Notifications
You must be signed in to change notification settings - Fork540
.NET Standard bindings for Google's TensorFlow for developing, training and deploying Machine Learning models in C# and F#.
License
SciSharp/TensorFlow.NET
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
TensorFlow.NET (TF.NET) provides a .NET Standard binding forTensorFlow. It aims to implement the complete Tensorflow API in C# which allows .NET developers to develop, train and deploy Machine Learning models with the cross-platform .NET Standard framework. TensorFlow.NET has built-in Keras high-level interface and is released as an independent packageTensorFlow.Keras.
English |中文
Important
We're happy that our work on tensorflow.net has attracted many users. However, at this time, none of the main maintainers of this repo is available for new features and bug fix. We won't refuse PRs and will help to review them.
If you would like to be a contributor or maintainer of tensorflow.net, we'd like to help you to start up.
We feel sorry for that and we'll resume the maintaining for this project once one of us has bandwidth for it.
master branch and v0.100.x is corresponding to tensorflow v2.10, v0.6x branch is from tensorflow v2.6, v0.15-tensorflow1.15 is from tensorflow1.15. Please addhttps://www.myget.org/F/scisharp/api/v3/index.json to nuget source to use nightly release.
SciSharp STACK's mission is to bring popular data science technology into the .NET world and to provide .NET developers with a powerful Machine Learning tool set without reinventing the wheel. Since the APIs are kept as similar as possible you can immediately adapt any existing TensorFlow code in C# or F# with a zero learning curve. Take a look at a comparison picture and see how comfortably a TensorFlow/Python script translates into a C# program with TensorFlow.NET.
SciSharp's philosophy allows a large number of machine learning code written in Python to be quickly migrated to .NET, enabling .NET developers to use cutting edge machine learning models and access a vast number of TensorFlow resources which would not be possible without this project.
In comparison to other projects, like for instanceTensorFlowSharp which only provide TensorFlow's low-level C++ API and can only run models that were built using Python, Tensorflow.NET makes it possible to build the pipeline of training and inference with pure C# and F#. Besides, Tensorflow.NET provides binding of Tensorflow.Keras to make it easy to transfer your code from python to .NET.
ML.NET also take Tensorflow.NET as one of the backends to train and infer your model, which provides better integration with .NET.
Introduction and simple examples：Tensorflow.NET Documents
Detailed documention：The Definitive Guide to Tensorflow.NET
Examples：TensorFlow.NET Examples
Troubleshooting of running example or installation：Tensorflow.NET FAQ
You can search the package name in NuGet Manager, or use the commands below in package manager console.
The installation contains two parts, the first is the main body:
### Install Tensorflow.NETPM> Install-Package TensorFlow.NET### Install Tensorflow.KerasPM> Install-Package TensorFlow.Keras
The second part is the computing support part. Only one of the following packages is needed, depending on your device and system.
### CPU version for Windows and LinuxPM> Install-Package SciSharp.TensorFlow.Redist### CPU version for MacOSPM> Install-Package SciSharp.TensorFlow.Redist-OSX### GPU version for Windows (CUDA and cuDNN are required)PM> Install-Package SciSharp.TensorFlow.Redist-Windows-GPU### GPU version for Linux (CUDA and cuDNN are required)PM> Install-Package SciSharp.TensorFlow.Redist-Linux-GPUTwo simple examples are given here to introduce the basic usage of Tensorflow.NET. As you can see, it's easy to write C# code just like that in Python.
usingstaticTensorflow.Binding;usingstaticTensorflow.KerasApi;usingTensorflow;usingTensorflow.NumPy;// Parametersvartraining_steps=1000;varlearning_rate=0.01f;vardisplay_step=100;// Sample datavarX=np.array(3.3f,4.4f,5.5f,6.71f,6.93f,4.168f,9.779f,6.182f,7.59f,2.167f,7.042f,10.791f,5.313f,7.997f,5.654f,9.27f,3.1f);varY=np.array(1.7f,2.76f,2.09f,3.19f,1.694f,1.573f,3.366f,2.596f,2.53f,1.221f,2.827f,3.465f,1.65f,2.904f,2.42f,2.94f,1.3f);varn_samples=X.shape[0];// We can set a fixed init value in order to demovarW=tf.Variable(-0.06f,name:"weight");varb=tf.Variable(-0.73f,name:"bias");varoptimizer=keras.optimizers.SGD(learning_rate);// Run training for the given number of steps.foreach(varstepinrange(1,training_steps+1)){// Run the optimization to update W and b values.// Wrap computation inside a GradientTape for automatic differentiation.usingvarg=tf.GradientTape();// Linear regression (Wx + b).varpred=W*X+b;// Mean square error.varloss=tf.reduce_sum(tf.pow(pred-Y,2))/(2*n_samples);// should stop recording// Compute gradients.vargradients=g.gradient(loss,(W,b));// Update W and b following gradients.optimizer.apply_gradients(zip(gradients,(W,b)));if(step%display_step==0){pred=W*X+b;loss=tf.reduce_sum(tf.pow(pred-Y,2))/(2*n_samples);print($"step:{step}, loss:{loss.numpy()}, W:{W.numpy()}, b:{b.numpy()}");}}
Run this example inJupyter Notebook.
usingstaticTensorflow.Binding;usingstaticTensorflow.KerasApi;usingTensorflow;usingTensorflow.NumPy;varlayers=keras.layers;// input layervarinputs=keras.Input(shape:(32,32,3),name:"img");// convolutional layervarx=layers.Conv2D(32,3,activation:"relu").Apply(inputs);x=layers.Conv2D(64,3,activation:"relu").Apply(x);varblock_1_output=layers.MaxPooling2D(3).Apply(x);x=layers.Conv2D(64,3,activation:"relu",padding:"same").Apply(block_1_output);x=layers.Conv2D(64,3,activation:"relu",padding:"same").Apply(x);varblock_2_output=layers.Add().Apply(newTensors(x,block_1_output));x=layers.Conv2D(64,3,activation:"relu",padding:"same").Apply(block_2_output);x=layers.Conv2D(64,3,activation:"relu",padding:"same").Apply(x);varblock_3_output=layers.Add().Apply(newTensors(x,block_2_output));x=layers.Conv2D(64,3,activation:"relu").Apply(block_3_output);x=layers.GlobalAveragePooling2D().Apply(x);x=layers.Dense(256,activation:"relu").Apply(x);x=layers.Dropout(0.5f).Apply(x);// output layervaroutputs=layers.Dense(10).Apply(x);// build keras modelvarmodel=keras.Model(inputs,outputs,name:"toy_resnet");model.summary();// compile keras model in tensorflow static graphmodel.compile(optimizer:keras.optimizers.RMSprop(1e-3f),loss:keras.losses.SparseCategoricalCrossentropy(from_logits:true),metrics:new[]{"acc"});// prepare datasetvar((x_train,y_train),(x_test,y_test))=keras.datasets.cifar10.load_data();// normalize the inputx_train=x_train/255.0f;// trainingmodel.fit(x_train[newSlice(0,2000)],y_train[newSlice(0,2000)],batch_size:64,epochs:10,validation_split:0.2f);// save the modelmodel.save("./toy_resnet_model");
The F# example for linear regression is availablehere.
More adcanced examples could be found inTensorFlow.NET Examples.
| TensorFlow.NET Versions | tensorflow 1.14, cuda 10.0 | tensorflow 1.15, cuda 10.0 | tensorflow 2.3, cuda 10.1 | tensorflow 2.4, cuda 11 | tensorflow 2.7, cuda 11 | tensorflow 2.10, cuda 11 |
|---|---|---|---|---|---|---|
| tf.net 0.10x, tf.keras 0.10 | x | |||||
| tf.net 0.7x, tf.keras 0.7 | x | |||||
| tf.net 0.4x, tf.keras 0.5 | x | |||||
| tf.net 0.3x, tf.keras 0.4 | x | |||||
| tf.net 0.2x | x | x | ||||
| tf.net 0.15 | x | x | ||||
| tf.net 0.14 | x |
tf.net 0.4x -> tf native 2.4 tf.net 0.6x -> tf native 2.6 tf.net 0.7x -> tf native 2.7tf.net 0.10x -> tf native 2.10...Feel like contributing to one of the hottest projects in the Machine Learning field? Want to know how Tensorflow magically creates the computational graph?
We appreciate every contribution however small! There are tasks for novices to experts alike, if everyone tackles only a small task the sum of contributions will be huge.
You can:
- Star Tensorflow.NET or share it with others
- Tell us about the missing APIs compared to Tensorflow
- Port Tensorflow unit tests from Python to C# or F#
- Port Tensorflow examples to C# or F# and raise issues if you come accross missing parts of the API or BUG
- Debug one of the unit tests that is marked as Ignored to get it to work
- Debug one of the not yet working examples and get it to work
- Help us to complete the documentions.
The best way to find out why a unit test is failing is to single step it in C# or F# and its corresponding Python at the same time to see where the flow of execution digresses or where variables exhibit different values. Good Python IDEs like PyCharm let you single step into the tensorflow library code.
Add SciSharp/TensorFlow.NET as upstream to your local repo ...
git remote add upstream git@github.com:SciSharp/TensorFlow.NET.gitPlease make sure you keep your fork up to date by regularly pulling from upstream.
git pull upstream masterBuy our book to make open source project be sustainableTensorFlow.NET实战
Join our chat onDiscord orGitter.
Follow us onTwitter,Facebook,Medium,LinkedIn.
TensorFlow.NET is a part ofSciSharp STACK
About
.NET Standard bindings for Google's TensorFlow for developing, training and deploying Machine Learning models in C# and F#.
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.