AI-Hypercomputer / AI-Hypercomputer/maxtext

Regression: HF JSONL training halts early with

Open
#2,147 4 comments 0 reactions 1 assignee Claimed by @aireenmei View on GitHub
bug
Dominant language
Python
Stars
2.4k
Forks
607
Avg merge
2d 19h
Merged PRs (30d)
158

Description

### Bug report

@aireenmei

I keep getting an error related to running out of shards. Training is halted early, and gives the error:
“Run out of shards on host 0, shard 256 is not available”
followed by StopIteration → “You may have run out of training data.”

Setup:
- MaxText @ main (Aug 2025)
- TPU v5-32 (8 hosts)
- dataset_type=hf, streaming JSONL from GCS
- 256 shards matched by: hf_train_files='gs://mybucket/train*.jsonl'
(files named train_aa.jsonl … train_jo.jsonl)
- Command: `python -m MaxText.train ... hf_path=json hf_data_dir= hf_train_files='gs://…/train*.jsonl' ...`

I think this is a regression, because earlier this did run until none of the workers had any data.

### Logs/Output

_No response_

### Environment Information

_No response_

### Additional Context

_No response_

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.