{"author":"PyTorch Team","author_email":"packages@pytorch.org","bugtrack_url":null,"classifiers":["Intended Audience :: Developers","Intended Audience :: Science/Research","License :: OSI Approved :: BSD License","Operating System :: MacOS :: MacOS X","Operating System :: Microsoft :: Windows","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.13","Programming Language :: Python :: 3.9","Programming Language :: Python :: Implementation :: CPython","Topic :: Scientific/Engineering :: Artificial Intelligence"],"description":"# TorchData (see note below on current status)\n\n[**What is TorchData?**](#what-is-torchdata) | [**Stateful DataLoader**](#stateful-dataloader) |\n[**Install guide**](#installation) | [**Contributing**](#contributing) | [**License**](#license)\n\n**:warning: June 2024 Status Update: Removing DataPipes and DataLoader V2**\n\n**We are re-focusing the torchdata repo to be an iterative enhancement of torch.utils.data.DataLoader. We do not plan on\ncontinuing development or maintaining the [`DataPipes`] and [`DataLoaderV2`] solutions, and they will be removed from\nthe torchdata repo. We'll also be revisiting the `DataPipes` references in pytorch/pytorch. In release\n`torchdata==0.8.0` (July 2024) they will be marked as deprecated, and sometime after 0.9.0 (Oct 2024) they will be\ndeleted. Existing users are advised to pin to `torchdata==0.9.0` or an older version until they are able to migrate\naway. Subsequent releases will not include DataPipes or DataLoaderV2. The old version of this README is\n[available here](https://github.com/pytorch/data/blob/v0.7.1/README.md). Please reach out if you suggestions or comments\n(please use [#1196](https://github.com/pytorch/data/issues/1196) for feedback).**\n\n##\n\n## What is TorchData?\n\nThe TorchData project is an iterative enhancement to the PyTorch torch.utils.data.DataLoader and\ntorch.utils.data.Dataset/IterableDataset to make them scalable, performant dataloading solutions. We will be iterating\non the enhancements under [the torchdata repo](torchdata).\n\nOur first change begins with adding checkpointing to torch.utils.data.DataLoader, which can be found in\n[stateful_dataloader, a drop-in replacement for torch.utils.data.DataLoader](torchdata/stateful_dataloader), by defining\n`load_state_dict` and `state_dict` methods that enable mid-epoch checkpointing, and an API for users to track custom\niteration progress, and other custom states from the dataloader workers such as token buffers and/or RNG states.\n\n## Stateful DataLoader\n\n`torchdata.stateful_dataloader.StatefulDataLoader` is a drop-in replacement for torch.utils.data.DataLoader which\nprovides state_dict and load_state_dict functionality. See\n[the Stateful DataLoader main page](torchdata/stateful_dataloader) for more information and examples. Also check out the\nexamples\n[in this Colab notebook](https://colab.research.google.com/drive/1tonoovEd7Tsi8EW8ZHXf0v3yHJGwZP8M?usp=sharing).\n\n## torchdata.nodes\n\ntorchdata.nodes is a library of composable iterators (not iterables!) that let you chain together common dataloading and\npre-proc operations. It follows a streaming programming model, although \"sampler + Map-style\" can still be configured if\nyou desire. See [torchdata.nodes main page](torchdata/nodes) for more details. Stay tuned for tutorial on\ntorchdata.nodes coming soon!\n\n## Installation\n\n### Version Compatibility\n\nThe following is the corresponding `torchdata` versions and supported Python versions.\n\n| `torch` | `torchdata` | `python` |\n| -------------------- | ------------------ | ----------------- |\n| `master` / `nightly` | `main` / `nightly` | `>=3.9`, `<=3.13` |\n| `2.6.0` | `0.11.0` | `>=3.9`, `<=3.13` |\n| `2.5.0` | `0.10.0` | `>=3.9`, `<=3.12` |\n| `2.5.0` | `0.9.0` | `>=3.9`, `<=3.12` |\n| `2.4.0` | `0.8.0` | `>=3.8`, `<=3.12` |\n| `2.0.0` | `0.6.0` | `>=3.8`, `<=3.11` |\n| `1.13.1` | `0.5.1` | `>=3.7`, `<=3.10` |\n| `1.12.1` | `0.4.1` | `>=3.7`, `<=3.10` |\n| `1.12.0` | `0.4.0` | `>=3.7`, `<=3.10` |\n| `1.11.0` | `0.3.0` | `>=3.7`, `<=3.10` |\n\n### Local pip or conda\n\nFirst, set up an environment. We will be installing a PyTorch binary as well as torchdata. If you're using conda, create\na conda environment:\n\n```bash\nconda create --name torchdata\nconda activate torchdata\n```\n\nIf you wish to use `venv` instead:\n\n```bash\npython -m venv torchdata-env\nsource torchdata-env/bin/activate\n```\n\nInstall torchdata:\n\nUsing pip:\n\n```bash\npip install torchdata\n```\n\nUsing conda:\n\n```bash\nconda install -c pytorch torchdata\n```\n\n### From source\n\n```bash\npip install .\n```\n\nIn case building TorchData from source fails, install the nightly version of PyTorch following the linked guide on the\n[contributing page](CONTRIBUTING.md#install-pytorch-nightly).\n\n### From nightly\n\nThe nightly version of TorchData is also provided and updated daily from main branch.\n\nUsing pip:\n\n```bash\npip install --pre torchdata --index-url https://download.pytorch.org/whl/nightly/cpu\n```\n\nUsing conda:\n\n```bash\nconda install torchdata -c pytorch-nightly\n```\n\n## Contributing\n\nWe welcome PRs! See the [CONTRIBUTING](CONTRIBUTING.md) file.\n\n## Beta Usage and Feedback\n\nWe'd love to hear from and work with early adopters to shape our designs. Please reach out by raising an issue if you're\ninterested in using this tooling for your project.\n\n## License\n\nTorchData is BSD licensed, as found in the [LICENSE](LICENSE) file.\n","description_content_type":"text/markdown","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":["Author","Author-Email","Classifier","Description","Description-Content-Type","Home-Page","License","Requires-Dist","Requires-Python","Summary"],"home_page":"https://github.com/pytorch/data","keywords":null,"license":"BSD","license_expression":null,"license_files":null,"maintainer":null,"maintainer_email":null,"name":"torchdata","package_url":"https://pypi.org/project/torchdata/","platform":null,"project_url":"https://pypi.org/project/torchdata/","project_urls":{"Homepage":"https://github.com/pytorch/data"},"provides_extra":null,"release_url":"https://pypi.org/project/torchdata/0.11.0/","requires_dist":["urllib3>=1.25","requests","torch>=2"],"requires_python":">=3.9","summary":"Composable data loading modules for PyTorch","version":"0.11.0","yanked":false,"yanked_reason":null}

Dependencies of torchdata (3).
Dependency	Optional
requests	false
torch	false
urllib3	false

Package search

torchdata

project_urls

Dependencies

All package metadata

Releases