@danhachuel/thunderbolt 0.3.63 → 0.3.65

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.63
+> **Versão deste manual:** 0.3.65
 > **Pacote npm:** `@danhachuel/thunderbolt`
 > **Porta padrão da UI:** `localhost:3030`  
 > **Repositório:** [github.com/DanHachuel/thunderbolt](https://github.com/DanHachuel/thunderbolt)
@@ -128,13 +128,13 @@ Execute:
 Windows PowerShell ou MobaXterm:
 
 ```powershell
-npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.63 install
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.65 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes --prefer-online @danhachuel/thunderbolt@0.3.63 install
+npx --yes --prefer-online @danhachuel/thunderbolt@0.3.65 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.
@@ -142,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.63 install --purge-data
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.65 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.
@@ -397,6 +397,8 @@ A área **Voz, TTS e música — Azure Speech, restantes serviços e Suno** est
 
 Na criação de vídeo, abra **Configurações de áudio** e escolha **Upload** em **Modo de narração**. Use **Ficheiro de narração** para seleccionar o áudio, clique em **Guardar áudio de narração** e confirme a pré-visualização. O Thunderbolt valida que o ficheiro existe antes de criar a tarefa e encaminha o caminho ao MoneyPrinterTurbo com `--custom-audio-file`; este argumento é necessário porque o motor não persiste automaticamente o caminho carregado. São aceites ficheiros `.mp3`, `.wav`, `.m4a`, `.aac`, `.flac` e `.ogg`, guardados no storage local em `voiceovers`.
 
+O selector **Voiceover Service** oferece **Azure Speech SDK V2** e **Azure TTS V1**. Quando existe **Azure Speech key + região**, a opção V2 é preferida e o worker marca internamente a voz com `-V2`, activando o SDK Azure Speech e evitando o stream `edge_tts`. Tarefas antigas que ainda tenham `Azure TTS V1` guardado também são migradas para V2 quando essas credenciais estão configuradas. Sem credenciais Azure, o V1 continua disponível como fallback sem key; nesse caso o timeout interno do stream passa a 90 segundos para tolerar scripts longos e redes lentas. Um erro de TTS identifica explicitamente **Azure Speech / edge_tts API**, a etapa **Narração TTS** e os providers envolvidos.
+
 As notificações novas são verificadas automaticamente na sessão activa e aparecem como pop-ups no canto inferior direito, mesmo quando está aberta outra página. O pop-up não marca o registo como lido: a aba **Notificações** continua a ser o centro persistente para consultar o histórico, gerir preferências e marcar eventos como lidos. Cada ID é apresentado no máximo uma vez por sessão do navegador.
 
 | Provider | Configuração mínima | Pool suportado |
@@ -556,7 +558,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.63 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.65 install`; o instalador detecta e reutiliza o que já estiver válido.
 
 ### Niche Finder Apify
 

package/README.md

@@ -44,7 +44,7 @@ Em **Pipeline Vídeos > Criação de Vídeos** e **Automação Youtube**, a opç
 
 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.
 
-Quando uma etapa falha, a tarefa, a notificação e a página **Configurações > Logs** guardam e mostram sempre a coluna **API/Provider**, o serviço, a rota e, quando aplicável, os campos de configuração em falta. No caso do MoneyPrinterTurbo, os marcadores `LLM_PROVIDER`, `MISSING` e `INVALID` são convertidos em attribution legível; por exemplo, um erro pode indicar simultaneamente **OpenAI / NVIDIA NIM API** e **Pexels API**, em vez de apresentar apenas a mensagem genérica de credenciais adicionais. Registos históricos sem metadata são identificados explicitamente como anteriores à attribution estruturada.
+Quando uma etapa falha, a tarefa, a notificação e a página **Configurações > Logs** guardam e mostram sempre a coluna **API/Provider**, o serviço, a rota e, quando aplicável, os campos de configuração em falta. No caso do MoneyPrinterTurbo, os marcadores `LLM_PROVIDER`, `MISSING` e `INVALID` são convertidos em attribution legível; por exemplo, um erro pode indicar simultaneamente **OpenAI / NVIDIA NIM API** e **Pexels API**, em vez de apresentar apenas a mensagem genérica de credenciais adicionais. Os timeouts `azure_tts_v1`/`edge_tts` são identificados como **Azure Speech / edge_tts API**. Quando há Azure Speech key e região, o worker encaminha a voz para o SDK Azure Speech V2; sem essas credenciais, o fallback edge_tts usa um timeout interno de 90 segundos. O worker invoca o helper com `--` antes das flags MoneyPrinterTurbo, porque `mpt_agent.py` reserva esses argumentos para a CLI filha. Registos históricos sem metadata são identificados explicitamente como anteriores à attribution estruturada.
 
 ## Upload-Post — publicação para múltiplas plataformas
 
@@ -87,7 +87,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.63
+## Navegação da UI 0.3.65
 
 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

@@ -164,7 +164,7 @@ VIDEO_CONCATENATION_OPTIONS = ["Random Concatenation (Recommended)", "Sequential
 VIDEO_TRANSITION_OPTIONS = ["None", "Fade", "Dissolve"]
 VIDEO_ENCODER_OPTIONS = ["Default (Recommended)", "H.264", "H.265"]
 VOICEOVER_MODE_OPTIONS = ["Auto", "Upload", "None"]
-VOICEOVER_SERVICE_OPTIONS = ["Azure TTS V1"]
+VOICEOVER_SERVICE_OPTIONS = ["Azure Speech SDK V2", "Azure TTS V1"]
 VOICEOVER_VOLUME_OPTIONS = ["20%", "40%", "60%", "80%", "100%"]
 VOICEOVER_SPEED_OPTIONS = ["0.5x", "0.75x", "1.0x", "1.25x", "1.5x", "2.0x"]
 BACKGROUND_MUSIC_SOURCE_OPTIONS = ["Ficheiro existente", "Carregar ficheiro", "Criar via Suno API", "Random Background Music", "Sem música"]
@@ -1046,7 +1046,20 @@ def render_video_generation_settings(
                     if stored_voiceover_value and Path(stored_voiceover_value).is_file():
                         st.audio(stored_voiceover_value)
                         settings["voiceover_file"] = stored_voiceover_value
-                settings["voiceover_service"] = st.selectbox("Voiceover Service", VOICEOVER_SERVICE_OPTIONS, key=f"{prefix}_voiceover_service")
+                configured_voice_settings = read_json("settings.json", {})
+                configured_azure_voice = bool(
+                    str(configured_voice_settings.get("azure_speech_key") or "").strip()
+                    and str(configured_voice_settings.get("azure_speech_region") or "").strip()
+                )
+                voice_service_default = "Azure Speech SDK V2" if configured_azure_voice else "Azure TTS V1"
+                voice_service_index = VOICEOVER_SERVICE_OPTIONS.index(voice_service_default)
+                settings["voiceover_service"] = st.selectbox(
+                    "Voiceover Service",
+                    VOICEOVER_SERVICE_OPTIONS,
+                    index=voice_service_index,
+                    key=f"{prefix}_voiceover_service",
+                    help="Azure Speech SDK V2 usa a key/região configuradas e não depende do stream edge_tts. Azure TTS V1 usa edge_tts e pode funcionar sem key Azure.",
+                )
                 if channel is not None:
                     channel_id = str(channel.get("id") or channel.get("name") or "")
                     channel_voice = str(channel.get("default_voice") or channel.get("voice") or "").strip()

package/hermes_ui/pipeline_worker.py

@@ -324,6 +324,16 @@ def _failure_attribution(
     provider_code = str(markers["helper_provider"] or "").strip().casefold()
     combined = f"{output} {error}".casefold()
 
+    if stage == "video" and any(marker in combined for marker in ("edge_tts", "edge tts", "azure_tts_v1", "azure speech")):
+        return {
+            "failure_api": "Azure Speech / edge_tts API",
+            "failure_provider": "azure_speech, edge_tts",
+            "failure_service": "Narração TTS",
+            "failure_route": route,
+            "failure_config_fields": "",
+            "failure_stage": stage,
+        }
+
     if stage == "video" and missing:
         api_labels: list[str] = []
         provider_values: list[str] = []
@@ -567,7 +577,45 @@ def _mpt_video_language(value: Any) -> str:
     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]:
+def _uses_azure_speech_sdk_v2(
+    generation_settings: dict[str, Any],
+    settings: dict[str, Any] | None = None,
+) -> bool:
+    service = str(generation_settings.get("voiceover_service") or "").strip().casefold()
+    if service in {
+        "azure speech sdk v2",
+        "azure speech",
+        "azure tts v2",
+        "azure speech sdk",
+    }:
+        return True
+    if service in {"azure tts v1", "edge tts", "edge_tts"}:
+        configured = settings or {}
+        return bool(
+            str(configured.get("azure_speech_key") or "").strip()
+            and str(configured.get("azure_speech_region") or "").strip()
+        )
+    configured = settings or {}
+    return bool(
+        str(configured.get("azure_speech_key") or "").strip()
+        and str(configured.get("azure_speech_region") or "").strip()
+    )
+
+
+def _azure_speech_v2_voice_name(value: str) -> str:
+    """Mark a normal Azure voice for MPT's Azure Speech SDK V2 branch."""
+    voice = str(value or "").strip()
+    if not voice or ":" in voice or voice.casefold() == "no-voice":
+        return voice
+    if re.search(r"-v2(?:-|$)", voice, flags=re.IGNORECASE):
+        return voice
+    match = re.search(r"-(Female|Male)$", voice, flags=re.IGNORECASE)
+    if match:
+        return f"{voice[:match.start()]}-V2{voice[match.start():]}"
+    return f"{voice}-V2"
+
+
+def _moneyprinter_cli_args(task: dict[str, Any], route: str, settings: dict[str, Any] | None = None) -> 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]
@@ -606,6 +654,8 @@ def _moneyprinter_cli_args(task: dict[str, Any], route: str) -> list[str]:
     if voice_mode == "none" or voice_mode == "upload":
         args.extend(["--voice-name", "no-voice"])
     elif voice:
+        if _uses_azure_speech_sdk_v2(generation_settings, settings):
+            voice = _azure_speech_v2_voice_name(voice)
         args.extend(["--voice-name", voice])
     volume = generation_settings.get("voiceover_volume")
     speed = generation_settings.get("voiceover_speed")
@@ -678,9 +728,26 @@ def _run_video_helper(task: dict[str, Any]) -> Path:
     command = ["uv", "run", "--no-project", "--python", "3.11", "python", "mpt_agent.py"]
     if configured_root:
         command.extend(["--root", str(configured_root)])
-    command.extend(["--subject", subject])
+    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 _uses_azure_speech_sdk_v2(generation_settings, settings) and str(generation_settings.get("voiceover_mode") or "").strip().casefold() not in {"none", "upload"}:
+        missing_voice_config = [
+            field for field, value in (
+                ("azure_speech_key", settings.get("azure_speech_key")),
+                ("azure_speech_region", settings.get("azure_speech_region")),
+            ) if not str(value or "").strip()
+        ]
+        if missing_voice_config:
+            message = "Azure Speech SDK V2 foi seleccionado, mas faltam credenciais de voz."
+            metadata = _failure_attribution(task, settings, "video", error=message)
+            metadata.update({
+                "failure_api": "Azure Speech API",
+                "failure_provider": "azure_speech",
+                "failure_service": "Azure Speech SDK V2",
+                "failure_config_fields": ", ".join(missing_voice_config),
+            })
+            raise PipelineError(_failure_message(message, metadata), failure_metadata=metadata)
+    command.extend(_moneyprinter_cli_args(task, route, settings=settings))
     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:

package/integrations/moneyprinter_config.py

@@ -116,6 +116,13 @@ def build_moneyprinter_config(settings: dict[str, Any], existing: dict[str, Any]
     for settings_key, config_key in app_map.items():
         if settings_key in settings:
             app[config_key] = settings[settings_key]
+    # Edge TTS V1 is retained as a keyless fallback, but its default 30-second
+    # stream deadline is too short for longer scripts or slow networks.
+    try:
+        edge_tts_timeout = float(settings.get("edge_tts_timeout", 90))
+    except (TypeError, ValueError):
+        edge_tts_timeout = 90.0
+    app["edge_tts_timeout"] = max(30, int(edge_tts_timeout))
     # A UI can store the canonical mapping while older installations still
     # expose one legacy field per source.  Export every supported source as a
     # TOML array so MoneyPrinterTurbo can rotate keys without CSV parsing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.3.63",
+  "version": "0.3.65",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",