Skip to content

Dataset Viewer fails on TSFile datasets #8256

Description

@gengziyand

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:

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:

ModuleNotFoundError: No module named 'tsfile'

The error originates from the TSFile dataset loader:

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:

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

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>

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions