Repolode
huggingface

huggingface/datasets

Biblioteca Python da Hugging Face para carregar datasets públicos de IA do Hub com uma linha e pré-processá-los com eficiência usando ferramentas baseadas em Arrow.

Estrelas
22,076
Forks
3,549
Issues abertas
1,529
Último commit
anteontem

O que é?

Datasets é uma biblioteca leve com duas funções principais. Ela oferece carregadores de uma linha para muitos datasets públicos hospedados no Hugging Face Hub, incluindo dados de texto, imagem, áudio, vídeo, PDF e dados médicos NIfTI, e os disponibiliza prontos para fluxos de trabalho com NumPy, Pandas, PyTorch, TensorFlow, JAX ou Polars. Também oferece ferramentas de pré-processamento para datasets do Hub e arquivos locais em formatos como CSV, JSON, Parquet, XML, WAV, JPEG e PDF.

Os datasets são armazenados com Apache Arrow e memory mapping, então grandes volumes de dados não precisam caber na RAM. Operações como map() podem ser executadas em paralelo com num_proc, e os resultados processados são armazenados em cache e reutilizados. O modo de streaming percorre dados remotos sem baixá-los por completo, o que é adequado para datasets maiores do que o espaço em disco local.

A biblioteca também oferece suporte à leitura e gravação em Hugging Face Storage Buckets, ao carregamento de traces de agentes de IA e à criação de índices FAISS ou Elasticsearch para busca por similaridade.

Recursos principais

  • 01Carrega datasets do Hub com uma única chamada a load_dataset()
  • 02O modo de streaming percorre dados remotos sem baixá-los por completo
  • 03O armazenamento com Apache Arrow e memory mapping mantém datasets grandes fora da RAM
  • 04Processamento paralelo com map() e cache automático dos resultados
  • 05Lê arquivos CSV, JSON, Parquet, XML, texto e multimídia, incluindo áudio, imagem, vídeo, PDF e NIfTI
  • 06Converte para os formatos NumPy, Pandas, Polars, PyTorch, TensorFlow e JAX

Casos de uso

  • Ajustar ou avaliar um modelo de NLP com um dataset público de benchmark
  • Fazer streaming de um corpus muito grande de imagens ou fala durante o treinamento
  • Pré-processar e tokenizar dados locais em CSV ou Parquet para treinar modelos
  • Criar um índice de busca por similaridade sobre embeddings com FAISS

Início rápido

  1. 1

    Instale a biblioteca com pip

    pip install datasets
  2. 2

    Carregue um conjunto de dados do Hub em Python

    python -c "from datasets import load_dataset; squad_dataset = load_dataset('rajpurkar/squad'); print(squad_dataset['train'][0])"

Antes de usar

  • Alguns recursos precisam de extras opcionais, como suporte a áudio, visão, PDF ou NIfTI.
  • Muitos conjuntos de dados do Hub são fornecidos por terceiros, então as licenças e os termos variam de acordo com cada conjunto.

Tópicos

Perguntas frequentes

O que é datasets?
Biblioteca Python da Hugging Face para carregar datasets públicos de IA do Hub com uma linha e pré-processá-los com eficiência usando ferramentas baseadas em Arrow. Datasets é uma biblioteca leve com duas funções principais. Ela oferece carregadores de uma linha para muitos datasets públicos hospedados no Hugging Face Hub, incluindo dados de texto, imagem, áudio, vídeo, PDF e dados médicos NIfTI, e os disponibiliza prontos para fluxos de trabalho com NumPy, Pandas, PyTorch, TensorFlow, JAX ou Polars. Também oferece ferramentas de pré-processamento para datasets do Hub e arquivos locais em formatos como CSV, JSON, Parquet, XML, WAV, JPEG e PDF.
datasets é gratuito? Qual é a licença?
datasets é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
datasets ainda é mantido?
Manutenção ativa. O último commit de datasets foi em 19 de out. de 2026.
Para que posso usar datasets?
Ajustar ou avaliar um modelo de NLP com um dataset público de benchmark Fazer streaming de um corpus muito grande de imagens ou fala durante o treinamento Pré-processar e tokenizar dados locais em CSV ou Parquet para treinar modelos Criar um índice de busca por similaridade sobre embeddings com FAISS
Como instalar datasets?
Instale a biblioteca com pip: pip install datasets Carregue um conjunto de dados do Hub em Python: python -c "from datasets import load_dataset; squad_dataset = load_dataset('rajpurkar/squad'); print(squad_dataset['train'][0])"
Onde consigo datasets?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/huggingface/datasets

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados