Transformers.js documentation

processors

You are viewing main version, which requires installation from source. If you'd like regular npm install, checkout the latest stable version (v3.0.0).
Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

processors

Processors are used to prepare inputs (e.g., text, image or audio) for a model.

Example: Using a WhisperProcessor to prepare an audio input for a model.

import { AutoProcessor, read_audio } from '@huggingface/transformers';

const processor = await AutoProcessor.from_pretrained('openai/whisper-tiny.en');
const audio = await read_audio('https://huggingface.co/datasets/Narsil/asr_dummy/resolve/main/mlk.flac', 16000);
const { input_features } = await processor(audio);
// Tensor {
//   data: Float32Array(240000) [0.4752984642982483, 0.5597258806228638, 0.56434166431427, ...],
//   dims: [1, 80, 3000],
//   type: 'float32',
//   size: 240000,
// }

processors.Processor

Represents a Processor that extracts features from an input.

Kind: static class of processors


new Processor(config, components)

Creates a new Processor with the given components

ParamType
configObject
componentsRecord.<string, Object>

processor.image_processor β‡’ <code> * </code>

Kind: instance property of Processor
Returns: * - The image processor of the processor, if it exists.


processor.tokenizer β‡’ <code> * </code>

Kind: instance property of Processor
Returns: * - The tokenizer of the processor, if it exists.


processor.feature_extractor β‡’ <code> * </code>

Kind: instance property of Processor
Returns: * - The feature extractor of the processor, if it exists.


processor._call(input, ...args) β‡’ <code> Promise. < any > </code>

Calls the feature_extractor function with the given input.

Kind: instance method of Processor
Returns: Promise.<any> - A Promise that resolves with the extracted features.

ParamTypeDescription
inputany

The input to extract features from.

...argsany

Additional arguments.


Processor.from_pretrained(pretrained_model_name_or_path, options) β‡’ <code> Promise. < Processor > </code>

Instantiate one of the processor classes of the library from a pretrained model.

The processor class to instantiate is selected based on the feature_extractor_type property of the config object (either passed as an argument or loaded from pretrained_model_name_or_path if possible)

Kind: static method of Processor
Returns: Promise.<Processor> - A new instance of the Processor class.

ParamTypeDescription
pretrained_model_name_or_pathstring

The name or path of the pretrained model. Can be either:

  • A string, the model id of a pretrained processor hosted inside a model repo on huggingface.co. Valid model ids can be located at the root-level, like bert-base-uncased, or namespaced under a user or organization name, like dbmdz/bert-base-german-cased.
  • A path to a directory containing processor files, e.g., ./my_model_directory/.
optionsPretrainedProcessorOptions

Additional options for loading the processor.


processors~PretrainedProcessorOptions : <code> Object </code>

Additional processor-specific properties.

Kind: inner typedef of processors


< > Update on GitHub