Skip to content

Commit

Permalink
Bump file chunk recommendation to 15GB
Browse files Browse the repository at this point in the history
  • Loading branch information
Wauplin committed Aug 14, 2024
1 parent d5b6178 commit b0091bb
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions docs/hub/repositories-recommendations.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ We gathered a list of tips and recommendations for structuring your repo. If you
| Repo size | - | contact us for large repos (TBs of data) |
| Files per repo | <100k | merge data into fewer files |
| Entries per folder | <10k | use subdirectories in repo |
| File size | <5GB | split data into chunked files |
| File size | <15GB | split data into chunked files |
| Commit size | <100 files* | upload files in multiple commits |
| Commits per repo | - | upload multiple files per commit and/or squash history |

Expand All @@ -37,7 +37,7 @@ which has very detailed documentation about the different factors that will impa
For example, json files can be merged into a single jsonl file, or large datasets can be exported as Parquet files or in [WebDataset](https://github.com/webdataset/webdataset) format.
- The maximum number of files per folder cannot exceed 10k files per folder. A simple solution is to
create a repository structure that uses subdirectories. For example, a repo with 1k folders from `000/` to `999/`, each containing at most 1000 files, is already enough.
- **File size**: In the case of uploading large files (e.g. model weights), we strongly recommend splitting them **into chunks of around 5GB each**.
- **File size**: In the case of uploading large files (e.g. model weights), we strongly recommend splitting them **into chunks of around 15GB each**.
There are a few reasons for this:
- Uploading and downloading smaller files is much easier both for you and the other users. Connection issues can always
happen when streaming data and smaller files avoid resuming from the beginning in case of errors.
Expand Down

0 comments on commit b0091bb

Please sign in to comment.