Skip to content

Commit

Permalink
Deploying to gh-pages from @ f6aaf8c 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
facebook-github-bot committed Sep 24, 2024
1 parent cb05b51 commit 38d24da
Show file tree
Hide file tree
Showing 36 changed files with 3,008 additions and 243 deletions.
2 changes: 1 addition & 1 deletion .buildinfo
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: c7cfa05cef58bf6212c299d2f4a9bc0d
config: 056852aeaac34df778122e20bd92a506
tags: 645f666f9bcd5a90fca523b33c5a78b7
13 changes: 13 additions & 0 deletions _images/card-background.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
94 changes: 71 additions & 23 deletions _sources/index.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,30 +3,85 @@
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
.. meta::
:description: TorchRec documentation homepage
:keywords: recommendation systems, sharding, distributed training

Welcome to the TorchRec documentation!
======================================

TorchRec is a PyTorch domain library built to provide common
sparsity & parallelism primitives needed for large-scale recommender
systems (RecSys). It allows authors to train models with large
embedding tables sharded across many GPUs.
TorchRec is a specialized library within the PyTorch ecosystem,
tailored for building, scaling, and deploying large-scale
**recommendation systems**, a niche not directly addressed by standard
PyTorch. TorchRec offers advanced features such as complex sharding
techniques for massive embedding tables, and enhanced distributed
training capabilities.

Getting Started
---------------

Topics in this section will help you get started with TorchRec.

.. grid:: 3

.. grid-item-card:: :octicon:`file-code;1em`
TorchRec Overview
:img-top: _static/img/card-background.svg
:link: overview.html
:link-type: url

A short intro to TorchRec and why you need it.

.. grid-item-card:: :octicon:`file-code;1em`
Set up TorchRec
:img-top: _static/img/card-background.svg
:link: setup-torchrec.html
:link-type: url

Learn how to install and start using TorchRec
in your environment.

.. grid-item-card:: :octicon:`file-code;1em`
Getting Started with TorchRec Tutorial
:img-top: _static/img/card-background.svg
:link: https://colab.research.google.com/github/pytorch/torchrec/blob/main/Torchrec_Introduction.ipynb
:link-type: url

Follow our interactive step-by-step tutorial
to learn how to use TorchRec in a real-life
example.

For installation instructions, visit

https://github.com/pytorch/torchrec#readme

Tutorial
--------
In this tutorial, we introduce the primary torchRec
API called DistributedModelParallel, or DMP.
Like pytorch’s DistributedDataParallel,
DMP wraps a model to enable distributed training.
How to Contribute
-----------------

* `Tutorial Source <https://github.com/pytorch/torchrec/blob/main/Torchrec_Introduction.ipynb>`_
* Open in `Google Colab <https://colab.research.google.com/github/pytorch/torchrec/blob/main/Torchrec_Introduction.ipynb>`_
We welcome contributions and feedback from the PyTorch community!
If you are interested in helping improve the TorchRec project, here is
how you can contribute:

1. **Visit Our** `GitHub Repository <https://github.com/pytorch/torchrec>`__:
There yoou can find the source code, issues, and ongoing projects.

1. **Submit Feedback or Issues**: If you encounter any bugs or have
suggestions for improvements, please submit an issue through the
`GitHub issue tracker <https://github.com/pytorch/torchrec/issues>`__.

1. **Propose changes**: Fork the repository and submit pull requests.
Whether it's fixing a bug, adding new features, or improving
documentation, your contributions are always welcome! Please make sure to
review our `CONTRIBUTING.md <https://github.com/pytorch/torchrec/blob/main/CONTRIBUTING.md>`__

|
|
.. container:: center-content

.. button-link:: https://github.com/pytorch/torchrec
:color: info

:octicon:`mark-github` Go to TorchRec Repo

TorchRec API
------------

.. toctree::
:maxdepth: 1
Expand All @@ -53,10 +108,3 @@ TorchRec API
torchrec.quant.rst
torchrec.sparse.rst
torchrec.metrics.rst

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

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

Large diffs are not rendered by default.

27 changes: 27 additions & 0 deletions _sphinx_design_static/design-tabs.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
var sd_labels_by_text = {};

function ready() {
const li = document.getElementsByClassName("sd-tab-label");
for (const label of li) {
syncId = label.getAttribute("data-sync-id");
if (syncId) {
label.onclick = onLabelClick;
if (!sd_labels_by_text[syncId]) {
sd_labels_by_text[syncId] = [];
}
sd_labels_by_text[syncId].push(label);
}
}
}

function onLabelClick() {
// Activate other inputs with the same sync id.
syncId = this.getAttribute("data-sync-id");
for (label of sd_labels_by_text[syncId]) {
if (label === this) continue;
label.previousElementSibling.checked = true;
}
window.localStorage.setItem("sphinx-design-last-tab", syncId);
}

document.addEventListener("DOMContentLoaded", ready, false);
4 changes: 4 additions & 0 deletions _static/check-solid.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
7 changes: 7 additions & 0 deletions _static/clipboard.min.js

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

5 changes: 5 additions & 0 deletions _static/copy-button.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
94 changes: 94 additions & 0 deletions _static/copybutton.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
/* Copy buttons */
button.copybtn {
position: absolute;
display: flex;
top: .3em;
right: .3em;
width: 1.7em;
height: 1.7em;
opacity: 0;
transition: opacity 0.3s, border .3s, background-color .3s;
user-select: none;
padding: 0;
border: none;
outline: none;
border-radius: 0.4em;
/* The colors that GitHub uses */
border: #1b1f2426 1px solid;
background-color: #f6f8fa;
color: #57606a;
}

button.copybtn.success {
border-color: #22863a;
color: #22863a;
}

button.copybtn svg {
stroke: currentColor;
width: 1.5em;
height: 1.5em;
padding: 0.1em;
}

div.highlight {
position: relative;
}

/* Show the copybutton */
.highlight:hover button.copybtn, button.copybtn.success {
opacity: 1;
}

.highlight button.copybtn:hover {
background-color: rgb(235, 235, 235);
}

.highlight button.copybtn:active {
background-color: rgb(187, 187, 187);
}

/**
* A minimal CSS-only tooltip copied from:
* https://codepen.io/mildrenben/pen/rVBrpK
*
* To use, write HTML like the following:
*
* <p class="o-tooltip--left" data-tooltip="Hey">Short</p>
*/
.o-tooltip--left {
position: relative;
}

.o-tooltip--left:after {
opacity: 0;
visibility: hidden;
position: absolute;
content: attr(data-tooltip);
padding: .2em;
font-size: .8em;
left: -.2em;
background: grey;
color: white;
white-space: nowrap;
z-index: 2;
border-radius: 2px;
transform: translateX(-102%) translateY(0);
transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1);
}

.o-tooltip--left:hover:after {
display: block;
opacity: 1;
visibility: visible;
transform: translateX(-100%) translateY(0);
transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1);
transition-delay: .5s;
}

/* By default the copy button shouldn't show up when printing a page */
@media print {
button.copybtn {
display: none;
}
}
Loading

0 comments on commit 38d24da

Please sign in to comment.