Hub documentation

Usando Adapters no Hugging Face

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Usando Adapters no Hugging Face

Nota: Adapters substituiu a biblioteca adapter-transformers e é totalmente compatível em termos de pesos do modelo. Veja aqui para mais informações.

Adapters é uma biblioteca complementar ao 🤗 transformers para ajuste fino eficiente de modelos de linguagem pré-treinados usando adaptadores e outros métodos de eficiência de parâmetros. O Adapters também fornece vários métodos para composição de módulos de adaptador durante o treinamento e a inferência. Você pode aprender mais sobre isso no artigo Adapters.

Explorando Adapters no Hub

Você pode encontrar modelos de Adapters filtrando à esquerda na página de modelos. Alguns modelos de adaptador podem ser encontrados no repositório Adapter Hub. Os modelos de ambas as fontes são agregados no site do AdapterHub.

Instalação

Para começar, você pode consultar o guia de instalação do AdapterHub. Você também pode usar a seguinte instalação em uma linha através do pip:

pip install adapters

Usando modelos existentes

Para um guia completo sobre o carregamento de adaptadores pré-treinados, recomendamos consultar o guia oficial.

Em resumo, uma configuração completa consiste em três etapas:

  1. Carregue um modelo base do transformers com a classe AutoAdapterModel fornecida pelo Adapters.
  2. Use o método load_adapter() para carregar e adicionar um adaptador.
  3. Ative o adaptador por meio de active_adapters (para inferência) ou ative e defina-o como treinável por meio de train_adapter() (para treinamento). Certifique-se também de conferir composição de adaptadores.
from adapters import AutoAdapterModel

# 1.
model = AutoAdapterModel.from_pretrained("FacebookAI/roberta-base")
# 2.
adapter_name = model.load_adapter("AdapterHub/roberta-base-pf-imdb")
# 3.
model.active_adapters = adapter_name
# or model.train_adapter(adapter_name)

Você também pode usar list_adapters para encontrar todos os modelos de adaptador programaticamente:

from adapters import list_adapters

# source can be "ah" (AdapterHub), "hf" (hf.co) or None (for both, default)
adapter_infos = list_adapters(source="hf", model_name="FacebookAI/roberta-base")

Se você quiser ver como carregar um modelo específico, pode clicar em Use in Adapters e receber um trecho de código funcional para carregá-lo!

Compartilhando seus modelos

Para um guia completo sobre o compartilhamento de modelos com Adapters, recomendamos consultar o guia oficial.

Você pode compartilhar seu adaptador usando o método push_adapter_to_hub de um modelo que já contém um adaptador.

model.push_adapter_to_hub(
    "my-awesome-adapter",
    "awesome_adapter",
    adapterhub_tag="sentiment/imdb",
    datasets_tag="imdb"
)

Esse comando cria um repositório com um cartão de modelo gerado automaticamente e todos os metadados necessários.

Recursos adicionais

Update on GitHub