Communitygithub.com

katha-studio

Crie filmes animados de mitologia, devocionais e contos populares para o YouTube (16:9, 1080p) com personagens falantes. Guia a configuração inicial (ffmpeg, Chrome, chaves fal e ElevenLabs), escreve o roteiro, cria personagens consistentes, vozes, cenas faladas com sincronia labial, legendas, música e o filme final com miniatura e texto para o YouTube. Use quando o usuário desejar iniciar ou administrar um canal de histórias ou katha no YouTube, criar um vídeo de história animada, "fazer um vídeo como <um canal de mitologia>", configurar o katha-studio ou continuar um filme feito com ele.

O que é katha-studio?

O katha-studio é uma ferramenta de agente de IA especializada na produção de filmes de animação curtos para o YouTube, com foco em mitologia, conteúdo devocional e contos populares. Ela orienta o usuário por todo o processo, desde a configuração inicial (verificação de dependências como ffmpeg e Chrome, além de chaves de API para fal.ai e ElevenLabs) até a criação de um roteiro completo, personagens visualmente consistentes, dublagem com sincronia labial, legendas e música de fundo. O fluxo de trabalho é dividido em etapas com pontos de aprovação do usuário (gateways), garantindo controle criativo e qualidade. A ferramenta utiliza scripts Python locais (sem necessidade de pacotes pip) e serviços de terceiros pagos para geração de imagens (fal.ai) e vozes (ElevenLabs). É compatível com Claude Code, Cursor, Codex e outros terminais onde o agente possa executar comandos Python. O resultado final é um vídeo MP4 em 1080p, uma miniatura JPG e um arquivo de descrição para o YouTube, tudo organizado em uma pasta com um arquivo `film.json` central.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AdityaPratamaS18/katha-studio/tree/HEAD/skills/katha-studio

Perguntar na sua IA favorita

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

Documentação

O que katha-studio faz?

Você cria um filme de animação completo com o usuário. Cada filme é uma pasta com um film.json. A ferramenta é python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" (chame-a de KATHA abaixo). Ela não precisa de pacotes pip.

Etapas pagas (sheets, images, talk, move) exibem o preço e param. Elas gastam dinheiro apenas com --yes. Execute --yes somente após o usuário concordar com o preço no chat. A etapa de voz usa a cota do ElevenLabs do usuário.

Leia estes quando precisar:

  • references/film-format.md: todos os campos de film.json.
  • references/story-craft.md: como escrever um roteiro katha que prende o espectador e as regras de cena.
  • references/troubleshooting.md: falhas conhecidas e correções.

0. Primeira execução: configuração guiada

Faça isso quando o usuário for novo, ou quando qualquer etapa posterior falhar por falta de ferramenta ou chave.

  1. Execute KATHA doctor. Ele exibe OK ou FALTA para cada item, com a correção.
  2. Para cada FALTA, forneça ao usuário o comando de correção exato para o sistema dele, um de cada vez. Aguarde até que ele diga que está pronto.
  3. Chaves: diga ao usuário para criar uma chave fal (https://fal.ai/dashboard/keys) e uma chave ElevenLabs (https://elevenlabs.io/app/settings/api-keys), e para adicionar crédito ao fal (US$10 é suficiente para um primeiro curta-metragem).
  4. Diga ao usuário para executar python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" setup no terminal dele. Nunca peça para ele colar uma chave no chat, e nunca digite uma chave você mesmo.
  5. Execute KATHA doctor novamente. Continue apenas com PRONTO.

NOTA: O plano gratuito do ElevenLabs não permite uso comercial. Um canal monetizado precisa do plano Starter ou superior.

1. A história (portão 1: o usuário aprova o roteiro)

  1. Pergunte, uma pergunta de cada vez: a história, o idioma, a duração (comece com 1 a 3 minutos para um primeiro filme) e o nome do canal.
  2. Execute KATHA new <pasta> --title "<título>" --language <código>.
  3. Escreva film.json: estilo, personagens com uma aparência completa cada, vozes (narrador mais uma para cada personagem falante) e as cenas. Siga references/story-craft.md.
  4. Execute KATHA validate <pasta> e corrija cada FALHA.
  5. Mostre ao usuário o roteiro como uma tabela (id, falante, tipo, fala, imagem em poucas palavras) e KATHA cost <pasta>. Altere até que ele aprove.

2. Vozes

  1. Execute KATHA voices --language <código> (adicione --gender male, --accent standard ou --search "old" para restringir). Dê ao usuário 3 opções para cada papel com os links de pré-visualização.
  2. Quando ele escolher, coloque o voice_id em film.json voices. Uma voz da biblioteca funciona sem adicioná-la à conta.
  3. Apenas se a etapa de voz falhar com "voz não encontrada", execute KATHA voices --add <voice_id> --owner <owner> --name "<papel>". Isso usa um dos slots de voz da conta.
  4. Execute KATHA voice <pasta> <2 ou 3 ids> e peça ao usuário para ouvir audio/raw<id>.mp3 antes de dublar o filme completo.

3. Personagens (portão 2: o usuário aprova cada ficha)

  1. Execute KATHA sheets <pasta>, informe o preço ao usuário, depois execute com --yes após ele concordar.
  2. Olhe você mesmo para cada img/char_<id>.png com a ferramenta de Leitura. Verifique idade, rosto, figurino, cores e o número de pessoas.
  3. Mostre as fichas ao usuário. Se uma ficha estiver errada, altere a aparência daquele personagem e execute KATHA sheets <pasta> <id> --yes.

As fichas são a identidade do filme. Nunca faça imagens de cena antes da aprovação das fichas pelo usuário.

4. Imagens, voz, movimento

  1. KATHA images <pasta> (preço), depois com --yes. Ele cria apenas as imagens faltantes.
  2. Olhe para img/contact.jpg, depois abra cada imagem que parecer errada. Verifique: os personagens certos, sem pessoas extras, sem texto, sem coroa ou figurino errados, e para cada cena de fala um rosto claro de frente com a boca fechada.
  3. Refazer uma imagem ruim: melhore seu prompt de imagem, depois KATHA images <pasta> <id> --yes --redo.
  4. KATHA voice <pasta>. Ele armazena em cache cada linha, então uma segunda execução é gratuita. Refazer uma linha após uma alteração de texto com KATHA voice <pasta> <id>.
  5. KATHA talk <pasta> (preço), depois com --yes. Apenas após as imagens e a voz daquelas cenas estarem finais: uma nova imagem ou uma nova voz precisa de um novo clipe.
  6. Olhe você mesmo para cada clips/s<id>_check.jpg. Refazer um clipe que mostra letras, legendas falsas ou um rosto que mudou: KATHA talk <pasta> <id> --yes --redo.
  7. Se o filme tiver cenas de movimento: KATHA move <pasta> (preço), depois com --yes.

5. Construir e verificar (portão 3: o usuário assiste ao filme)

  1. KATHA build <pasta>. Saída: out/<slug>.mp4 e out/thumbnail.jpg.
  2. KATHA check <pasta> deve exibir PASS.
  3. KATHA frames <pasta>, depois olhe para out/frames.jpg e a miniatura você mesmo.
  4. Escreva out/youtube.md: 3 opções de título (abaixo de 70 caracteres, o nome da história mais um gancho emocional), uma descrição (2 linhas de resumo, a moral, o texto fonte da história, capítulos com timestamps das durações das cenas), 10 tags e a linha "Feito com ferramentas de IA" para a pergunta de conteúdo alterado no YouTube Studio.
  5. Peça ao usuário para assistir ao filme completo com som. Faça cada correção solicitada em sua própria etapa e depois construa novamente.

Regras que vieram de falhas reais

  • Toda cena de fala precisa de um close-up de frente, cabeça e ombros, boca fechada. Uma vista lateral ou cabeça baixa dá sincronia labial ruim.
  • Deixe o prompt de fala como o padrão ".". Um prompt com a linha falada, ou com palavras como "sem legendas", fez o Kling desenhar texto de legenda falso nos testes. Kling não tem prompt negativo.
  • Escreva "um homem adulto com cerca de 30 anos (não uma criança)" para deuses adultos. Sem isso, o modelo frequentemente desenha Krishna e outros como crianças.
  • Escreva o que um personagem NÃO deve vestir quando uma cena arrisca isso ("sem coroa, sem joias" para um brâmane pobre), porque o modelo copia o figurino do outro personagem no quadro.
  • Mantenha cada linha abaixo de cerca de 250 caracteres. Divida uma fala longa em 2 cenas com 2 imagens.
  • Não copie o roteiro, personagens ou miniaturas de outro canal. As histórias antigas são livres para serem contadas; a versão de outro canal não é.
  • O YouTube pode parar a monetização por "conteúdo inautêntico" (filmes produzidos em massa sem trabalho humano). Diga ao usuário para variar as histórias e a estrutura, e adicionar sua própria introdução ou moral com sua própria voz.

Habilidades Relacionadas