Você digita uma frase, aperta um botão, e a imagem aparece. Sem site, sem assinatura, sem ninguém vendo o que você pediu. É isso que o FLUX 3 Image Klein faz — e desde 15 de outubro de 2026 ele é aberto: os arquivos estão disponíveis para quem quiser baixar e rodar no próprio computador.

Este tutorial mostra o caminho completo, do download à primeira imagem, sem programar. No fim, você vai saber também o que a fabricante anuncia e o que a gente mediu de verdade nos arquivos — porque nem todo número de anúncio sobrevive à conferência.

Em 55 segundos: o que o modelo faz e o que o código que pede a imagem tem de avisar quando o programa não está aberto.

O que você vai conseguir fazer

  • Criar imagem do zero a partir de uma descrição escrita.
  • Editar foto — trocar o fundo, tirar um objeto, mudar a cor de uma parede — sem enviar a foto para servidor nenhum.
  • Fazer tudo offline, depois do download. Sem internet, sem custo por imagem.

O modelo é pequeno para o padrão atual: 5,6 bilhões de parâmetros. Parâmetro é o nome que se dá aos ajustes internos que o modelo aprendeu olhando imagens — quanto mais, em geral mais "conhecimento", e mais espaço de memória ele pede.

O que você precisa antes de começar

  • Um computador com placa de vídeo NVIDIA (a versão comprimida roda com 8 GB de memória de vídeo, segundo a fabricante). Sem placa NVIDIA, o caminho existe, mas fica lento.
  • Cerca de 45 GB livres em disco. Explico esse número na seção de medição — o anúncio fala em 11 GB, mas o download completo é bem maior.
  • Uma conta gratuita no Hugging Face, o site onde os arquivos ficam hospedados.
  • Paciência para o primeiro download. São dezenas de gigabytes.

Passo 1 — Instalar o ComfyUI

O ComfyUI é o programa que "desenha" a imagem: ele recebe o seu pedido, chama o modelo e mostra o resultado numa tela visual, com caixinhas ligadas por fios. Não é preciso saber programar para usar — mas ele é a engrenagem que falta no seu computador.

  1. Baixe em comfy.org/download (versão desktop, para Windows, macOS ou Linux). A versão estável atual é a 0.42.1, publicada em 19 de outubro de 2026 — a página de releases no GitHub mostra a mais recente.
  2. Instale e abra. Na primeira vez ele pergunta onde guardar os modelos: aceite o padrão e anote o caminho, porque você vai precisar dele no passo 3.
  3. Deixe o programa aberto. Ele precisa estar rodando para o resto funcionar — esse é o erro número um de quem começa (volto nele no fim).

Passo 2 — Aceitar a licença e baixar o modelo

Os arquivos ficam em dois repositórios: a versão destilada (mais rápida, gera em menos passos) e a versão base (para quem vai treinar ajustes finos). Para uso normal, use a destilada.

  1. Abra huggingface.co/black-forest-labs/flux-3-image-klein.
  2. O repositório é protegido por licença: você precisa estar logado e aceitar os termos numa caixa que aparece no topo da página. Sem esse aceite, o download responde "não autorizado" — mesmo com o link certo.
  3. Só depois do aceite, baixe os arquivos. Se quiser a versão base, ela fica em flux-3-image-klein-base.

A licença se chama FLUX Kommunity License: uso comercial liberado e gratuito para pessoa física e para empresas com faturamento anual abaixo de 5 milhões de dólares. Acima disso, é preciso licença paga com a Black Forest Labs.

Passo 3 — Escolher a versão que cabe na sua placa

O mesmo modelo é distribuído em versões de tamanhos diferentes. Elas geram imagens parecidas — o que muda é o espaço que ocupam e a velocidade:

  • BF16 — a versão "cheia". Melhor qualidade, ocupa mais memória.
  • FP8 — comprimida pela metade. É a recomendação para a maioria das placas.
  • INT8 — a menor, feita para placas com 8 GB de memória de vídeo.
  • NVFP4 — a mais nova, feita para as placas mais recentes da NVIDIA.

Coloque os arquivos baixados na pasta de modelos do ComfyUI (a mesma que você anotou no passo 1). O ComfyUI tem uma página oficial só sobre este modelo, com o fluxo pronto: comfy.org/flux-3-image-klein.

Passo 4 — Pedir a primeira imagem

  1. No ComfyUI, abra o fluxo pronto do FLUX 3 Image Klein (menu de modelos ou a página do passo 3).
  2. Procure a caixa de texto — é onde fica o pedido. Escreva em inglês se puder: o modelo foi treinado majoritariamente assim e obedece melhor.
  3. Descreva cena, luz e enquadramento. "Uma xícara de café numa mesa de madeira, luz da manhã" funciona melhor que "café bonito".
  4. Aperte o botão de executar. A primeira imagem costuma levar mais tempo: o modelo está sendo carregado na memória.

Para editar uma foto, o caminho é o mesmo fluxo com a foto de entrada: você descreve só o que quer mudar ("troque o fundo por uma parede branca") e o modelo altera aquela área, mantendo o resto. É o recurso que a fabricante chama de edição pixel a pixel.

Passo 5 — Gerar várias imagens sem clicar (opcional)

Se você quiser fazer 20 variações da mesma ideia, clicar 20 vezes é ruim. O ComfyUI aceita pedidos por escrito, e um script de 30 linhas resolve. Salve o arquivo abaixo como gerar_imagem.py, na mesma pasta onde está o fluxo_klein.json (exportado do próprio ComfyUI, no menu de salvar fluxo):

import json
import urllib.request
import uuid

SERVIDOR = "http://127.0.0.1:8188"
PEDIDO = "uma xicara de cafe numa mesa de madeira, luz da manha"


def montar_pedido(texto):
    fluxo = json.load(open("fluxo_klein.json"))
    for no in fluxo.values():
        if no["class_type"] == "CLIPTextEncode":
            no["inputs"]["text"] = texto
    return {"prompt": fluxo, "client_id": str(uuid.uuid4())}


def enviar(corpo):
    pedido = urllib.request.Request(
        SERVIDOR + "/prompt",
        data=json.dumps(corpo).encode(),
        headers={"Content-Type": "application/json"},
    )
    return json.load(urllib.request.urlopen(pedido, timeout=10))


try:
    resposta = enviar(montar_pedido(PEDIDO))
    print("Pedido aceito:", resposta["prompt_id"])
    print("A imagem aparece na pasta output do ComfyUI.")
except OSError:
    print("O ComfyUI nao respondeu em 127.0.0.1:8188")
    print("Abra o ComfyUI e rode este arquivo de novo.")
    print("Este e o erro mais comum de quem esta comecando.")

Rode com python3 gerar_imagem.py. O script não baixa nada e não manda nada para fora: ele conversa com o ComfyUI que já está aberto no seu computador. A imagem final aparece na pasta output do ComfyUI.

O que a fabricante anuncia e o que a medição mostra

A Black Forest Labs publica números claros no anúncio do modelo. Fomos conferir cada um deles nos arquivos reais, em 22 de outubro de 2026, e o resultado tem três desvios que importam para quem vai baixar:

  • Anúncio: "os pesos do gerador ocupam 11,2 GB em BF16 e 5,6 GB em FP8".
    Medição: o arquivo principal em BF16 tem 11,1 GB — bate. Mas o repositório inteiro, que é o que você baixa, soma 43,3 GB, porque vem junto o codificador de texto (8,8 GB) e as variantes comprimidas. Reserve 45 GB em disco, não 11.
  • Anúncio: FP8 ocupa 5,6 GB.
    Medição: o arquivo FP8 do repositório tem 6,27 GB — cerca de 12% mais que o anunciado.
  • Anúncio: "roda em placas NVIDIA com apenas 8 GB de memória de vídeo".
    Medição: a frase vale para a build INT8 e com o modelo destilado. Com a versão BF16, 8 GB não bastam.

O número de velocidade ("cerca de 4 segundos por imagem numa RTX 5090, menos de 9 numa RTX 4070") é da própria fabricante, medido nos servidores dela, com o modelo destilado e imagens de 1 megapixel. Não temos placa NVIDIA nesta redação para reproduzir esse teste — então esse número você deve ler como anúncio, não como medição nossa. O que medimos foram os tamanhos de arquivo acima e a popularidade do modelo: 102.903 downloads e 621 curtidas nos primeiros cinco dias no Hugging Face.

Os erros mais comuns (e como sair deles)

  • "Não autorizado" ao baixar. Você não aceitou a licença no Hugging Face. Volte à página do modelo, faça login e aceite os termos no topo — o download libera na hora.
  • "O ComfyUI não responde". O programa está fechado. Ele precisa estar aberto e ouvindo na porta 8188 do seu computador. Abra e rode o script de novo.
  • Memória de vídeo esgotada (erro de "out of memory"). Você pegou a versão BF16 numa placa pequena. Troque pela FP8 ou pela INT8 e reduza o tamanho da imagem para 1024 por 1024.
  • A imagem sai diferente do que você pediu. Quase sempre é o pedido vago. Diga o que aparece, onde está a luz e como é o enquadramento — o modelo não adivinha intenção.
  • Primeira imagem muito lenta. Normal: o carregamento do modelo acontece na primeira execução. Da segunda em diante, cai bastante.

Vale a pena para você?

Se você precisa de volume — dezenas de imagens por dia, ou editar fotos que não podem sair do seu computador — o caminho local se paga rápido: não há custo por imagem nem envio de dados para fora. Se você precisa de uma imagem boa por semana, os serviços de nuvem continuam mais simples: sem download de 43 GB, sem placa de vídeo, sem licença para aceitar.

O que mudou em outubro de 2026 é que a escolha passou a existir de verdade: um modelo deste tamanho, aberto, cabendo numa placa de 8 GB, era ficção há dois anos.

Referências