Introdução

Aprenda a instalar o FLUX.2 Klein 9B no Krita e utilizar comandos escritos para criar imagens, modificar fotografias, remover objetos e substituir cenários.

Instalando o Krita

Acesse o site oficial do Krita, baixe a versão correspondente ao seu sistema operacional e conclua a instalação.

Windows

  1. Baixe o instalador para Windows.
  2. Execute o arquivo.
  3. Siga as etapas apresentadas.
  4. Abra o Krita.

Linux

Para utilizar o plugin de inteligência artificial, prefira a versão AppImage. Depois de baixar o arquivo, abra o terminal na pasta onde ele foi salvo:

# Linux: Terminal
chmod +x krita-*.appimage
./krita-*.appimage

O primeiro comando concede permissão de execução. O segundo inicia o programa.

Se o Krita já estiver instalado e disponível no PATH, abra uma fotografia pelo terminal:

# Linux: Terminal
krita "$HOME/Imagens/fotografia.jpg"

Substitua o caminho pelo local e nome reais do arquivo. Se estiver usando o AppImage sem integração no sistema, execute o próprio AppImage indicando o caminho da fotografia como argumento.

macOS

Baixe a versão para macOS, instale o aplicativo na pasta Aplicativos e abra o Krita.

Instalando o Krita AI Diffusion

Acesse a página oficial de lançamentos do Krita AI Diffusion. Baixe o ZIP de instalação da versão mais recente compatível com sua versão do Krita.

Não utilize o arquivo Source code. Baixe o pacote ZIP preparado para instalação do plugin.

No Krita, acesse Ferramentas → Scripts → Importar plugin Python de arquivo..., selecione o ZIP baixado, confirme a instalação e reinicie o programa.

Ativando o painel

Após reiniciar, acesse Configurações → Dockers → AI Image Generation. Se o painel não aparecer, confira se o plugin está habilitado no gerenciador de plugins Python.

Configurando o servidor local

O FLUX.2 Klein 9B será executado pelo ComfyUI, integrado ao plugin. No painel AI Image Generation, clique em Configure e escolha Local Managed Server para instalar e gerenciar o servidor localmente.

Selecione o diretório de instalação e conclua a configuração. Essa etapa instala o ambiente do servidor, mas não os pesos específicos do FLUX.2 Klein 9B. Eles serão adicionados manualmente a seguir.

Baixando e instalando o FLUX.2 Klein 9B

A variante 9B é compatível com o Krita AI Diffusion, mas precisa ser baixada e configurada manualmente. Não confunda esse procedimento com o download automático oferecido para outras variantes.

Utilize os arquivos preparados para ComfyUI no repositório Comfy-Org/Flux-2-Klein-9B. Consulte também a página original da Black Forest Labs. O acesso aos pesos originais exige aceitar os termos da licença.

Para a variante destilada 9B em FP8, os arquivos utilizados pelo fluxo ComfyUI são:

  • flux-2-klein-9b-fp8.safetensors — modelo principal.
  • qwen_3_8b_fp8mixed.safetensors — encoder de texto Qwen 3 8B.
  • flux2-vae.safetensors — VAE do FLUX.2.

Coloque cada arquivo no diretório correspondente da instalação do ComfyUI:

ComfyUI/
└── models/
    ├── diffusion_models/
    │   └── flux-2-klein-9b-fp8.safetensors
    ├── text_encoders/
    │   └── qwen_3_8b_fp8mixed.safetensors
    └── vae/
        └── flux2-vae.safetensors

Se o nome ou a variante dos arquivos no repositório mudar, siga os nomes e caminhos indicados na documentação atual do ComfyUI. Não renomeie arquivos aleatoriamente nem misture o encoder de outra variante.

Localizando a pasta do servidor gerenciado

Se instalou o servidor pelo plugin, abra Configure → Connection e utilize a opção de abrir a pasta de instalação ou consulte os registros de diagnóstico para localizar o diretório. Dentro dele, procure ComfyUI/models e copie os três arquivos para as subpastas indicadas.

Depois de copiar os arquivos, reinicie o servidor gerenciado ou atualize a conexão para que o ComfyUI reconheça os modelos.

Selecionando o modelo no Krita

No painel do plugin, abra a configuração de estilos. Duplique o estilo integrado Flux 2 Klein e ajuste o modelo principal para o arquivo 9B instalado. Confira se o encoder aponta para qwen_3_8b_fp8mixed.safetensors e se o VAE selecionado é flux2-vae.safetensors.

Salve o estilo e selecione-o no painel de geração. O 9B é suportado, mas precisa ser configurado manualmente como variante do estilo Flux 2 Klein.

Criando uma imagem a partir de texto

Abra um documento no Krita. No painel AI Image Generation, selecione o estilo configurado para o FLUX.2 Klein 9B e descreva a imagem no campo de prompt.

Exemplo de prompt:

Create a professional photograph of a modern software
development office.

Large monitors displaying programming code, elegant desk,
cinematic lighting, realistic materials, detailed environment,
natural shadows and professional photography.

Ajuste as opções de geração e clique em Generate. O ComfyUI processará a solicitação e enviará a imagem ao Krita.

Editando uma fotografia com comandos escritos

Abra a fotografia no Krita usando Arquivo → Abrir ou o atalho Ctrl + O. No Linux, também é possível iniciar o Krita pelo terminal:

# Linux: Terminal
krita "$HOME/Imagens/fotografia.jpg"

Confirme que a imagem está visível na tela. No painel de IA, altere o botão Generate para o modo Edit e escreva a modificação desejada.

Exemplo: substituir o fundo de uma fotografia

Replace the background with a modern technology office.

Preserve the person, face, clothing, body position and original
appearance. Match the new background lighting with the subject.
Create a realistic photographic result.

Execute a edição. O modelo utilizará a imagem visível na tela como entrada. O conteúdo visível das camadas é utilizado como imagem de entrada; oculte as camadas que não devam participar da edição.

Removendo objetos

Com a fotografia aberta, utilize o modo Edit e descreva o objeto que deseja remover e como a região deverá ficar.

Exemplo:

Remove the chair from the image.

Reconstruct the background naturally, preserving the original
lighting, perspective, floor texture and nearby objects.

O modelo tentará remover o objeto e reconstruir o cenário. Descreva também os elementos que precisam ser preservados.

Adicionando elementos em uma imagem

O mesmo modo permite inserir novos objetos em fotografias existentes.

Exemplo:

Add a modern desk lamp on the right side of the table.

Use warm lighting, realistic shadows and perspective consistent
with the original photograph.

Indique o elemento que será adicionado, sua posição e as características visuais desejadas.

Alterando o cenário de uma fotografia

Para transformar o ambiente, descreva a nova cena e indique quais características da imagem original devem permanecer.

Exemplo:

Transform this room into a modern technology office.

Add large windows, modern furniture, computer monitors and
subtle blue lighting.

Preserve the original camera perspective and create a realistic
photographic result.

Utilizando imagens de referência

O FLUX.2 Klein 9B aceita edição com referências visuais. No Krita, deixe a imagem principal visível na tela e adicione camadas individuais como referências adicionais pelo fluxo do plugin.

Exemplo de instrução:

Create a professional product photograph using the supplied
product reference.

Preserve the product's shape and main visual characteristics.
Use the second reference for the lighting and background style.

Revise o resultado: o modelo pode alterar detalhes das referências e nem sempre reproduz todos os elementos com exatidão.

Escrevendo instruções mais precisas

Evite comandos vagos como:

Make this image better.

Prefira instruções que indiquem o que deve ser alterado, o que precisa ser preservado e como deve ficar o resultado.

Exemplo:

Replace the background with a modern office.

Keep the person unchanged, including face, clothing and position.
Add soft natural light coming from the windows.
Preserve realistic shadows and photographic proportions.

Faça uma alteração por vez. Se o resultado não corresponder ao esperado, refine a instrução e gere novamente. Modelos generativos podem produzir resultados diferentes mesmo com o mesmo texto.

Solucionando problemas comuns

O painel de inteligência artificial não aparece

Confira se o pacote ZIP de lançamento foi instalado e se o plugin está habilitado no gerenciador de plugins Python. Reinicie o Krita após a instalação.

O servidor não inicia

Abra as configurações de conexão e verifique o estado do servidor gerenciado. Consulte os registros de diagnóstico para identificar erros de inicialização ou dependências.

O FLUX.2 Klein 9B não aparece

Confira se os três arquivos estão nas pastas corretas, se os nomes correspondem aos arquivos baixados e se o servidor foi reiniciado depois da cópia. Verifique também se o estilo duplicado está configurado para o modelo 9B e para o encoder Qwen 3 8B.

Erro de memória durante a geração

Reduza a resolução da imagem e feche outros programas que estejam utilizando a GPU. Consulte os registros do ComfyUI para identificar a operação que consumiu memória.

A edição altera elementos que deveriam permanecer iguais

Especifique no prompt quais características devem ser preservadas. Faça alterações menores, uma de cada vez, e mantenha uma cópia da imagem original.

Licenciamento do FLUX.2 Klein 9B

O FLUX.2 Klein 9B utiliza a FLUX Non-Commercial License. A utilização local dos pesos é destinada a finalidades não comerciais, conforme os termos da licença. Para utilizar os pesos localmente em atividades comerciais, é necessário obter uma licença comercial apropriada da Black Forest Labs.

Consulte os termos oficiais da licença e a página oficial do modelo.

Conclusão

Com o FLUX.2 Klein 9B integrado ao Krita, você pode criar imagens e editar fotografias utilizando instruções escritas. O mesmo modelo permite gerar imagens do zero, substituir cenários, remover objetos e adicionar elementos, mantendo o fluxo de trabalho dentro do editor.

Referências