Transformers documentation
TorchAO
Get started
Tutorials
Run inference with pipelinesWrite portable code with AutoClassPreprocess dataFine-tune a pretrained modelTrain with a scriptSet up distributed training with 🤗 AccelerateLoad and train adapters with 🤗 PEFTShare your modelAgents 101Agents, supercharged - Multi-agents, External tools, and moreGeneration with LLMsChatting with Transformers
Task Guides
Natural Language Processing
Audio
Computer Vision
Multimodal
Generation
Prompting
Developer guides
Use fast tokenizers from 🤗 TokenizersRun inference with multilingual modelsUse model-specific APIsShare a custom modelChat templatesTrainerRun training on Amazon SageMakerExport to ONNXExport to TFLiteExport to TorchScriptBenchmarksNotebooks with examplesCommunity resourcesTroubleshootInteroperability with GGUF filesInteroperability with TikToken filesModularity in `transformers`
Quantization Methods
Getting startedbitsandbytesGPTQAWQAQLMQuantoEETQHQQFBGEMM_FP8OptimumTorchAOcompressed-tensorsContribute new quantization method
Performance and scalability
OverviewLLM inference optimization Instantiate a big modelDebuggingXLA Integration for TensorFlow ModelsOptimize inference using `torch.compile()`
Efficient training techniques
Methods and tools for efficient training on a single GPUMultiple GPUs and parallelismFully Sharded Data ParallelDeepSpeedEfficient training on CPUDistributed CPU trainingTraining on TPU with TensorFlowPyTorch training on Apple siliconCustom hardware for trainingHyperparameter Search using Trainer API
Optimizing inference
Contribute
How to contribute to 🤗 Transformers?How to add a model to 🤗 Transformers?How to add a pipeline to 🤗 Transformers?TestingChecks on a Pull Request
Conceptual guides
PhilosophyGlossaryWhat 🤗 Transformers can doHow 🤗 Transformers solve tasksThe Transformer model familySummary of the tokenizersAttention mechanismsPadding and truncationBERTologyPerplexity of fixed-length modelsPipelines for webserver inferenceModel training anatomyGetting the most out of LLMs
API
Main Classes
Agents and ToolsAuto ClassesBackbonesCallbacksConfigurationData CollatorKeras callbacksLoggingModelsText GenerationONNXOptimizationModel outputsPipelinesProcessorsQuantizationTokenizerTrainerDeepSpeedExecuTorchFeature ExtractorImage Processor
Models
Text models
Vision models
Audio models
Video models
Multimodal models
Reinforcement learning models
Time series models
Graph models
Internal Helpers
You are viewing v4.45.2 version. A newer version v5.8.1 is available.
TorchAO
TorchAO is an architecture optimization library for PyTorch, it provides high performance dtypes, optimization techniques and kernels for inference and training, featuring composability with native PyTorch features like torch.compile, FSDP etc.. Some benchmark numbers can be found here
Before you begin, make sure the following libraries are installed with their latest version:
pip install --upgrade torch torchao
from transformers import TorchAoConfig, AutoModelForCausalLM, AutoTokenizer
model_name = "meta-llama/Meta-Llama-3-8B"
# We support int4_weight_only, int8_weight_only and int8_dynamic_activation_int8_weight
# More examples and documentations for arguments can be found in https://github.com/pytorch/ao/tree/main/torchao/quantization#other-available-quantization-techniques
quantization_config = TorchAoConfig("int4_weight_only", group_size=128)
quantized_model = AutoModelForCausalLM.from_pretrained(model_name, device_map="auto", quantization_config=quantization_config)
tokenizer = AutoTokenizer.from_pretrained(model_name)
input_text = "What are we having for dinner?"
input_ids = tokenizer(input_text, return_tensors="pt").to("cuda")
# compile the quantized model to get speedup
import torchao
torchao.quantization.utils.recommended_inductor_config_setter()
quantized_model = torch.compile(quantized_model, mode="max-autotune")
output = quantized_model.generate(**input_ids, max_new_tokens=10)
print(tokenizer.decode(output[0], skip_special_tokens=True))torchao quantization is implemented with tensor subclasses, currently it does not work with huggingface serialization, both the safetensor option and non-safetensor option, we’ll update here with instructions when it’s working.
< > Update on GitHub