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

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions