@danhachuel/thunderbolt 0.3.60 → 0.3.62

package/MANUAL-INSTALACAO.md

@@ -2,7 +2,7 @@
 
 Este manual descreve a instalação local da UI Thunderbolt, baseada no MoneyPrinterTurbo, utilizando o pacote npm `@danhachuel/thunderbolt`. O fluxo recomendado instala automaticamente o ambiente Python, as dependências da aplicação, as dependências do MoneyPrinterTurbo, o Streamlit e o suporte FFmpeg através de `imageio-ffmpeg`.
 
-> **Versão deste manual:** 0.3.60
+> **Versão deste manual:** 0.3.62
 > **Pacote npm:** `@danhachuel/thunderbolt`
 > **Porta padrão da UI:** `localhost:3030`  
 > **Repositório:** [github.com/DanHachuel/thunderbolt](https://github.com/DanHachuel/thunderbolt)
@@ -33,7 +33,7 @@ A área **AI Influencers > Personagens** permite criar personagens com nome, bio
 
 O backend local predefinido é **SQLite**, pelo que Personagens e Geração de Conteúdo IA podem ser usados sem credenciais externas. Abra **Configurações > Configuração API > AI Influencers > Banco de Dados Influencers** para confirmar **SQLite** ou seleccionar **Supabase**. Se seleccionar Supabase, preencha **Supabase Project URL**, **Supabase API key** e **Supabase Storage bucket**, clique em **Testar ligação do backend**, aplique primeiro `seed/references/ai_influencers_schema.sql` no SQL Editor do projecto, exponha as quatro tabelas na Data API e configure permissões/RLS adequadas. O bucket deve existir com o nome configurado, por defeito `ai-influencers`.
 
-Se pretender trabalhar sem serviço externo, seleccione **SQLite** no selector da aba **Configuração API > AI Influencers** e indique o caminho do ficheiro. O padrão é `storage/state/ai_influencers.db`; o SQLite cria o schema e guarda os assets em `storage/influencers/`. Apenas um backend é usado de cada vez. A aba **AI Influencers** mostra o estado e permite editar directamente o selector, os campos Supabase e o caminho SQLite.
+Se pretender trabalhar sem serviço externo, seleccione **SQLite** no selector da aba **Configuração API > AI Influencers** e indique o caminho do ficheiro. O padrão é `storage/state/ai_influencers.db`; o SQLite cria o schema e guarda os assets em `storage/influencers/`. Apenas um backend é usado de cada vez. A aba **AI Influencers** mostra o estado e permite editar directamente o selector, os campos Supabase e o caminho SQLite. A base fica na pasta persistente do Thunderbolt, fora da instalação temporária do pacote npm; numa actualização normal, personagens, assets e configurações são preservados. O instalador também procura uma base `ai_influencers.db` válida em instalações anteriores do cache npm e recupera-a sem substituir uma base persistente já existente.
 
 Em **AI Influencers > Geração de Conteúdo IA**, utilize as subabas **Imagens**, **Vídeos** e **Motion Control**. Seleccione um personagem, prompt e destinos sociais. A subaba **Imagens** usa o pool de imagem configurado em **Imagem e Video**. A subaba **Vídeos** requer uma imagem inicial e usa o pool de vídeo; escolha o provider/modelo no cartão configurado, sem dependência obrigatória do Veo 3.1. KIE AI, Replicate e FAL AI podem usar tarefas assíncronas; o Thunderbolt consulta o estado e guarda o resultado local antes da revisão. Na Replicate, o campo Modelo deve ser o identificador do modelo ou da versão, e os inputs específicos dependem do modelo configurado.
 
@@ -41,6 +41,20 @@ A geração guarda prompt, caption, provider, modelo, plataforma, estado e camin
 
 O runtime do Thunderbolt adapta o comportamento dos workflows do episódio 35, mas não instala nem executa n8n. Formulários, Data Tables, Switch, Wait e subworkflows são substituídos por páginas Streamlit, repository Supabase/SQLite, adapters multimédia, worker, logs e notificações. Nunca coloque API keys nos JSONs dos workflows, em ficheiros versionados ou em mensagens de diagnóstico.
 
+## Pipeline de vídeo: fontes, composição e ordem
+
+Em **Pipeline Vídeos > Criação de Vídeos** e **Automação Youtube**, seleccione a fonte no próprio vídeo ou na automação. **Pexels/Pixabay** é a rota stock e usa a infraestrutura do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo): pesquisa por keywords, filtros de proporção e duração, cache e deduplicação de clips, descarga de materiais e composição MoviePy/FFmpeg com concatenação, transições, narração, legendas e música de fundo. A fonte escolhida é passada explicitamente ao processo (`pexels` ou `pixabay`) e as listas de API keys são sincronizadas no `config.toml`, permitindo a rotação configurada.
+
+A execução segue sempre **Tema → Script → Título → Keywords (opcional) → Vídeo → Prompt Thumbnail (JSON) → Thumbnail (imagem) → Upload**. Keywords são opcionais: se a geração por LLM falhar, é usado um fallback determinístico para não bloquear a etapa de vídeo. O worker guarda o MP4 antes de iniciar prompt ou imagem da thumbnail; assim, uma falha de quota na imagem não elimina um vídeo concluído.
+
+| Opção visível | Rota executada | Resultado esperado |
+|---|---|---|
+| Pexels/Pixabay | MoneyPrinterTurbo stock com a fonte efectiva e as chaves correspondentes | MP4 composto localmente |
+| Full IA | Pool de vídeo limitado a FAL AI, KIE AI e Agnes AI | MP4 gerado pelo provider activo |
+| Apenas Música | Áudio local/Suno já preparado | Ficheiro musical pronto para um upload de música; não gera MP4, thumbnail nem upload YouTube |
+
+Antes de iniciar a rota stock, confirme em **Configurações > Configuração API > Fontes de materiais** que existe pelo menos uma API key para a fonte efectiva. Sem uma key Pexels/Pixabay, o erro é apresentado como configuração da fonte, em vez de uma falha genérica de vídeo. **Google Lyria não é apresentado como implementado nesta release**; a rota Apenas Música aceita áudio local e a integração Suno existente.
+
 ## 2. Pré-requisitos
 
 Instale os seguintes componentes antes de executar o instalador:
@@ -114,13 +128,13 @@ Execute:
 Windows PowerShell ou MobaXterm:
 
 ```powershell
-npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.60 install
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.62 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes --prefer-online @danhachuel/thunderbolt@0.3.60 install
+npx --yes --prefer-online @danhachuel/thunderbolt@0.3.62 install
 ```
 
 A instalação normal é **segura para actualizações**: preserva `storage`, Blueprints, Brandings, configurações e artefactos do utilizador. Remove apenas `.venv`, o clone técnico do MoneyPrinterTurbo e dependências que serão recriadas. Uma pasta antiga sem dados do utilizador, como `C:\Users\<utilizador>\AppData\Local\hermes` da tentativa incompleta, pode ser removida; uma pasta antiga que contenha Blueprints, Brandings ou storage é preservada e apenas avisada no terminal. Feche processos Python, Node, Streamlit e MobaXterm que estejam a usar as pastas antes de executar.
@@ -128,7 +142,7 @@ A instalação normal é **segura para actualizações**: preserva `storage`, Bl
 Se quiser apagar absolutamente tudo de forma intencional, use o comando destrutivo separado:
 
 ```powershell
-npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.60 install --purge-data
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.62 install --purge-data
 ```
 
 O parâmetro `--purge-data` apaga Blueprints, Brandings, configurações, storage e artefactos locais. Não o use numa actualização normal.
@@ -542,7 +556,7 @@ Ao abrir a página, o Thunderbolt não prepara dados públicos, não descarrega
 
 Os parâmetros da UI são número de clusters entre 2 e 10, suporte mínimo entre 0,01 e 0,50, país, engagement, intervalo de datas e tags, todos dentro da área principal da aba. O núcleo normaliza os dados, calcula engagement, aplica filtros, faz transformação logarítmica e standardização, executa K-Means e calcula itemsets/regras com FP-Growth. Não são apresentados resultados até ao primeiro clique em **Analisar Nichos**; o mesmo botão aplica alterações posteriores aos filtros. Os resultados são DataFrames de clusters, itemsets frequentes, regras de associação e dados analisados; o gráfico de dispersão é criado nativamente com Plotly.
 
-As dependências adicionais — `scikit-learn`, `mlxtend`, `plotly`, `seaborn`, `matplotlib` e `kagglehub` — são instaladas pelo procedimento normal de `npx`. Em instalações existentes, execute novamente `npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.60 install`; o instalador detecta e reutiliza o que já estiver válido.
+As dependências adicionais — `scikit-learn`, `mlxtend`, `plotly`, `seaborn`, `matplotlib` e `kagglehub` — são instaladas pelo procedimento normal de `npx`. Em instalações existentes, execute novamente `npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.62 install`; o instalador detecta e reutiliza o que já estiver válido.
 
 ### Niche Finder Apify
 

package/README.md

@@ -2,7 +2,7 @@
 
 > Consulte o [Manual completo de instalação](MANUAL-INSTALACAO.md) antes do primeiro teste local.
 
-Thunderbolt — UI web local da Fase 3, baseada no fluxo Streamlit do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo). A aplicação organiza canais, blueprints, lotes de vídeos, filas, artefactos e upload em armazenamento local JSON.
+Thunderbolt — UI web local da Fase 3, baseada no fluxo Streamlit do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo). A aplicação organiza canais, blueprints, lotes de vídeos, filas, artefactos e upload em armazenamento local JSON. O pacote npm distribui apenas os seeds versionados em `seed/`; não inclui `storage/` persistente, pelo que Blueprints, personagens, configurações e artefactos locais não são enviados durante uma actualização.
 
 ## Estado actual
 
@@ -32,12 +32,18 @@ A primeira versão implementa a camada UI independente com:
 
 A área **AI Influencers > Personagens** permite guardar um personagem com nome, biografia, idioma, Instagram Business ID opcional, várias imagens de referência e documentos `.md` ou `.json`. O campo **Idioma** é um selector que reutiliza exactamente a lista, os códigos e os labels visuais de **Pipeline Vídeos > Criação de Vídeos**. Cada asset é validado, sanitizado, deduplicado por SHA-256 e guardado separado do perfil; imagens têm pré-visualização e documentos são mostrados como Markdown ou JSON estruturado.
 
-O backend local predefinido é **SQLite**, por isso Personagens e Geração de Conteúdo IA funcionam imediatamente sem credenciais externas. Em **Configurações > Configuração API > AI Influencers > Banco de Dados Influencers**, pode manter **SQLite** ou seleccionar **Supabase** quando quiser uma base remota; nesse caso, configure o **Supabase Project URL**, a **Supabase API key** e o bucket de Storage, aplique `seed/references/ai_influencers_schema.sql` no SQL Editor e confirme Data API/RLS. SQLite cria localmente `storage/state/ai_influencers.db` e `storage/influencers/`; apenas um backend fica activo de cada vez. A aba **AI Influencers** mostra o estado actual e permite editar directamente o selector, as credenciais Supabase, o bucket de Storage e o caminho do SQLite. O botão **Testar ligação do backend** é read-only e não bloqueia a utilização local.
+O backend local predefinido é **SQLite**, por isso Personagens e Geração de Conteúdo IA funcionam imediatamente sem credenciais externas. Em **Configurações > Configuração API > AI Influencers > Banco de Dados Influencers**, pode manter **SQLite** ou seleccionar **Supabase** quando quiser uma base remota; nesse caso, configure o **Supabase Project URL**, a **Supabase API key** e o bucket de Storage, aplique `seed/references/ai_influencers_schema.sql` no SQL Editor e confirme Data API/RLS. SQLite cria localmente `storage/state/ai_influencers.db` e `storage/influencers/`; apenas um backend fica activo de cada vez. A aba **AI Influencers** mostra o estado actual e permite editar directamente o selector, as credenciais Supabase, o bucket de Storage e o caminho do SQLite. O botão **Testar ligação do backend** é read-only e não bloqueia a utilização local. A base SQLite fica na pasta persistente do Thunderbolt, fora da instalação temporária do pacote npm; durante uma actualização normal, personagens, assets e configurações são preservados. Se uma versão anterior tiver guardado `ai_influencers.db` no cache npm, o instalador procura uma cópia válida e recupera-a sem substituir uma base persistente já existente.
 
 A página **AI Influencers > Geração de Conteúdo IA** contém as subabas **Imagens**, **Vídeos** e **Motion Control**. Imagens usam os cartões activos do **Pool Imagem**; Vídeos usam os cartões activos do **Pool Vídeo** e exigem uma imagem inicial image-to-video. O selector de modelo não está preso ao Veo 3.1: pode utilizar KIE AI, Replicate, FAL AI, Pollinations ou outro cartão que declare suporte para vídeo. Para Replicate, o campo Modelo deve conter o identificador aceito pela API, como `owner/model` ou `owner/model:version`; a tarefa usa `POST /v1/predictions`, consulta o estado assíncrono e guarda o resultado localmente. A publicação para Instagram, TikTok, YouTube Shorts ou Facebook não é automática: os destinos são registados para revisão e o envio exige uma acção posterior explícita.
 
 A migração é baseada no workflow público [AI Agents A-Z — episódio 35](https://github.com/gyoridavid/ai_agents_az/tree/main/episode_35), mas o runtime do Thunderbolt não instala nem executa n8n. Os formulários, Data Tables, waits e subworkflows são substituídos pela UI Streamlit, pelo repositório dual Supabase/SQLite, pelos adapters multimédia e pelos logs/notificações locais. As API keys são sempre configuradas localmente e não devem ser colocadas nos JSONs do workflow ou no GitHub.
 
+## Pipeline de vídeo — fontes e ordem de execução
+
+Em **Pipeline Vídeos > Criação de Vídeos** e **Automação Youtube**, a opção **Pexels/Pixabay** usa a rota stock do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo): as keywords do roteiro são encaminhadas para a pesquisa da fonte seleccionada, os clips são descarregados e reutilizados localmente, e o motor faz a composição com MoviePy/FFmpeg, respeitando proporção, duração máxima, concatenação, transições, correspondência visual ao roteiro, narração, legendas e música de fundo. As API keys de Pexels e Pixabay são exportadas para o `config.toml` do motor e a fonte efectiva é encaminhada por tarefa, sem depender apenas da fonte global guardada nas configurações.
+
+A ordem persistida da criação é **Tema → Script → Título → Keywords opcional → Vídeo → Prompt Thumbnail em JSON → Thumbnail → Upload**. O vídeo é materializado antes do prompt e da imagem da thumbnail; uma falha posterior de thumbnail não invalida um MP4 já pronto. **Full IA** é uma rota separada e usa exclusivamente os cartões activos FAL AI, KIE AI e Agnes AI do pool de vídeo. **Apenas Música** não chama a pipeline de vídeo nem tenta gerar thumbnail: reutiliza o áudio local/Suno já descarregado e deixa-o pronto para a integração de upload musical.
+
 ## Upload-Post — publicação para múltiplas plataformas
 
 A página **Upload** contém quatro subabas: **Upload convencional**, **Upload directo**, **Postiz** e **Upload-Post**. A quarta alternativa usa a API oficial do [Upload-Post](https://docs.upload-post.com/) para enviar um vídeo local para uma ou mais plataformas ligadas ao perfil configurado. Seleccione as plataformas na própria subaba, confirme o título e a descrição e clique em **Enviar vídeo pelo Upload-Post**.
@@ -79,7 +85,7 @@ No topo da área principal da aplicação existe o menu nativo de idioma no padr
 
 A UI suporta os temas **Dark** e **Light** através do menu nativo de três pontos do Streamlit, no local original do toolbar. Não existe um selector Theme adicional dentro da página. A configuração distribuída em `.streamlit/config.toml` disponibiliza as variantes nomeadas **Dark** e **Light**, e o menu nativo continua responsável por alternar entre os modos, seguindo o padrão do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo). O CSS próprio do Thunderbolt usa cores semânticas, `currentColor` e `color-mix` para acompanhar o tema activo, sem alterar a posição nem a funcionalidade do toolbar, do botão Deploy e do menu principal.
 
-## Navegação da UI 0.3.60
+## Navegação da UI 0.3.62
 
 A barra lateral mantém os níveis principais, nesta ordem: **Início**, **Niche Finder**, **Pipeline**, **Pipeline TikTok**, **Automação**, **Edição**, **AI Influencers** e **Configurações**. **Pipeline Vídeos** é expansível e contém **Criação de Vídeos**, **Backlog Vídeos**, **Roteiros**, **Thumbnails** e **Upload**. **Pipeline Música** é expansível e contém **Criação de Músicas** e **Upload Música**. **Automação** também é expansível e contém **Automação Youtube**. **Edição** é expansível e contém **Limpador de Metadados**, **Cortes**, **Editor Python** e **Download Mídia**, nessa ordem. **AI Influencers** é expansível e contém **Personagens**, **Geração de Conteúdo IA**, **Redes Sociais**, **Tutorial Meta** e **Tutorial Supabase**, nessa ordem. A página Geração de Conteúdo IA divide-se em **Imagens**, **Vídeos** e **Motion Control**; a subaba Motion Control permanece vazia nesta release.
  **Niche Finder** é expansível e contém **Niche Finder Kaggle** e **Niche Finder Apify**. **Configurações** é expansível e contém **Canais Youtube**, **Blueprints Youtube**, **MCP**, **Contas Google**, **Notificações**, **Logs** e **Configuração API**, nessa ordem. O Início reúne o dashboard e as filas do Pipeline, sem botões de acções rápidas.

package/app/main.py

@@ -97,6 +97,7 @@ AI_STYLE_OPTIONS = [
 ]
 
 WIDE_STYLE_OPTIONS = ["Pexels/Pixabay", "full_ia", "Apenas Música"]
+MATERIAL_SOURCE_OPTIONS = ["Pexels", "Pixabay"]
 
 VIDEO_LANGUAGE_OPTIONS = [
     "00 – Apenas Música de Fundo (Sem Falas)",
@@ -993,6 +994,18 @@ def render_video_generation_settings(
             video_cols = st.columns(2)
             with video_cols[0]:
                 settings["video_source"] = st.selectbox("Video Source", WIDE_STYLE_OPTIONS, key=f"{prefix}_video_source")
+                if settings["video_source"] == "Pexels/Pixabay":
+                    configured_material_source = selected_material_source(read_json("settings.json", {}))
+                    material_source_labels = {"pexels": "Pexels", "pixabay": "Pixabay"}
+                    configured_material_label = material_source_labels.get(configured_material_source, "Pexels")
+                    settings["material_source"] = st.selectbox(
+                        "Stock Material Source",
+                        MATERIAL_SOURCE_OPTIONS,
+                        index=MATERIAL_SOURCE_OPTIONS.index(configured_material_label),
+                        key=f"{prefix}_material_source",
+                    )
+                else:
+                    settings["material_source"] = ""
                 if settings["video_source"] == "full_ia":
                     settings["style_ia"] = st.selectbox("Estilo IA", AI_STYLE_OPTIONS, key=f"{prefix}_style_ia")
                 else:
@@ -2037,6 +2050,7 @@ def _create_video_task_from_saved_script(record: dict[str, Any], channel: dict[s
         "format": settings.get("video_format", "wide"),
         "style_wide": style,
         "style_ia": settings.get("style_ia", ""),
+        "material_source": settings.get("material_source", "") if style == "pexels" else "",
         "music_mode": style == "music",
         "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"),
         "voice": str(settings.get("voice") or channel.get("default_voice") or channel.get("voice") or ""),
@@ -2266,6 +2280,12 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                     ),
                 )
             wide_style_label = generation_settings["video_source"]
+            style = {"Pexels/Pixabay": "pexels", "full_ia": "full_ia", "Apenas Música": "music"}[wide_style_label]
+            material_source = (
+                {"Pexels": "pexels", "Pixabay": "pixabay"}.get(str(generation_settings.get("material_source") or ""), "")
+                if style == "pexels"
+                else ""
+            )
             style_ia = generation_settings.get("style_ia", "")
             music_path = ""
             music_source = ""
@@ -2469,7 +2489,6 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                 submitted = st.form_submit_button("Criar tarefas", type="primary")
             if submitted:
                 save_video_language(language)
-                style = {"Pexels/Pixabay": "pexels", "full_ia": "full_ia", "Apenas Música": "music"}[wide_style_label]
                 if style == "music" and not music_path:
                     st.error("Escolha, carregue ou gere uma música antes de criar o vídeo Apenas Música.")
                     st.stop()
@@ -2517,8 +2536,8 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                             st.session_state[f"{prefix}_general_topics"] = {cid: {"topic": payload["topic"], "topic_source": payload.get("topic_source", "llm")} for cid, payload in payloads.items()}
                     if len(payloads) == len(selected):
                         batch_topic = "Lote geral — um vídeo independente por canal"
-                        channel_payloads = {cid: {**payload, "language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings} for cid, payload in payloads.items()}
-                        batch = create_batch("general", selected, batch_topic, 1, {"language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings, "topic_source": "llm", "channel_payloads": channel_payloads})
+                        channel_payloads = {cid: {**payload, "language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "material_source": material_source, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings} for cid, payload in payloads.items()}
+                        batch = create_batch("general", selected, batch_topic, 1, {"language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "material_source": material_source, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings, "topic_source": "llm", "channel_payloads": channel_payloads})
                         tasks = create_tasks_for_batch(batch)
                         st.success(f"Lote geral {batch['id']} criado com {len(tasks)} tarefas independentes, uma por canal.")
                 else:
@@ -2542,8 +2561,8 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                             except CreativeGenerationError as exc:
                                 st.warning(f"Título/keywords automáticos pendentes: {exc} A tarefa será criada com o tópico como título; o prompt e a imagem da thumbnail serão gerados depois do vídeo.")
                                 payload = {"topic": topic_value, "title": topic_value, "topic_source": "manual", "thumbnail_status": "pending_provider", "thumbnail_variants": [], "thumbnail_variant": {}, "thumbnail_prompt": "", "thumbnail_text": ""}
-                        payload.update({"topic": topic_value, "topic_source": payload.get("topic_source") or _video_topic_source(topic_value), "language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings})
-                        batch = create_batch(mode, selected, topic_value, quantity_value, {"language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings, "topic_source": payload.get("topic_source", "manual"), "channel_payloads": {selected[0]: payload}})
+                        payload.update({"topic": topic_value, "topic_source": payload.get("topic_source") or _video_topic_source(topic_value), "language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "material_source": material_source, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings})
+                        batch = create_batch(mode, selected, topic_value, quantity_value, {"language": language, "format": fmt, "style_wide": style, "style_ia": style_ia, "material_source": material_source, "music_mode": style == "music", "background_mode": "none" if style == "music" else ("ai" if style == "full_ia" else "stock"), "music_path": music_path, "music_source": music_source, "generation_settings": generation_settings, "topic_source": payload.get("topic_source", "manual"), "channel_payloads": {selected[0]: payload}})
                         tasks = create_tasks_for_batch(batch)
                         st.success(f"Lote {batch['id']} criado com {len(tasks)} tarefa(s). Abra {ui_text('Backlog Vídeos', current_ui_language())} para acompanhar.")
 

package/hermes_ui/automation_worker.py

@@ -10,6 +10,7 @@ from typing import Any
 from . import storage
 from .creative_generation import generate_title_and_keywords, generate_topic_for_channel
 from .domain import create_batch, create_tasks_for_batch
+from .material_sources import selected_material_source
 from .notifications import record_notification
 
 WORKER_STATE_FILE = "automation_worker.json"
@@ -156,6 +157,8 @@ def _creative_payload(channel: dict[str, Any]) -> tuple[str, dict[str, Any]]:
         blueprint,
         language=str(channel.get("language") or "Português"),
     )
+    style_wide = str(channel.get("style_wide") or "pexels").strip().casefold()
+    material_source = selected_material_source(settings) if style_wide in {"pexels", "pexels/pixabay", "stock"} else ""
     payload = {
         "topic": topic_package["topic"],
         "topic_source": "llm",
@@ -169,7 +172,8 @@ def _creative_payload(channel: dict[str, Any]) -> tuple[str, dict[str, Any]]:
         "blueprint_id": str(channel.get("default_blueprint_id") or channel.get("blueprint_id") or ""),
         "blueprint_name": str(blueprint.get("name") or "SEM BLUEPRINT CONFIGURADO"),
         "voice": str(channel.get("default_voice") or channel.get("voice") or ""),
-        "generation_settings": {"video_keywords": editorial.get("keywords", [])},
+        "material_source": material_source,
+        "generation_settings": {"video_keywords": editorial.get("keywords", []), "material_source": material_source},
         "ai_generation": {"topic": topic_package, "editorial": editorial},
     }
     return topic_package["topic"], payload
@@ -204,6 +208,7 @@ def _create_channel_batch(channel: dict[str, Any], when: datetime) -> dict[str,
         "format": "wide",
         "style_wide": style_wide,
         "style_ia": channel.get("style_ia") or "",
+        "material_source": payload.get("material_source") or "",
         "music_mode": music_mode,
         "background_mode": "none" if music_mode else ("ai" if style_wide == "full_ia" else "stock"),
         "music_path": channel.get("music_path") or "",

package/hermes_ui/domain.py

@@ -160,6 +160,7 @@ def create_tasks_for_batch(batch: dict[str, Any]) -> list[dict[str, Any]]:
                 "language": payload.get("language", options.get("language", channel.get("language", "Português"))),
                 "format": payload.get("format", options.get("format", "wide")),
                 "style_wide": payload.get("style_wide", options.get("style_wide", channel.get("style_wide", "pexels"))),
+                "material_source": payload.get("material_source", options.get("material_source", channel.get("material_source", ""))),
                 "style_ia": payload.get("style_ia", options.get("style_ia", "")),
                 "music_mode": payload.get("music_mode", options.get("music_mode", False)),
                 "music_path": payload.get("music_path", options.get("music_path", "")),

package/hermes_ui/influencers.py

@@ -211,14 +211,21 @@ class InfluencerBackendError(RuntimeError):
     """Raised when the selected database backend is unavailable or misconfigured."""
 
 
+def _resolve_sqlite_path(path: str | Path | None = None) -> Path:
+    raw_path = Path(path or (STORAGE / "state" / "ai_influencers.db")).expanduser()
+    if raw_path.is_absolute():
+        return raw_path.resolve()
+    parts = raw_path.parts
+    if parts and parts[0].casefold() == "storage":
+        raw_path = Path(*parts[1:]) if len(parts) > 1 else Path("state") / "ai_influencers.db"
+    return (STORAGE / raw_path).resolve()
+
+
 class SQLiteInfluencerRepository:
     backend = "SQLite"
 
     def __init__(self, path: str | Path | None = None):
-        candidate = Path(path or (STORAGE / "state" / "ai_influencers.db"))
-        if not candidate.is_absolute():
-            candidate = ROOT / candidate
-        self.path = candidate.resolve()
+        self.path = _resolve_sqlite_path(path)
         self.path.parent.mkdir(parents=True, exist_ok=True)
 
     def ensure_schema(self) -> None:
@@ -511,8 +518,7 @@ class SupabaseInfluencerRepository:
 
 def sqlite_path_from_settings(settings: Mapping[str, Any]) -> Path:
     raw = str(settings.get("influencer_sqlite_path") or "storage/state/ai_influencers.db").strip()
-    path = Path(raw).expanduser()
-    return path if path.is_absolute() else ROOT / path
+    return _resolve_sqlite_path(raw)
 
 
 def backend_name(settings: Mapping[str, Any]) -> str:

package/hermes_ui/media_generation.py

@@ -489,9 +489,13 @@ def generate_video_from_pool(
     *,
     image_url: str = "",
     output_path: Path | None = None,
+    allowed_providers: set[str] | None = None,
 ) -> Path:
-    """Try eligible video cards in priority order, keeping image and video pools separate."""
+    """Try eligible video cards in priority order, optionally restricted to a route."""
     cards = media_cards_for_pool(settings, "video")
+    if allowed_providers is not None:
+        allowed = {str(provider).strip().lower() for provider in allowed_providers}
+        cards = [card for card in cards if str(card.get("provider") or "").strip().lower() in allowed]
     if not cards:
         raise MediaGenerationError("Não existem providers activos no pool de vídeo.")
     errors: list[str] = []

package/hermes_ui/pipeline_worker.py

@@ -11,6 +11,7 @@ from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any
 
+from integrations.moneyprinter_config import sync_moneyprinter_config
 from integrations.upload_routing import upload_with_default_route
 from hermes_ui.creative_generation import CreativeGenerationError, generate_creative_package, generate_title_and_keywords, generate_thumbnail_prompt, generate_topic_for_channel
 from hermes_ui.script_documents import save_script_document
@@ -19,6 +20,7 @@ from hermes_ui.storage import STORAGE, ensure_storage, read_json, write_json
 from hermes_ui.llm_providers import active_llm_card, provider_definition
 from hermes_ui.media_generation import MediaGenerationError, _append_generation_constraints, generate_image_from_pool, generate_video_from_pool
 from hermes_ui.media_providers import media_cards_for_pool
+from hermes_ui.material_sources import material_api_keys, selected_material_source
 from hermes_ui.thumbnail_generation import ThumbnailGenerationError, generate_thumbnail_image
 
 PIPELINE_LOCK_FILENAME = "pipeline_worker.lock"
@@ -324,6 +326,156 @@ def _stop_process(process: subprocess.Popen[str]) -> None:
         process.wait()
 
 
+def _normalise_video_route(task: dict[str, Any], settings: dict[str, Any]) -> str:
+    """Resolve the per-task source without conflating stock, AI and music routes."""
+    generation_settings = task.get("generation_settings") if isinstance(task.get("generation_settings"), dict) else {}
+    if bool(task.get("music_mode")):
+        return "music"
+    explicit_source = str(
+        task.get("material_source")
+        or generation_settings.get("material_source")
+        or generation_settings.get("video_material_source")
+        or ""
+    ).strip().casefold()
+    if explicit_source in {"pexels", "pixabay", "local"}:
+        return explicit_source
+    raw = str(task.get("style_wide") or generation_settings.get("video_source") or "pexels").strip().casefold()
+    if raw in {"full_ia", "full ia", "full-ai", "ai", "ia"}:
+        return "full_ia"
+    if raw in {"music", "apenas música", "apenas musica", "only music"}:
+        return "music"
+    if raw in {"pixabay", "pixabay only"}:
+        return "pixabay"
+    if raw in {"pexels", "pexels/pixabay", "stock", "materials", "materiales"}:
+        configured = selected_material_source(settings)
+        return configured if configured in {"pexels", "pixabay"} else "pexels"
+    return raw if raw in {"pexels", "pixabay", "local"} else "pexels"
+
+
+def _mpt_aspect_ratio(value: Any, format_value: Any = "") -> str:
+    raw = str(value or format_value or "").strip().casefold()
+    if raw in {"landscape 16:9", "wide", "16:9", "landscape"}:
+        return "16:9"
+    if raw in {"square 1:1", "square", "1:1"}:
+        return "1:1"
+    return "9:16"
+
+
+def _mpt_concat_mode(value: Any) -> str:
+    raw = str(value or "").strip().casefold()
+    return "sequential" if raw in {"sequential", "sequential concatenation", "ordem sequencial"} else "random"
+
+
+def _mpt_transition_mode(value: Any) -> str:
+    raw = str(value or "").strip().casefold()
+    return {"fade": "fade-in", "dissolve": "fade-out", "fade-in": "fade-in", "fade-out": "fade-out"}.get(raw, "none")
+
+
+def _mpt_percent(value: Any, fallback: float = 1.0) -> str:
+    raw = str(value or "").strip().replace("%", "")
+    try:
+        return str(max(0.0, min(2.0, float(raw) / 100.0)))
+    except ValueError:
+        return str(fallback)
+
+
+def _valid_audio_artifact(value: Any) -> Path | None:
+    path = _valid_artifact_path(value)
+    if path is None or path.suffix.lower() not in {".mp3", ".wav", ".m4a", ".aac", ".flac", ".ogg"}:
+        return None
+    return path
+
+
+def _mpt_rate(value: Any, fallback: float = 1.0) -> str:
+    raw = str(value or "").strip().casefold().replace("x", "")
+    try:
+        return str(max(0.1, float(raw)))
+    except ValueError:
+        return str(fallback)
+
+
+def _mpt_video_language(value: Any) -> str:
+    """Convert common Thunderbolt labels to the language codes accepted by MPT."""
+    raw = str(value or "").strip()
+    folded = raw.casefold()
+    aliases = {
+        "português": "pt-BR", "portugues": "pt-BR", "português (brasil)": "pt-BR",
+        "portuguese": "pt-BR", "inglês": "en-US", "ingles": "en-US", "english": "en-US",
+        "espanhol": "es-ES", "español": "es-ES", "francês": "fr-FR", "frances": "fr-FR",
+        "alemão": "de-DE", "alemao": "de-DE", "italiano": "it-IT", "japonês": "ja-JP",
+        "japones": "ja-JP", "mandarim": "zh-CN", "chinês": "zh-CN", "chines": "zh-CN",
+    }
+    if folded in aliases:
+        return aliases[folded]
+    return raw if re.fullmatch(r"[A-Za-z]{2,3}(?:-[A-Za-z]{2,4})?", raw) else ""
+
+
+def _moneyprinter_cli_args(task: dict[str, Any], route: str) -> list[str]:
+    """Build the explicit MPT CLI contract for the stock Pexels/Pixabay route."""
+    generation_settings = task.get("generation_settings") if isinstance(task.get("generation_settings"), dict) else {}
+    args: list[str] = ["--video-source", route]
+    script = str(task.get("video_script") or generation_settings.get("video_script") or "").strip()
+    if script:
+        args.extend(["--video-script", script])
+    keywords = task.get("video_keywords") or generation_settings.get("video_keywords") or task.get("keywords") or task.get("tags")
+    if isinstance(keywords, str):
+        keywords = [part.strip() for part in re.split(r"[,;|\n]+", keywords) if part.strip()]
+    if isinstance(keywords, list):
+        terms = [str(item).strip() for item in keywords if str(item).strip()]
+        if terms:
+            args.extend(["--video-terms", ",".join(terms[:15])])
+
+    language = _mpt_video_language(task.get("language"))
+    if language:
+        args.extend(["--video-language", language])
+    format_value = str(task.get("format") or generation_settings.get("video_format") or "").strip().casefold()
+    if format_value in {"wide", "landscape", "16:9"}:
+        aspect_ratio = "16:9"
+    elif format_value in {"shorts", "portrait", "9:16"}:
+        aspect_ratio = "9:16"
+    else:
+        aspect_ratio = _mpt_aspect_ratio(generation_settings.get("video_aspect_ratio"), task.get("format"))
+    args.extend(["--video-aspect", aspect_ratio])
+    args.extend(["--video-concat-mode", _mpt_concat_mode(generation_settings.get("video_concatenation_mode"))])
+    args.extend(["--video-transition-mode", _mpt_transition_mode(generation_settings.get("video_transition_mode"))])
+    clip_duration = generation_settings.get("maximum_clip_duration")
+    if str(clip_duration or "").strip().isdigit() and int(clip_duration) > 0:
+        args.extend(["--video-clip-duration", str(int(clip_duration))])
+    if bool(generation_settings.get("match_visuals_to_script_order")):
+        args.append("--match-materials-to-script")
+
+    voice_mode = str(generation_settings.get("voiceover_mode") or "").strip().casefold()
+    voice = str(task.get("voice") or generation_settings.get("voice") or "").strip()
+    if voice_mode == "none" or voice_mode == "upload":
+        args.extend(["--voice-name", "no-voice"])
+    elif voice:
+        args.extend(["--voice-name", voice])
+    volume = generation_settings.get("voiceover_volume")
+    speed = generation_settings.get("voiceover_speed")
+    if volume is not None:
+        args.extend(["--voice-volume", _mpt_percent(volume)])
+    if speed is not None:
+        args.extend(["--voice-rate", _mpt_rate(speed)])
+
+    subtitles = generation_settings.get("enable_subtitles")
+    if subtitles is not None:
+        args.append("--subtitle-enabled" if bool(subtitles) else "--no-subtitle-enabled")
+    subtitle_position = str(generation_settings.get("subtitle_position") or "").strip().casefold()
+    if subtitle_position in {"top", "center", "bottom", "custom"}:
+        args.extend(["--subtitle-position", subtitle_position])
+    font_name = str(generation_settings.get("subtitle_font") or "").strip()
+    if font_name:
+        args.extend(["--font-name", font_name])
+    bgm_source = str(generation_settings.get("background_music_source") or "").strip().casefold()
+    bgm_type = {"sem música": "none", "sem musica": "none", "random background music": "random", "ficheiro existente": "custom"}.get(bgm_source)
+    if bgm_type:
+        args.extend(["--bgm-type", bgm_type])
+    bgm_volume = generation_settings.get("background_music_volume")
+    if bgm_volume is not None:
+        args.extend(["--bgm-volume", _mpt_percent(bgm_volume)])
+    return args
+
+
 def _run_video_helper(task: dict[str, Any]) -> Path:
     helper_dir = Path(__file__).resolve().parents[1] / "seed" / "skills"
     helper = helper_dir / "mpt_agent.py"
@@ -341,12 +493,27 @@ def _run_video_helper(task: dict[str, Any]) -> Path:
     card = active_llm_card(settings)
     provider = str(card.get("provider") or "openai").strip()
     definition = provider_definition(provider)
+    route = _normalise_video_route(task, settings)
+    source_keys = material_api_keys(settings, route) if route in {"pexels", "pixabay"} else []
+    if route in {"pexels", "pixabay"} and not source_keys:
+        source_label = "Pexels" if route == "pexels" else "Pixabay"
+        raise PipelineError(
+            f"Configure pelo menos uma API key de {source_label} em Configurações > Configuração API > Fontes de materiais."
+        )
+    if configured_root:
+        try:
+            sync_moneyprinter_config(settings, str(configured_root))
+        except OSError as exc:
+            raise PipelineError(f"Não foi possível sincronizar a configuração do MoneyPrinterTurbo: {exc}") from exc
     env_values = {
         "MPT_LLM_PROVIDER": provider,
         "MPT_LLM_API_KEY": str(card.get("api_key") or "").strip(),
         "MPT_LLM_BASE_URL": str(card.get("base_url") or definition.default_base_url or "").strip(),
         "MPT_LLM_MODEL_NAME": str(card.get("model") or "").strip(),
-        "MPT_PEXELS_API_KEY": str(settings.get("pexels_api_key") or "").strip(),
+        "MPT_PEXELS_API_KEY": source_keys[0] if route == "pexels" and source_keys else "",
+        "MPT_PEXELS_API_KEYS": json.dumps(source_keys, ensure_ascii=False) if route == "pexels" and source_keys else "",
+        "MPT_PIXABAY_API_KEY": source_keys[0] if route == "pixabay" and source_keys else "",
+        "MPT_PIXABAY_API_KEYS": json.dumps(source_keys, ensure_ascii=False) if route == "pixabay" and source_keys else "",
     }
     for key, value in env_values.items():
         if value:
@@ -356,6 +523,7 @@ def _run_video_helper(task: dict[str, Any]) -> Path:
         command.extend(["--root", str(configured_root)])
     command.extend(["--subject", subject])
     generation_settings = task.get("generation_settings") if isinstance(task.get("generation_settings"), dict) else {}
+    command.extend(_moneyprinter_cli_args(task, route))
     if str(generation_settings.get("voiceover_mode") or "").strip().casefold() == "upload":
         voiceover_file = Path(str(generation_settings.get("voiceover_file") or "").strip()).expanduser()
         if not str(voiceover_file) or not voiceover_file.is_file() or voiceover_file.stat().st_size <= 0:
@@ -516,8 +684,9 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
     channel = _channel_for_task(task)
     settings = _settings()
     blueprint = _blueprint_for_channel(channel)
+    route = _normalise_video_route(task, settings)
     topic = str(task.get("topic") or "").strip()
-    if not topic or str(task.get("topic_source") or "") in {"auto", "llm_pending"}:
+    if route != "music" and (not topic or str(task.get("topic_source") or "") in {"auto", "llm_pending"}):
         _update(task_id, stage="topic", state="doing", progress=5, error=None)
         topic_result = generate_topic_for_channel(settings, channel, blueprint, user_context=str(task.get("topic_context") or ""))
         topic = str(topic_result.get("topic") or "").strip()
@@ -527,6 +696,32 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
 
     generation_settings = task.get("generation_settings") if isinstance(task.get("generation_settings"), dict) else {}
     artifacts = dict(task.get("artifacts") or {})
+    if route == "music":
+        # Apenas Música não é uma tarefa de vídeo: reutiliza o áudio preparado e
+        # termina pronta para a integração de upload musical, sem chamar LLM,
+        # Pexels/Pixabay, MoviePy de vídeo, thumbnail ou upload de vídeo.
+        music_candidates = [
+            task.get("music_path"),
+            generation_settings.get("music_path"),
+            artifacts.get("music"),
+        ]
+        music_path = next((path for path in (_valid_audio_artifact(item) for item in music_candidates) if path is not None), None)
+        if music_path is None:
+            raise PipelineError("A fonte Apenas Música exige um ficheiro de áudio local válido ou uma música Suno já descarregada antes de criar a tarefa.")
+        artifacts["music"] = str(music_path)
+        _update(
+            task_id,
+            stage="upload",
+            state="done",
+            progress=100,
+            artifacts=artifacts,
+            music_ready=True,
+            video_ready=False,
+            thumbnail_status="not_applicable",
+            error=None,
+        )
+        return _task_by_id(task_id) or task
+
     script = _read_persisted_script(task, channel, blueprint, topic)
     if script is None:
         _update(task_id, stage="script", state="doing", progress=18, error=None)
@@ -618,18 +813,30 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
     existing_video = _valid_artifact_path(artifacts.get("video"))
     if existing_video is None:
         _update(task_id, stage="video", state="doing", progress=max(52, int(task.get("progress") or 0)), error=None)
-        video_cards = media_cards_for_pool(settings, "video")
-        if bool(settings.get("media_video_pool_enabled")) and video_cards:
-            try:
-                video_prompt = _append_generation_constraints(
-                    f"Título: {title}\n\nRoteiro:\n{str(script.get('content') or '')[:12000]}",
-                    kind="video",
+        try:
+            video_prompt = _append_generation_constraints(
+                f"Título: {title}\n\nRoteiro:\n{str(script.get('content') or '')[:12000]}",
+                kind="video",
+            )
+            if route == "full_ia":
+                video_path = generate_video_from_pool(
+                    settings,
+                    video_prompt,
+                    allowed_providers={"fal_ai", "kie_ai", "agnes"},
                 )
-                video_path = generate_video_from_pool(settings, video_prompt)
-            except MediaGenerationError as exc:
-                raise PipelineError(f"Pool de vídeo externo: {exc}") from exc
-        else:
-            video_path = _run_video_helper({**task, "topic": topic, "title": title})
+            else:
+                video_path = _run_video_helper({
+                    **task,
+                    "topic": topic,
+                    "title": title,
+                    "video_script": str(script.get("content") or ""),
+                    "video_keywords": keywords,
+                    "style_wide": route,
+                })
+        except MediaGenerationError as exc:
+            if route == "full_ia":
+                raise PipelineError(f"Pool Full IA (FAL/KIE AI/Agnes AI): {exc}") from exc
+            raise PipelineError(f"Pipeline MoneyPrinterTurbo ({route}): {exc}") from exc
         current_after_video = _task_by_id(task_id) or {}
         artifacts = dict(current_after_video.get("artifacts") or artifacts)
         artifacts["video"] = str(video_path)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.3.60",
+  "version": "0.3.62",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",
@@ -16,8 +16,6 @@
     "integrations/*.py",
     "integrations/data/*.json",
     "scripts/*.mjs",
-    "storage/blueprints/**/*.json",
-    "storage/tiktok/prompts_master/**/*.md",
     "seed/prompt_masters/**/*.md",
     "seed/blueprints/**/*.json",
     "seed/skills/*.md",