hugging-face-dataset-viewer

Query Hugging Face datasets via the Dataset Viewer API for metadata, rows, and statistics.

1|Updated Feb 20, 2026

Search Tags:#api #exploration #filters #pagination #parquet #dataset #huggingface

Ready to run

npx skills add https://github.com/BlackRoad-OS-Inc/blackroad-operator --skill hugging-face-dataset-viewer-blackroad-os-inc

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: hugging-face-dataset-viewer
Source: https://github.com/BlackRoad-OS-Inc/blackroad-operator/tree/main/agents/skills/skills/hugging-face-dataset-viewer
Command: npx skills add https://github.com/BlackRoad-OS-Inc/blackroad-operator --skill hugging-face-dataset-viewer-blackroad-os-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reading, filtering, and paginating large Hugging Face datasets can be tedious and error-prone across multiple endpoints.

Core Features & Use Cases

Fetch subset and split metadata with ease from the Dataset Viewer API.
Paginate rows, search text, and apply predicates to surface only relevant records.
Retrieve parquet links and size/statistics metadata for quick data profiling and export.

Quick Start

Explore a dataset by asking for an initial dataset overview, including splits and a sample of rows.

Frequently Asked Questions about hugging-face-dataset-viewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I fetch metadata and initial rows from a Hugging Face dataset?▼

You can fetch Hugging Face dataset metadata and initial rows by querying the Dataset Viewer API, which returns subset configurations, split information, and paginated records via GET-based calls.

Can I search text and apply predicates to filter Hugging Face dataset rows?▼

Yes, you can search text and apply predicates to filter Hugging Face dataset rows, allowing you to surface only the relevant records matching specific conditions during your exploration.

How do I retrieve parquet links and size statistics for Hugging Face datasets?▼

You retrieve parquet links and dataset size statistics by querying the Dataset Viewer API, enabling quick data profiling and direct export of the underlying parquet files for analysis.

Do I need an Authorization Bearer token to access gated Hugging Face datasets?▼

Yes, accessing gated Hugging Face datasets requires an Authorization Bearer token. Public datasets can be explored using standard GET-based calls without authentication.

What's the best way to paginate through large Hugging Face datasets?▼

The best way to paginate large Hugging Face datasets is using the Dataset Viewer API, which supports fetching rows in sequential pages while applying text search and predicates to manage result sets.

Does the Hugging Face dataset viewer work with private or gated datasets?▼

The Hugging Face dataset viewer works with gated datasets when you provide an Authorization Bearer token. Public datasets are fully accessible using standard unauthenticated GET requests.