Quando Usar
Use quando o usuário solicitar a geração de qualquer imagem de capa, miniatura, banner, pôster ou cabeçalho a partir de uma descrição textual. Gatilhos incluem: "gerar uma capa", "criar uma miniatura", "fazer um banner", "设计封面", "生成封面图" ou qualquer solicitação que envolva criação de imagens a partir de prompts com dimensões especificadas.
Esta habilidade utiliza uma pipeline de duas etapas:
- mflux (FLUX.2 4-bit, Apple MLX) gera a imagem de fundo com IA
- HTML/CSS + Playwright Chromium renderiza tipografia nítida sobreposta
NÃO use para: geração de imagens sem sobreposição de texto, edição de imagens, upscaling ou casos de uso que não sejam capas.
Requisitos
- macOS com Apple Silicon (M1+)
- 16 GB+ de RAM recomendado (8 GB pode funcionar com resolução reduzida)
- mflux:
brew install uv && uv tool install mflux - Playwright:
pip install playwright && playwright install chromium - A primeira execução baixa o modelo FLUX.2 (~2-4 GB), depois fica totalmente offline
Procedimento
- Verificar pré-requisitos:
python3 cover_generator.py --detect— tanto mflux quanto Playwright+Chromium devem mostrar ✓ - Determinar dimensões: Use predefinições ou W×H exatos:
youtube-thumbnail(1280×720),twitter-header(1500×500),blog-cover(1200×630)instagram-post(1080×1080),facebook-cover(1640×624),linkedin-banner(1584×396)podcast-cover(3000×3000),github-social(1280×640),story(1080×1920)
- Escolher layout:
--layout bottom(padrão),centered,hero,top - Escolher gradiente:
--gradient dark(padrão),subtle,light,none - Gerar:
python3 cover_generator.py -p "descrição" --preset blog-cover - Otimizar prompts: Use inglês para
--prompt(fundo da IA), mantenha o idioma original para--title(texto visível) - Verificar: O arquivo de saída deve existir com as dimensões corretas
Armadilhas
- mflux requer Apple Silicon (M1+) — Macs Intel não conseguem executá-lo
- Playwright instala o Chromium separadamente (~300 MB de download)
- A primeira execução do mflux baixa o modelo FLUX.2 (~2-4 GB); execuções subsequentes são offline
- Texto em chinês nos prompts de IA pode gerar fundos de qualidade inferior — traduza para inglês no
--prompt, use--titlepara o texto chinês visível - Dimensões muito grandes (>3840 px) podem ser lentas. Para impressão A4 (3508 px), espere 3-5 s de renderização
- A qualidade do prompt impacta fortemente o fundo: seja específico sobre o estilo (ex.: 'minimalist watercolor', 'dark cinematic', 'clean abstract gradient')
- mflux arredonda as dimensões para múltiplos de 64 — a imagem de fundo pode ser ligeiramente menor que o solicitado; a etapa final de sobreposição corrige para as dimensões exatas
Verificação
python3 cover_generator.py --detect— mflux ✓, Playwright+Chromium ✓- Teste completo da pipeline:
python3 cover_generator.py -p 'Um lago sereno na montanha ao amanhecer' -o test.png - Verifique se as dimensões de saída correspondem à entrada
- Teste de modo bruto:
python3 cover_generator.py -p 'teste' --preset youtube-thumbnail --no-overlay -o raw.png