Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pytorch/data
A PyTorch repo for data loading and utilities to be shared by the PyTorch domain libraries.
https://github.com/pytorch/data
Last synced: 16 days ago
JSON representation
A PyTorch repo for data loading and utilities to be shared by the PyTorch domain libraries.
- Host: GitHub
- URL: https://github.com/pytorch/data
- Owner: pytorch
- License: bsd-3-clause
- Created: 2021-05-12T20:55:29.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T21:24:08.000Z (6 months ago)
- Last Synced: 2024-05-23T02:12:42.283Z (6 months ago)
- Language: Python
- Homepage:
- Size: 22.1 MB
- Stars: 1,071
- Watchers: 36
- Forks: 140
- Open Issues: 221
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# TorchData (see note below on current status)
[**What is TorchData?**](#what-is-torchdata) | [**Stateful DataLoader**](#stateful-dataloader) |
[**Install guide**](#installation) | [**Contributing**](#contributing) | [**License**](#license)
**:warning: June 2024 Status Update: Removing DataPipes and DataLoader V2**
**We are re-focusing the torchdata repo to be an iterative enhancement of torch.utils.data.DataLoader. We do not plan on
continuing development or maintaining the [`DataPipes`] and [`DataLoaderV2`] solutions, and they will be removed from
the torchdata repo. We'll also be revisiting the `DataPipes` references in pytorch/pytorch. In release
`torchdata==0.8.0` (July 2024) they will be marked as deprecated, and sometime after 0.9.0 (Oct 2024) they will be
deleted. Existing users are advised to pin to `torchdata==0.9.0` or an older version until they are able to migrate
away. Subsequent releases will not include DataPipes or DataLoaderV2. The old version of this README is
[available here](https://github.com/pytorch/data/blob/v0.7.1/README.md). Please reach out if you suggestions or comments
(please use [#1196](https://github.com/pytorch/data/issues/1196) for feedback).**
##
## What is TorchData?
The TorchData project is an iterative enhancement to the PyTorch torch.utils.data.DataLoader and
torch.utils.data.Dataset/IterableDataset to make them scalable, performant dataloading solutions. We will be iterating
on the enhancements under [the torchdata repo](torchdata).
Our first change begins with adding checkpointing to torch.utils.data.DataLoader, which can be found in
[stateful_dataloader, a drop-in replacement for torch.utils.data.DataLoader](torchdata/stateful_dataloader), by defining
`load_state_dict` and `state_dict` methods that enable mid-epoch checkpointing, and an API for users to track custom
iteration progress, and other custom states from the dataloader workers such as token buffers and/or RNG states.
## Stateful DataLoader
`torchdata.stateful_dataloader.StatefulDataLoader` is a drop-in replacement for torch.utils.data.DataLoader which
provides state_dict and load_state_dict functionality. See
[the Stateful DataLoader main page](torchdata/stateful_dataloader) for more information and examples. Also check out the
examples
[in this Colab notebook](https://colab.research.google.com/drive/1tonoovEd7Tsi8EW8ZHXf0v3yHJGwZP8M?usp=sharing).
## Installation
### Version Compatibility
The following is the corresponding `torchdata` versions and supported Python versions.
| `torch` | `torchdata` | `python` |
| -------------------- | ------------------ | ----------------- |
| `master` / `nightly` | `main` / `nightly` | `>=3.9`, `<=3.12` |
| `2.5.0` | `0.9.0` | `>=3.9`, `<=3.12` |
| `2.4.0` | `0.8.0` | `>=3.8`, `<=3.12` |
| `2.0.0` | `0.6.0` | `>=3.8`, `<=3.11` |
| `1.13.1` | `0.5.1` | `>=3.7`, `<=3.10` |
| `1.12.1` | `0.4.1` | `>=3.7`, `<=3.10` |
| `1.12.0` | `0.4.0` | `>=3.7`, `<=3.10` |
| `1.11.0` | `0.3.0` | `>=3.7`, `<=3.10` |
### Local pip or conda
First, set up an environment. We will be installing a PyTorch binary as well as torchdata. If you're using conda, create
a conda environment:
```bash
conda create --name torchdata
conda activate torchdata
```
If you wish to use `venv` instead:
```bash
python -m venv torchdata-env
source torchdata-env/bin/activate
```
Install torchdata:
Using pip:
```bash
pip install torchdata
```
Using conda:
```bash
conda install -c pytorch torchdata
```
### From source
```bash
pip install .
```
In case building TorchData from source fails, install the nightly version of PyTorch following the linked guide on the
[contributing page](CONTRIBUTING.md#install-pytorch-nightly).
### From nightly
The nightly version of TorchData is also provided and updated daily from main branch.
Using pip:
```bash
pip install --pre torchdata --index-url https://download.pytorch.org/whl/nightly/cpu
```
Using conda:
```bash
conda install torchdata -c pytorch-nightly
```
## Contributing
We welcome PRs! See the [CONTRIBUTING](CONTRIBUTING.md) file.
## Beta Usage and Feedback
We'd love to hear from and work with early adopters to shape our designs. Please reach out by raising an issue if you're
interested in using this tooling for your project.
## License
TorchData is BSD licensed, as found in the [LICENSE](LICENSE) file.