==================
 MiniTorch |logo|
==================

.. |logo| image:: match.png
           :width: 40pt


Welcome to MiniTorch! (https://github.com/minitorch/minitorch.github.io)

MiniTorch is a *teaching library* for machine learning engineers who
wish to learn about the internal concepts underlying deep learning
systems.  Specifically, it is a pure Python re-implementation of the
`Torch <http://www.pytorch.org>`_ API designed to be simple,
easy-to-read, tested, and incremental. The final library can run Torch
code with minimal changes (at some efficiency cost). The project was
developed for the course `Machine Learning Engineering` at Cornell
Tech.


MiniTorch is strictly *DIY*. It is not a library, per se, but a
series of practically-oriented modules. These modules aim to provide
the user with guidance on re-building the codebase by themselves, through
a series of incremental implementations. These implementations can be
done with a course or by an interested learner.

To get started, first read :doc:`setup` and :doc:`contributing` to
build your workspace.  Then follow through each of the modules to the
right. Minimal computational resources are required.
Module starting code is available on GitHub, and each proceeds
incrementally from past modules.

Enjoy!

Sasha Rush (`@srush_nlp <https://twitter.com/srush_nlp>`_) and Ge Gao



:doc:`module0`
--------------

.. image:: figs/Module/module.png
           :align: center

:doc:`module1`
--------------

.. image:: figs/Autograd/backprop4.png
           :align: center


:doc:`module2`
--------------

.. image:: figs/Tensors/stride4.png
           :align: center



:doc:`module3`
--------------

.. image:: figs/gpu/threadid@3x.png
           :align: center


:doc:`module4`
--------------

.. image:: figs/mnist/orig.png
           :width: 400px
           :align: center
.. image:: figs/mnist/mnist2.png
           :width: 400px
           :align: center

.. image:: figs/mnist/mnist5.png
           :width: 400px
           :align: center

.. image:: figs/mnist/mnist4.png
           :width: 400px
           :align: center



.. toctree::
   :maxdepth: 1
   :glob:
   :caption: Contents

   setup
   contributing
   mlprimer
   module0
   module1
   module2
   module3
   module4



Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`