AutoModelForSequenceClassification

AutoModelForSequenceClassification

class transformers.AutoModelForSequenceClassification

<source>

( *args**kwargs )

This is a generic model class that will be instantiated as one of the model classes of the library (with a sequence classification head) when created with the from_pretrained() class method or the from_config() class method.

This class cannot be instantiated directly using __init__() (throws an error).

from_config

<source>

( **kwargs )

Parameters

• config (PretrainedConfig) — The model class to instantiate is selected based on the configuration class:

  • AlbertConfig configuration class: AlbertForSequenceClassification (ALBERT model)

  • BartConfig configuration class: BartForSequenceClassification (BART model)

  • BertConfig configuration class: BertForSequenceClassification (BERT model)

  • BigBirdConfig configuration class: BigBirdForSequenceClassification (BigBird model)

  • BigBirdPegasusConfig configuration class: BigBirdPegasusForSequenceClassification (BigBird-Pegasus model)

  • BioGptConfig configuration class: BioGptForSequenceClassification (BioGpt model)

  • BloomConfig configuration class: BloomForSequenceClassification (BLOOM model)

  • CTRLConfig configuration class: CTRLForSequenceClassification (CTRL model)

  • CamembertConfig configuration class: CamembertForSequenceClassification (CamemBERT model)

  • CanineConfig configuration class: CanineForSequenceClassification (CANINE model)

  • ConvBertConfig configuration class: ConvBertForSequenceClassification (ConvBERT model)

  • Data2VecTextConfig configuration class: Data2VecTextForSequenceClassification (Data2VecText model)

  • DebertaConfig configuration class: DebertaForSequenceClassification (DeBERTa model)

  • DebertaV2Config configuration class: DebertaV2ForSequenceClassification (DeBERTa-v2 model)

  • DistilBertConfig configuration class: DistilBertForSequenceClassification (DistilBERT model)

  • ElectraConfig configuration class: ElectraForSequenceClassification (ELECTRA model)

  • ErnieConfig configuration class: ErnieForSequenceClassification (ERNIE model)

  • ErnieMConfig configuration class: ErnieMForSequenceClassification (ErnieM model)

  • EsmConfig configuration class: EsmForSequenceClassification (ESM model)

  • FNetConfig configuration class: FNetForSequenceClassification (FNet model)

  • FalconConfig configuration class: FalconForSequenceClassification (Falcon model)

  • FlaubertConfig configuration class: FlaubertForSequenceClassification (FlauBERT model)

  • FunnelConfig configuration class: FunnelForSequenceClassification (Funnel Transformer model)

  • GPT2Config configuration class: GPT2ForSequenceClassification (OpenAI GPT-2 model)

  • GPTBigCodeConfig configuration class: GPTBigCodeForSequenceClassification (GPTBigCode model)

  • GPTJConfig configuration class: GPTJForSequenceClassification (GPT-J model)

  • GPTNeoConfig configuration class: GPTNeoForSequenceClassification (GPT Neo model)

  • GPTNeoXConfig configuration class: GPTNeoXForSequenceClassification (GPT NeoX model)

  • IBertConfig configuration class: IBertForSequenceClassification (I-BERT model)

  • LEDConfig configuration class: LEDForSequenceClassification (LED model)

  • LayoutLMConfig configuration class: LayoutLMForSequenceClassification (LayoutLM model)

  • LayoutLMv2Config configuration class: LayoutLMv2ForSequenceClassification (LayoutLMv2 model)

  • LayoutLMv3Config configuration class: LayoutLMv3ForSequenceClassification (LayoutLMv3 model)

  • LiltConfig configuration class: LiltForSequenceClassification (LiLT model)

  • LlamaConfig configuration class: LlamaForSequenceClassification (LLaMA model)

  • LongformerConfig configuration class: LongformerForSequenceClassification (Longformer model)

  • LukeConfig configuration class: LukeForSequenceClassification (LUKE model)

  • MBartConfig configuration class: MBartForSequenceClassification (mBART model)

  • MPNetConfig configuration class: MPNetForSequenceClassification (MPNet model)

  • MT5Config configuration class: MT5ForSequenceClassification (MT5 model)

  • MarkupLMConfig configuration class: MarkupLMForSequenceClassification (MarkupLM model)

  • MegaConfig configuration class: MegaForSequenceClassification (MEGA model)

  • MegatronBertConfig configuration class: MegatronBertForSequenceClassification (Megatron-BERT model)

  • MistralConfig configuration class: MistralForSequenceClassification (Mistral model)

  • MobileBertConfig configuration class: MobileBertForSequenceClassification (MobileBERT model)

  • MptConfig configuration class: MptForSequenceClassification (MPT model)

  • MraConfig configuration class: MraForSequenceClassification (MRA model)

  • MvpConfig configuration class: MvpForSequenceClassification (MVP model)

  • NezhaConfig configuration class: NezhaForSequenceClassification (Nezha model)

  • NystromformerConfig configuration class: NystromformerForSequenceClassification (Nyströmformer model)

  • OPTConfig configuration class: OPTForSequenceClassification (OPT model)

  • OpenAIGPTConfig configuration class: OpenAIGPTForSequenceClassification (OpenAI GPT model)

  • OpenLlamaConfig configuration class: OpenLlamaForSequenceClassification (OpenLlama model)

  • PLBartConfig configuration class: PLBartForSequenceClassification (PLBart model)

  • PerceiverConfig configuration class: PerceiverForSequenceClassification (Perceiver model)

  • PersimmonConfig configuration class: PersimmonForSequenceClassification (Persimmon model)

  • QDQBertConfig configuration class: QDQBertForSequenceClassification (QDQBert model)

  • ReformerConfig configuration class: ReformerForSequenceClassification (Reformer model)

  • RemBertConfig configuration class: RemBertForSequenceClassification (RemBERT model)

  • RoCBertConfig configuration class: RoCBertForSequenceClassification (RoCBert model)

  • RoFormerConfig configuration class: RoFormerForSequenceClassification (RoFormer model)

  • RobertaConfig configuration class: RobertaForSequenceClassification (RoBERTa model)

  • RobertaPreLayerNormConfig configuration class: RobertaPreLayerNormForSequenceClassification (RoBERTa-PreLayerNorm model)

  • SqueezeBertConfig configuration class: SqueezeBertForSequenceClassification (SqueezeBERT model)

  • T5Config configuration class: T5ForSequenceClassification (T5 model)

  • TapasConfig configuration class: TapasForSequenceClassification (TAPAS model)

  • TransfoXLConfig configuration class: TransfoXLForSequenceClassification (Transformer-XL model)

  • UMT5Config configuration class: UMT5ForSequenceClassification (UMT5 model)

  • XLMConfig configuration class: XLMForSequenceClassification (XLM model)

  • XLMRobertaConfig configuration class: XLMRobertaForSequenceClassification (XLM-RoBERTa model)

  • XLMRobertaXLConfig configuration class: XLMRobertaXLForSequenceClassification (XLM-RoBERTa-XL model)

  • XLNetConfig configuration class: XLNetForSequenceClassification (XLNet model)

  • XmodConfig configuration class: XmodForSequenceClassification (X-MOD model)

  • YosoConfig configuration class: YosoForSequenceClassification (YOSO model)

Instantiates one of the model classes of the library (with a sequence classification head) from a configuration.

Note: Loading a model from its configuration file does not load the model weights. It only affects the model’s configuration. Use from_pretrained() to load the model weights.

Examples:

Copied

>>> from transformers import AutoConfig, AutoModelForSequenceClassification

>>> # Download configuration from huggingface.co and cache.
>>> config = AutoConfig.from_pretrained("bert-base-cased")
>>> model = AutoModelForSequenceClassification.from_config(config)

from_pretrained

<source>

( *model_args**kwargs )

Parameters

• pretrained_model_name_or_path (str or os.PathLike) — Can be either:

  • A string, the model id of a pretrained model 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 model weights saved using save_pretrained(), e.g., ./my_model_directory/.

  • A path or url to a tensorflow index checkpoint file (e.g, ./tf_model/model.ckpt.index). In this case, from_tf should be set to True and a configuration object should be provided as config argument. This loading path is slower than converting the TensorFlow checkpoint in a PyTorch model using the provided conversion scripts and loading the PyTorch model afterwards.

• model_args (additional positional arguments, optional) — Will be passed along to the underlying model __init__() method.

• config (PretrainedConfig, optional) — Configuration for the model to use instead of an automatically loaded configuration. Configuration can be automatically loaded when:

  • The model is a model provided by the library (loaded with the model id string of a pretrained model).

  • The model was saved using save_pretrained() and is reloaded by supplying the save directory.

  • The model is loaded by supplying a local directory as pretrained_model_name_or_path and a configuration JSON file named config.json is found in the directory.

• state_dict (Dict[str, torch.Tensor], optional) — A state dictionary to use instead of a state dictionary loaded from saved weights file.

  This option can be used if you want to create a model from a pretrained configuration but load your own weights. In this case though, you should check if using save_pretrained() and from_pretrained() is not a simpler option.

• cache_dir (str or os.PathLike, optional) — Path to a directory in which a downloaded pretrained model configuration should be cached if the standard cache should not be used.

• from_tf (bool, optional, defaults to False) — Load the model weights from a TensorFlow checkpoint save file (see docstring of pretrained_model_name_or_path argument).

• force_download (bool, optional, defaults to False) — Whether or not to force the (re-)download of the model weights and configuration files, overriding the cached versions if they exist.

• resume_download (bool, optional, defaults to False) — Whether or not to delete incompletely received files. Will attempt to resume the download if such a file exists.

• proxies (Dict[str, str], optional) — A dictionary of proxy servers to use by protocol or endpoint, e.g., {'http': 'foo.bar:3128', 'http://hostname': 'foo.bar:4012'}. The proxies are used on each request.

• output_loading_info(bool, optional, defaults to False) — Whether ot not to also return a dictionary containing missing keys, unexpected keys and error messages.

• local_files_only(bool, optional, defaults to False) — Whether or not to only look at local files (e.g., not try downloading the model).

• revision (str, optional, defaults to "main") — The specific model version to use. It can be a branch name, a tag name, or a commit id, since we use a git-based system for storing models and other artifacts on huggingface.co, so revision can be any identifier allowed by git.

• trust_remote_code (bool, optional, defaults to False) — Whether or not to allow for custom models defined on the Hub in their own modeling files. This option should only be set to True for repositories you trust and in which you have read the code, as it will execute code present on the Hub on your local machine.

• code_revision (str, optional, defaults to "main") — The specific revision to use for the code on the Hub, if the code leaves in a different repository than the rest of the model. It can be a branch name, a tag name, or a commit id, since we use a git-based system for storing models and other artifacts on huggingface.co, so revision can be any identifier allowed by git.

• kwargs (additional keyword arguments, optional) — Can be used to update the configuration object (after it being loaded) and initiate the model (e.g., output_attentions=True). Behaves differently depending on whether a config is provided or automatically loaded:

  • If a configuration is provided with config, **kwargs will be directly passed to the underlying model’s __init__ method (we assume all relevant updates to the configuration have already been done)

  • If a configuration is not provided, kwargs will be first passed to the configuration class initialization function (from_pretrained()). Each key of kwargs that corresponds to a configuration attribute will be used to override said attribute with the supplied kwargs value. Remaining keys that do not correspond to any configuration attribute will be passed to the underlying model’s __init__ function.

Instantiate one of the model classes of the library (with a sequence classification head) from a pretrained model.

The model class to instantiate is selected based on the model_type property of the config object (either passed as an argument or loaded from pretrained_model_name_or_path if possible), or when it’s missing, by falling back to using pattern matching on pretrained_model_name_or_path:

• albert — AlbertForSequenceClassification (ALBERT model)

• bart — BartForSequenceClassification (BART model)

• bert — BertForSequenceClassification (BERT model)

• big_bird — BigBirdForSequenceClassification (BigBird model)

• bigbird_pegasus — BigBirdPegasusForSequenceClassification (BigBird-Pegasus model)

• biogpt — BioGptForSequenceClassification (BioGpt model)

• bloom — BloomForSequenceClassification (BLOOM model)

• camembert — CamembertForSequenceClassification (CamemBERT model)

• canine — CanineForSequenceClassification (CANINE model)

• code_llama — LlamaForSequenceClassification (CodeLlama model)

• convbert — ConvBertForSequenceClassification (ConvBERT model)

• ctrl — CTRLForSequenceClassification (CTRL model)

• data2vec-text — Data2VecTextForSequenceClassification (Data2VecText model)

• deberta — DebertaForSequenceClassification (DeBERTa model)

• deberta-v2 — DebertaV2ForSequenceClassification (DeBERTa-v2 model)

• distilbert — DistilBertForSequenceClassification (DistilBERT model)

• electra — ElectraForSequenceClassification (ELECTRA model)

• ernie — ErnieForSequenceClassification (ERNIE model)

• ernie_m — ErnieMForSequenceClassification (ErnieM model)

• esm — EsmForSequenceClassification (ESM model)

• falcon — FalconForSequenceClassification (Falcon model)

• flaubert — FlaubertForSequenceClassification (FlauBERT model)

• fnet — FNetForSequenceClassification (FNet model)

• funnel — FunnelForSequenceClassification (Funnel Transformer model)

• gpt-sw3 — GPT2ForSequenceClassification (GPT-Sw3 model)

• gpt2 — GPT2ForSequenceClassification (OpenAI GPT-2 model)

• gpt_bigcode — GPTBigCodeForSequenceClassification (GPTBigCode model)

• gpt_neo — GPTNeoForSequenceClassification (GPT Neo model)

• gpt_neox — GPTNeoXForSequenceClassification (GPT NeoX model)

• gptj — GPTJForSequenceClassification (GPT-J model)

• ibert — IBertForSequenceClassification (I-BERT model)

• layoutlm — LayoutLMForSequenceClassification (LayoutLM model)

• layoutlmv2 — LayoutLMv2ForSequenceClassification (LayoutLMv2 model)

• layoutlmv3 — LayoutLMv3ForSequenceClassification (LayoutLMv3 model)

• led — LEDForSequenceClassification (LED model)

• lilt — LiltForSequenceClassification (LiLT model)

• llama — LlamaForSequenceClassification (LLaMA model)

• longformer — LongformerForSequenceClassification (Longformer model)

• luke — LukeForSequenceClassification (LUKE model)

• markuplm — MarkupLMForSequenceClassification (MarkupLM model)

• mbart — MBartForSequenceClassification (mBART model)

• mega — MegaForSequenceClassification (MEGA model)

• megatron-bert — MegatronBertForSequenceClassification (Megatron-BERT model)

• mistral — MistralForSequenceClassification (Mistral model)

• mobilebert — MobileBertForSequenceClassification (MobileBERT model)

• mpnet — MPNetForSequenceClassification (MPNet model)

• mpt — MptForSequenceClassification (MPT model)

• mra — MraForSequenceClassification (MRA model)

• mt5 — MT5ForSequenceClassification (MT5 model)

• mvp — MvpForSequenceClassification (MVP model)

• nezha — NezhaForSequenceClassification (Nezha model)

• nystromformer — NystromformerForSequenceClassification (Nyströmformer model)

• open-llama — OpenLlamaForSequenceClassification (OpenLlama model)

• openai-gpt — OpenAIGPTForSequenceClassification (OpenAI GPT model)

• opt — OPTForSequenceClassification (OPT model)

• perceiver — PerceiverForSequenceClassification (Perceiver model)

• persimmon — PersimmonForSequenceClassification (Persimmon model)

• plbart — PLBartForSequenceClassification (PLBart model)

• qdqbert — QDQBertForSequenceClassification (QDQBert model)

• reformer — ReformerForSequenceClassification (Reformer model)

• rembert — RemBertForSequenceClassification (RemBERT model)

• roberta — RobertaForSequenceClassification (RoBERTa model)

• roberta-prelayernorm — RobertaPreLayerNormForSequenceClassification (RoBERTa-PreLayerNorm model)

• roc_bert — RoCBertForSequenceClassification (RoCBert model)

• roformer — RoFormerForSequenceClassification (RoFormer model)

• squeezebert — SqueezeBertForSequenceClassification (SqueezeBERT model)

• t5 — T5ForSequenceClassification (T5 model)

• tapas — TapasForSequenceClassification (TAPAS model)

• transfo-xl — TransfoXLForSequenceClassification (Transformer-XL model)

• umt5 — UMT5ForSequenceClassification (UMT5 model)

• xlm — XLMForSequenceClassification (XLM model)

• xlm-roberta — XLMRobertaForSequenceClassification (XLM-RoBERTa model)

• xlm-roberta-xl — XLMRobertaXLForSequenceClassification (XLM-RoBERTa-XL model)

• xlnet — XLNetForSequenceClassification (XLNet model)

• xmod — XmodForSequenceClassification (X-MOD model)

• yoso — YosoForSequenceClassification (YOSO model)

The model is set in evaluation mode by default using model.eval() (so for instance, dropout modules are deactivated). To train the model, you should first set it back in training mode with model.train()

Examples:

Copied

>>> from transformers import AutoConfig, AutoModelForSequenceClassification

>>> # Download model and configuration from huggingface.co and cache.
>>> model = AutoModelForSequenceClassification.from_pretrained("bert-base-cased")

>>> # Update configuration during loading
>>> model = AutoModelForSequenceClassification.from_pretrained("bert-base-cased", output_attentions=True)
>>> model.config.output_attentions
True

>>> # Loading from a TF checkpoint file instead of a PyTorch model (slower)
>>> config = AutoConfig.from_pretrained("./tf_model/bert_tf_model_config.json")
>>> model = AutoModelForSequenceClassification.from_pretrained(
...     "./tf_model/bert_tf_checkpoint.ckpt.index", from_tf=True, config=config
... )