Communitygithub.com

film-crew

Ferramentas para usar durante a produção de um filme: ajustar modelos, acompanhar o progresso e exibir o resultado final.

O que é film-crew?

O film-crew é um conjunto de ferramentas para suportar o workflow de geração de vídeos e imagens com modelos de IA, focado em quem já sabe como dirigir uma cena (o 'como filmar') e precisa das ferramentas para executar. Ele divide-se em quatro módulos independentes: backends (envia ordens de serviço para APIs oficiais de vídeo e imagem, como Alibaba Cloud Bailian, Volcano Ark, MiniMax e OpenAI Images, usando chaves de ambiente), viewer (cria páginas web para progresso ao vivo, galeria de resultados e grafos de nós exportáveis para ComfyUI), comfyui (abre cada cena no ComfyUI para inspeção visual sem gerar novamente) e formats (define os formatos de arquivo de troca — ordem de serviço e manifesto de cenas — e scripts de validação). É útil quando se precisa gerar um vídeo ou imagem a partir de uma ordem de serviço, visualizar a requisição exata antes de enviar, escolher um modelo por sua ficha de capacidade (alimentação, duração, imagens de referência, preço, velocidade), ver uma página de progresso durante a geração, ou abrir o resultado no ComfyUI. Suporta Python 3.10+, usa apenas a biblioteca padrão para maioria das funções (exceto console.py que requer Pillow e ffmpeg), e as chaves de API são lidas exclusivamente de variáveis de ambiente, nunca escritas em arquivos.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/memoryoffish/film-director-skill-plugin/tree/HEAD/plugins/film-crew

Perguntar na sua IA favorita

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

Documentação

O que film-crew faz?

Uma frase: as regras de filmagem dizem "como filmar", aqui estão as ferramentas para usar durante a produção — ajustar modelos, acompanhar o progresso, exibir o resultado final. Quatro módulos lado a lado, cada um com seu próprio overview.md; caminhos relativos a este diretório.

O que cada módulo faz

MóduloO que fazQuando usarLeia primeiro
backends/Ordem de serviço entra, vídeo e imagem saemPara gerar um vídeo ou um conjunto de imagens; quer ver a requisição exata antes de enviar; precisa escolher um modelobackends/overview.md
viewer/Diretório de execução → página web para pessoas veremDurante a produção, para ver cada geração ao vivo (página de progresso); após a produção, para ver o que cada cena recebeu e o que saiu (galeria, grafo de nós)viewer/overview.md
comfyui/Cada cena aberta no ComfyUIQuando uma pessoa quer ver no ComfyUI como uma cena foi feita, pegando os quadros-chave e o vídeo para continuar usandocomfyui/overview.md
formats/Formatos dos dois arquivos de trocaPara escrever ou verificar uma ordem de serviço; ler um diretório de execução e gerar um manifesto de cenasformats/overview.md

Os quatro módulos se comunicam apenas por dois arquivos: a ordem de serviço (o que será gerado em cada execução) vai para o backend; o manifesto de cenas (o que cada cena de um filme usou e produziu) vai para os dois visualizadores.

Onde eles aparecem durante a produção de um filme

  1. Iniciar a produção: A página de progresso é iniciada no tmux e, a cada nova geração, ela é listada — python3 viewer/scripts/progress.py <diretório_de_saída> --jobs <projeto>/clips --prices backends/cards/prices.json --every 60.
  2. Gerar: Cada geração escreve uma ordem de serviço em <projeto>/jobs/ (vídeo) ou <projeto>/jobs_img/ (imagem). Primeiro execute python3 backends/scripts/filmgen.py request <ordem> para ver o que será enviado, depois execute run. O backend chama as APIs oficiais de cada fornecedor: Alibaba Cloud Bailian (Wan 3.0, HappyHorse 1.1), Volcano Ark (Seedance 2.5 / 2.0), MiniMax (H3-Max), OpenAI Images (gpt-image 2.6). Qual modelo escolher, veja em backends/cards/.
  3. Finalizar a produção: No diretório de execução, escreva um manifesto de cenas meta.json (cada cena: nome, intervalo no vídeo final, qual geração foi usada), depois execute python3 formats/read_run.py <configuração> --out <diretório_de_manifesto> para obter o manifesto de cenas, e python3 formats/check_manifest.py para verificar.
  4. Exibir para pessoas: A página web é python3 viewer/scripts/console.py <manifesto…> <diretório_de_saída>; para abrir no ComfyUI, execute python3 comfyui/scripts/shots2comfy.py <manifesto…> --comfy <diretório_do_ComfyUI>. O grafo de nós na página web segue o fluxo de trabalho do ComfyUI; para isso, primeiro execute shots2comfy.py e depois adicione --workflows ao console.py.

Pré-requisitos: Python 3.10 ou superior. backends, formats, a página de progresso e shots2comfy.py usam apenas a biblioteca padrão (backends usa ffprobe para medir a duração dos vídeos); a galeria (console.py) requer Pillow e ffmpeg; send requer ssh e a máquina de destino deve ter tmux; os pacotes de nós do ComfyUI rodam no próprio ambiente do ComfyUI (usando o Pillow e numpy dele).

Os parâmetros de cada etapa e o que verificar após a execução estão no overview.md de cada módulo.

Regras

  • Chaves são lidas apenas de variáveis de ambiente (DASHSCOPE_API_KEY, ARK_API_KEY, MINIMAX_API_KEY, OPENAI_API_KEY), nunca escritas em nenhum arquivo, nunca impressas. request funciona mesmo sem chave definida.
  • Visualizadores são somente leitura: não modificam o diretório de execução, não chamam interfaces de geração. Se uma pessoa vê algo que precisa ser ajustado no ComfyUI ou na página web, ela informa o agente, que altera e envia novamente.
  • Veja antes de enviar: para cada ordem, execute request primeiro; para refazer ou alterar parâmetros, salve como uma nova ordem com nome diferente.
  • As páginas geradas devem ser visualizadas por si mesmo conforme a abertura da pessoa, antes de entregar a ela.

Habilidades Relacionadas