flowcraft

FlowCraft é um construtor visual de fluxos de trabalho open-source projetado para geração de conteúdo com IA usando os modelos de IA Gemini do Google. Ele permite que usuários criem fluxos de trabalho multimodais complexos conectando diferentes tipos de nós por meio de uma interface intuitiva de arrastar e soltar, gerando texto, imagens e vídeos. **Capacidades Principais** A plataforma possui um construtor visual de fluxos de trabalho baseado em @xyflow/react, permitindo que usuários projetem fluxos de IA escaláveis sem escrever código. Oferece integração de primeira classe com os modelos de IA generativa do Google, incluindo Gemini 3 Pro e 3 Flash para geração de texto, Nano Banana Pro (Gemini 3 Pro Image Preview) e Gemini 2.5 Flash Image para geração de imagens, e Veo 3.1 para geração de vídeos. Os fluxos podem ser executados em tempo real com feedback visual e rastreamento de progresso, e o mecanismo de processamento paralelo resolve automaticamente dependências e determina caminhos de execução inteligentes. **Tipos de Nós Integrados** FlowCraft vem com um conjunto abrangente de nós integrados: - **Nó LLM (Agente)**: Geração de texto com tecnologia Gemini, suportando entradas de texto e arquivos, ferramentas configuráveis, instruções de sistema, saída JSON estrita e um construtor visual de esquemas. - **Nó de Imagem**: Gera imagens usando Gemini 3 Pro Image Preview ou Gemini 2.5 Flash Image com proporções, referenciamento e resoluções configuráveis. - **Nó de Vídeo**: Alimentado por Veo 3.1 (modelos Fast e Pro), gera vídeos de 4, 6 ou 8 segundos a partir de prompts de texto, opcionalmente usando primeiro/último quadro ou imagens de referência de nós conectados. - **Nó de Arquivo**: Gerencia e visualiza arquivos incluindo PDFs, imagens e vídeos, conectável a nós LLM e Vision via URIs do Google Cloud Storage. - **Nó de Texto**: Entrada simples de texto multilinha para prompts e instruções. - **Nó de Upscale**: Aumenta a resolução de imagens geradas em até 4x usando Imagen 4.0. - **Nó de Redimensionamento**: Redimensiona ou corta imagens de forma inteligente para novas proporções. - **Nó de Fluxo Personalizado**: Incorpora fluxos salvos anteriormente como nós personalizados modulares e reutilizáveis. - **Nós de Entrada/Saída**: Definem limites de dados para fluxos de trabalho personalizados. **Recursos Avançados** O mecanismo de fluxo de trabalho (workflow-engine.ts) processa grafos de execução recursivamente com processamento paralelo. Um painel de configuração dinâmico permite que usuários ajustem parâmetros como modelo de geração, instruções de sistema, duração do vídeo e resolução de mídia em tempo real pela barra lateral. A autenticação integrada usa Google OAuth via next-auth, e um visualizador de mídia permite revisar ativos gerados diretamente no grafo. **Stack de Tecnologia** Frontend: Next.js 16.1 (App Router), React 19, TypeScript, Tailwind CSS 4.1.18, @xyflow/react 12.10, shadcn/ui (Radix UI + Tailwind) e Zustand para gerenciamento de estado no lado do cliente. Backend: Node.js com funções serverless do Next.js, Google GenAI SDK para interações com Vertex AI, Terraform para infraestrutura como código, Google Cloud Run para hospedagem conteinerizada, Google Cloud Storage para armazenamento de artefatos, Google Cloud Firestore para banco de dados NoSQL em tempo real e Winston para registro padronizado de logs. **Modelos de IA Suportados** - Texto: gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite - Imagem: imagen-4.0-upscale-preview, gemini-2.5-flash-image, gemini-3-pro-image, gemini-3.1-flash-image, gemini-3.1-flash-lite-image - Vídeo: veo-3.1-lite-generate-001, veo-3.1-fast-generate-001, veo-3.1-generate-001, gemini-omni-flash-preview **Implantação** O projeto usa Terraform para provisionar e gerenciar a infraestrutura do Google Cloud. Um script de implantação (scripts/deploy.sh) orquestra a inicialização do Terraform, planejamento de build e aplicação para provisionar recursos GCP, construir imagens Docker via Cloud Build e implantar no Cloud Run. Os pré-requisitos incluem Node.js 18+, um projeto do Google Cloud com Vertex AI habilitado, banco de dados Firebase/Firestore e um bucket GCS. **Casos de Uso** FlowCraft suporta fluxos de trabalho multimodais complexos, como encadear um agente de brainstorming de texto Gemini em um bloco de geração de imagem Imagen 4.0, redimensionar uma imagem 16:9 para 9:16 para o TikTok e passá-la como primeiro quadro para geração de vídeo Veo 3.1, ou fornecer um PDF longo a um Nó Resumidor personalizado que executa internamente subfluxos map-reduce. O projeto é licenciado sob Apache 2.0 e aceita contribuições pelo fluxo padrão fork-branch-commit-PR.