Communitygithub.com

haoyiyin/mflux-cover

Habilidade de agente — geração de imagens de capa com tipografia nítida. mflux (FLUX.2 MLX) cria o fundo; HTML/CSS + Playwright renderiza o texto perfeitamente. 100% local no Apple Silicon.

O que é mflux-cover?

Esta habilidade permite que um agente de IA gere imagens de capa, miniaturas, banners, pôsteres ou cabeçalhos a partir de uma descrição textual, combinando um fundo gerado por IA com texto tipográfico sobreposto. Ela é útil para criadores de conteúdo, desenvolvedores e profissionais de marketing que precisam de imagens visuais rapidamente, sem depender de serviços online. A habilidade suporta plataformas como macOS com Apple Silicon (M1+) e utiliza uma pipeline de duas etapas: primeiro, o modelo FLUX.2 (4-bit, Apple MLX) via mflux gera a imagem de fundo; depois, HTML/CSS combinado com Playwright Chromium renderiza o texto com alta qualidade. O processo é totalmente offline após o download inicial dos modelos, e oferece diversos layouts e gradientes para personalização. A verificação de dependências e um teste completo garantem que tudo funcione corretamente antes do uso.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add haoyiyin/mflux-cover

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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:

  1. mflux (FLUX.2 4-bit, Apple MLX) gera a imagem de fundo com IA
  2. 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

  1. Verificar pré-requisitos: python3 cover_generator.py --detect — tanto mflux quanto Playwright+Chromium devem mostrar ✓
  2. 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)
  3. Escolher layout: --layout bottom (padrão), centered, hero, top
  4. Escolher gradiente: --gradient dark (padrão), subtle, light, none
  5. Gerar: python3 cover_generator.py -p "descrição" --preset blog-cover
  6. Otimizar prompts: Use inglês para --prompt (fundo da IA), mantenha o idioma original para --title (texto visível)
  7. 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 --title para 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

  1. python3 cover_generator.py --detect — mflux ✓, Playwright+Chromium ✓
  2. Teste completo da pipeline: python3 cover_generator.py -p 'Um lago sereno na montanha ao amanhecer' -o test.png
  3. Verifique se as dimensões de saída correspondem à entrada
  4. Teste de modo bruto: python3 cover_generator.py -p 'teste' --preset youtube-thumbnail --no-overlay -o raw.png

Habilidades Relacionadas