huggingface / huggingface/datasets

Dataset Viewer fails on TSFile datasets

Open
#8,256 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
22k
Forks
3.4k
Avg merge
5d 7h
Merged PRs (30d)
17

Description

### Describe the bug

## Description

The Dataset Viewer fails when trying to display a dataset stored in TSFile format.

The error shown by the viewer is:

```python
ModuleNotFoundError: No module named 'tsfile'

### Steps to reproduce the bug

# Dataset Viewer fails to load TSFile dataset due to missing `tsfile` dependency

## Dataset

Dataset URL:

https://huggingface.co/datasets/smilegeng/pusht

## Description

The dataset is uploaded successfully, but the Dataset Viewer cannot display it.

The viewer reports:

```text
SplitsNotFoundError: The split names could not be parsed from the dataset config.
```

After inspecting the traceback, the actual root cause appears to be a missing dependency:

```text
ModuleNotFoundError: No module named 'tsfile'
```

The error originates from the TSFile dataset loader:

```text
File "/usr/local/lib/python3.12/site-packages/datasets/packaged_modules/tsfile/tsfile.py", line 304, in _scan_metadata
from tsfile.constants import TIME_COLUMN, ColumnCategory

ModuleNotFoundError: No module named 'tsfile'
```

This exception is then wrapped into:

```text
datasets.inspect.SplitsNotFoundError:
The split names could not be parsed from the dataset config.
```

## Expected Behavior

The Dataset Viewer should either:

1. Support TSFile datasets by installing the required `tsfile` dependency, or
2. Return a clearer error message indicating that the dependency is unavailable.

## Full Traceback

```text
Exception: SplitsNotFoundError
Message: The split names could not be parsed from the dataset config.

Traceback:
...
ModuleNotFoundError: No module named 'tsfile'
...
datasets.inspect.SplitsNotFoundError:
The split names could not be parsed from the dataset config.
```

### Expected behavior

The Dataset Viewer should support TSFile datasets.

### Environment info

D:\huggingface_to_tsfile>datasets-cli env

Copy-and-paste the text below in your GitHub issue.

- `datasets` version: 5.0.0
- Platform: Windows-11-10.0.26200-SP0
- Python version: 3.14.0
- `huggingface_hub` version: 1.7.2
- PyArrow version: 23.0.1
- Pandas version: 3.0.1
- `fsspec` version: 2026.2.0

D:\huggingface_to_tsfile>

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.