Hugging Face Transformers

Com três linhas de Python, a Transformers baixa um modelo aberto do Hugging Face Hub e gera texto, transcreve áudio ou classifica imagens. A biblioteca define a arquitetura dos modelos e funciona na inferência e no treino. Ela também conversa com outros frameworks de treino e motores de inferência.

Para que serve

• Pôr um modelo aberto, como o Qwen do exemplo oficial, para gerar texto.
• Transcrever fala, classificar áudio ou converter texto em voz.
• Detectar objetos, segmentar imagens e estimar profundidade em fotos.
• Responder perguntas sobre documentos, tabelas e imagens com modelos multimodais.
• Resumir, traduzir e classificar textos, ou treinar um modelo com dados próprios.

Como começar

Python 3.10 e PyTorch 2.6, ou versões mais novas, são o mínimo que o README pede. A recomendação é criar antes um ambiente virtual com venv ou uv. Depois, um comando instala tudo:

pip install "transformers[torch]"

O exemplo mínimo do README monta um pipeline de geração de texto:

from transformers import pipeline

pipeline = pipeline(task="text-generation", model="Qwen/Qwen2.5-1.5B")
pipeline("the secret to baking a really good cake is ")

Também há um chat no terminal, transformers chat, que depende de um servidor local aberto com transformers serve.

Licença e custo

A biblioteca usa Apache 2.0 e cabe em projeto pessoal, interno ou vendido. Quem redistribui preserva os avisos de autoria e indica o que modificou. Cada modelo no Hub, porém, traz a licença que o autor escolheu, e é essa que define o que você pode fazer com ele. A Transformers é gratuita; o README menciona um Enterprise Hub da Hugging Face, sem detalhar preço.

Quando vale a pena

A Transformers costuma ser o ponto de partida de quem programa em Python e quer testar vários modelos abertos com a mesma interface. Para conversar com um modelo localmente, sem escrever código, o Ollama chega lá mais rápido. Antes de começar, o post LLM: o que é um modelo de linguagem e como funciona ajuda a entender o que acontece por trás do pipeline.