@danhachuel/thunderbolt 0.5.42 → 0.5.44

package/app/main.py

@@ -1516,21 +1516,30 @@ def render_growth_youtube():
                 st.error(str(exc)[:500])
     records = list_analyses()
     selected_record = next((item for item in reversed(records) if str(item.get("channel_id")) == str(selected.get("id"))), None)
-    if selected_record is None and records:
-        selected_record = records[-1]
-    metrics = selected_record.get("metrics", []) if selected_record else []
-    overall = int(selected_record.get("overall_score", 50)) if selected_record else 50
-    color = _growth_score_color(overall)
-    st.markdown(
-        f'<div style="border:1px solid #263447;border-radius:12px;padding:18px;margin:12px 0 20px;background:#101722;display:flex;align-items:center;justify-content:space-between;">'
-        f'<div><div style="font-size:13px;color:#94a3b8;text-transform:uppercase;letter-spacing:.08em;">Nota geral do canal</div><div style="font-size:18px;font-weight:700;margin-top:5px;">{str(selected.get("name") or "Canal")}</div></div>'
-        f'<div style="font-size:42px;font-weight:800;color:{color};line-height:1;">{overall}<span style="font-size:16px;color:#94a3b8;">/100</span></div></div>',
-        unsafe_allow_html=True,
-    )
-    if selected_record and selected_record.get("report_path"):
-        report_path = Path(str(selected_record["report_path"]))
-        if report_path.is_file():
-            st.download_button("BAIXAR ANALISE COMPLETA", report_path.read_bytes(), file_name=report_path.name, mime="text/markdown", key=f"growth_download_{selected_record['code']}")
+    metrics = selected_record.get("metrics", []) if selected_record else [
+        {"label": label, "score": 0, "value": "Aguardando análise", "diagnosis": "Clique em ANALISAR CANAL para preencher esta métrica."}
+        for label in ("Demanda validada", "Qualidade da thumbnail", "Qualidade do título", "Hook — retenção inicial", "Ritmo e edição", "Origem do tráfego", "Conversão em inscritos", "Cadência de publicação")
+    ]
+    overall = int(selected_record.get("overall_score", 0)) if selected_record else None
+    color = _growth_score_color(overall) if overall is not None else "#64748b"
+    score_text = str(overall) if overall is not None else "—"
+    score_suffix = "/100" if overall is not None else ""
+    summary_col, download_col = st.columns([3.25, 1], gap="large")
+    with summary_col:
+        st.markdown(
+            f'<div style="border:1px solid #263447;border-radius:12px;padding:18px;margin:12px 0 20px;background:#101722;display:flex;align-items:center;justify-content:space-between;min-height:76px;">'
+            f'<div><div style="font-size:13px;color:#94a3b8;text-transform:uppercase;letter-spacing:.08em;">Nota geral do canal</div><div style="font-size:18px;font-weight:700;margin-top:5px;">{str(selected.get("name") or "Canal")}</div></div>'
+            f'<div style="font-size:42px;font-weight:800;color:{color};line-height:1;">{score_text}<span style="font-size:16px;color:#94a3b8;">{score_suffix}</span></div></div>',
+            unsafe_allow_html=True,
+        )
+    with download_col:
+        st.write("")
+        if selected_record and selected_record.get("report_path"):
+            report_path = Path(str(selected_record["report_path"]))
+            if report_path.is_file():
+                st.download_button("BAIXAR ANALISE COMPLETA", report_path.read_bytes(), file_name=report_path.name, mime="text/markdown", use_container_width=True, key=f"growth_download_{selected_record['code']}")
+        else:
+            st.button("BAIXAR ANALISE COMPLETA", disabled=True, use_container_width=True, key="growth_download_disabled")
     st.subheader("Dashboard de Growth")
     st.caption("Vermelho: 0–30 · Amarelo: 31–69 · Verde: 70–100. Clique em ANALISAR CANAL para recolher dados públicos actualizados.")
     for row_start in range(0, len(metrics), 4):
@@ -1554,14 +1563,17 @@ def render_growth_youtube():
         if not records:
             st.info("Ainda não existem análises guardadas.")
         for record in reversed(records[-20:]):
-            row = st.columns([2, 1, 2, 1, 1.4])
+            row = st.columns([2, 1, 2.2, 1.2, 1, 1.4])
             row[0].write(f"**{record.get('channel_name', 'Canal')}**")
             row[1].write(str(record.get("platform", "YouTube")))
             row[2].caption(str(record.get("code", "")))
-            row[3].write(f"{record.get('overall_score', 0)}/100")
+            row[3].caption(str(record.get("created_at", "")).replace("T", " ")[:19])
+            row[4].write(f"{record.get('overall_score', '—')}/100" if record.get("overall_score") is not None else "—")
             report_path = Path(str(record.get("report_path") or ""))
             if report_path.is_file():
-                row[4].download_button("Análise", report_path.read_bytes(), file_name=report_path.name, mime="text/markdown", key=f"growth_history_{record.get('code')}")
+                row[5].download_button("Análise", report_path.read_bytes(), file_name=report_path.name, mime="text/markdown", key=f"growth_history_{record.get('code')}")
+            elif record.get("status") == "failed":
+                row[5].caption("Falhou")
 
 
 def render_dashboard():

package/hermes_ui/growth_youtube.py

@@ -71,9 +71,24 @@ def _download_thumbnail(video: Mapping[str, Any], directory: Path) -> str:
     directory.mkdir(parents=True, exist_ok=True)
     destination = directory / f"{video['id']}.jpg"
     if not destination.exists():
-        response = requests.get(str(video.get("thumbnail_url") or ""), timeout=30)
-        response.raise_for_status()
-        destination.write_bytes(response.content)
+        try:
+            import yt_dlp
+            options = {
+                "quiet": True,
+                "skip_download": True,
+                "writethumbnail": True,
+                "outtmpl": str(directory / f"{video['id']}.%(ext)s"),
+                "noplaylist": True,
+            }
+            with yt_dlp.YoutubeDL(options) as downloader:
+                downloader.download([str(video.get("url") or f"https://www.youtube.com/watch?v={video['id']}")])
+            generated = next(directory.glob(f"{video['id']}.*"), None)
+            if generated and generated != destination:
+                generated.replace(destination)
+        except Exception as exc:
+            raise RuntimeError(f"Não foi possível baixar a thumbnail {video['id']} com yt-dlp: {exc}") from exc
+    if not destination.exists():
+        raise RuntimeError(f"yt-dlp não gerou a thumbnail do vídeo {video['id']}.")
     return str(destination)
 
 
@@ -145,7 +160,9 @@ def _vision_prompt(video: Mapping[str, Any]) -> str:
 
 def analyse_thumbnail_with_paligemma(path: str, card: Mapping[str, Any]) -> dict[str, Any]:
     key = str(card.get("api_key") or "").strip()
-    base = str(card.get("base_url") or "https://integrate.api.nvidia.com/v1").rstrip("/")
+    base = str(card.get("base_url") or "https://ai.api.nvidia.com/v1/vlm/google/paligemma").rstrip("/")
+    if base.endswith("/v1"):
+        base = f"{base}/vlm/google/paligemma"
     model = str(card.get("model") or "google/paligemma").strip()
     if not key:
         return {"score": 50, "diagnosis": "API key NVIDIA NIM Paligemma não configurada.", "status": "sem_dados"}
@@ -154,7 +171,7 @@ def analyse_thumbnail_with_paligemma(path: str, card: Mapping[str, Any]) -> dict
         {"type": "text", "text": "Evaluate this thumbnail for YouTube Growth. Return JSON with score, diagnosis, contrast, mobile_readability, text_words, hierarchy, emotion, overlap_risk."},
         {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{data}"}},
     ]}], "max_tokens": 500, "temperature": 0.1}
-    response = requests.post(f"{base}/chat/completions", headers={"Authorization": f"Bearer {key}", "Content-Type": "application/json"}, json=payload, timeout=120)
+    response = requests.post(base, headers={"Authorization": f"Bearer {key}", "Accept": "application/json", "Content-Type": "application/json"}, json=payload, timeout=120)
     response.raise_for_status()
     content = response.json().get("choices", [{}])[0].get("message", {}).get("content", "")
     match = re.search(r"\{.*\}", str(content), flags=re.S)
@@ -165,13 +182,14 @@ def analyse_thumbnail_with_paligemma(path: str, card: Mapping[str, Any]) -> dict
 
 
 def _report_markdown(record: Mapping[str, Any]) -> str:
-    lines = [f"# CHANNEL AUDIT REPORT: {record.get('channel_name', 'Canal')}", "", f"- Código: `{record.get('code')}`", f"- Plataforma: YouTube", f"- Data: {record.get('created_at')}", f"- Nota geral: **{record.get('overall_score', 0)}/100**", "", "## Diagnóstico por métrica", "", "| Métrica | Nota | Evidência | Diagnóstico |", "|---|---:|---|---|"]
+    lines = [f"# CHANNEL AUDIT REPORT: {record.get('channel_name', 'Canal')}", "", f"- Código: `{record.get('code')}`", "- Plataforma: YouTube", f"- Data: {record.get('created_at')}", f"- Nota geral: **{record.get('overall_score', 0)}/100**", "", "## 1. Projecção financeira e contexto", "", "A análise pública não expõe RPM, país da audiência nem horas de visualização. O relatório não inventa estes valores. Para referência do agente, o YPP usa 1.000 inscritos e 4.000 horas de vídeos longos em 12 meses ou 10 milhões de visualizações de Shorts em 90 dias até 31/01/2027; a partir de 01/02/2027 a meta de Shorts indicada pelo agente é 20 milhões.", "", "## 2. Resumo do diagnóstico", "", "| Pilar | Nota | Métrica observada | Resultado |", "|---|---:|---|---|"]
+    pillar_names = {"Demanda validada": "Demanda", "Qualidade da thumbnail": "Thumbnail", "Qualidade do título": "Título", "Hook — retenção inicial": "Hook", "Ritmo e edição": "Pacing", "Origem do tráfego": "Tráfego", "Conversão em inscritos": "CTA", "Cadência de publicação": "Cadência"}
     for metric in record.get("metrics", []):
-        lines.append(f"| {metric['label']} | {metric['score']}/100 | {metric['value']} | {metric['diagnosis']} |")
-    lines += ["", "## Últimos 10 vídeos", "", "| Título | Visualizações | Thumbnail | Transcrição | Nota do título |", "|---|---:|---|---|---:|"]
+        lines.append(f"| **{pillar_names.get(metric['label'], metric['label'])}** | {metric['score']}/100 | {metric['value']} | {metric['diagnosis']} |")
+    lines += ["", "## 3. Últimos 10 vídeos", "", "| Título | Visualizações | Thumbnail | Transcrição | Nota do título |", "|---|---:|---|---|---:|"]
     for video in record.get("videos", []):
         lines.append(f"| {video.get('title', '').replace('|', '/')} | {video.get('view_count', 0):,} | {video.get('thumbnail_status', '')} | {video.get('transcript_status', '')} | {video.get('title_score', 0)}/100 |")
-    lines += ["", "## Top 3 prioridades", "", "1. Melhorar primeiro thumbnails e títulos abaixo de 70, aumentando contraste e reduzindo texto.", "2. Reforçar o hook inicial com o resultado ou promessa nos primeiros segundos.", "3. Introduzir CTA contextual e pattern interrupts ao longo do vídeo.", "", "## Limitações", "", "CTR, retenção real, origem de tráfego, RPM e horas de visualização exigem dados autorizados do YouTube Studio e não são inventados a partir da página pública."]
+    lines += ["", "## 4. Actionable Roadmap — Top 3 prioridades", "", "1. **REMAKE THUMBNAILS** dos vídeos abaixo de 70: aumentar contraste, sujeito claro, emoção forte e máximo de três palavras legíveis no telemóvel.", "2. **REWRITE TITLES** com Curiosity, Clarity e Urgency; colocar a keyword principal no início e usar números/adjectivos de poder quando forem verdadeiros.", "3. **EDIT HOOK**: começar pelo resultado, promessa ou estatística forte e introduzir pattern interrupts a cada 5–8 segundos.", "", "## 5. Estratégia de longo prazo", "", "Construir uma biblioteca de pelo menos 50 vídeos evergreen, publicar com cadência semanal fixa e procurar que Browse Features se torne a principal origem de tráfego. Para um criador solo, consistência supera frequência; melhorar Thumbnail + Título antes de alterar a produção.", "", "## Limitações", "", "CTR, retenção real, origem de tráfego, RPM e horas de visualização exigem dados autorizados do YouTube Studio e não são inventados a partir da página pública."]
     return "\n".join(lines) + "\n"
 
 
@@ -184,15 +202,32 @@ def run_audit(channel: Mapping[str, Any], settings: Mapping[str, Any], *, vision
     if not channel_url:
         raise RuntimeError("O canal seleccionado não tem URL pública ou handle YouTube.")
     notify("A buscar o canal e os 10 vídeos mais recentes…")
-    videos = _public_videos(channel_url, 10)
+    try:
+        videos = _public_videos(channel_url, 10)
+    except Exception as exc:
+        failed = {"code": code, "channel_id": str(channel.get("id") or ""), "channel_name": str(channel.get("name") or "Canal"), "platform": "YouTube", "created_at": datetime.now(timezone.utc).isoformat(), "status": "failed", "error": str(exc)[:500]}
+        analyses = read_json(ANALYSES_FILENAME, [])
+        if not isinstance(analyses, list): analyses = []
+        analyses.append(failed)
+        write_json(ANALYSES_FILENAME, analyses[-100:])
+        raise
     if not videos:
-        raise RuntimeError("Não foram encontrados vídeos públicos no canal seleccionado.")
+        failed = {"code": code, "channel_id": str(channel.get("id") or ""), "channel_name": str(channel.get("name") or "Canal"), "platform": "YouTube", "created_at": datetime.now(timezone.utc).isoformat(), "status": "failed", "error": "Não foram encontrados vídeos públicos no canal seleccionado."}
+        analyses = read_json(ANALYSES_FILENAME, [])
+        if not isinstance(analyses, list): analyses = []
+        analyses.append(failed)
+        write_json(ANALYSES_FILENAME, analyses[-100:])
+        raise RuntimeError(failed["error"])
     title_scores: list[int] = []
     transcript_scores: list[int] = []
     for index, video in enumerate(videos, 1):
         notify(f"A analisar vídeo {index}/{len(videos)}…")
-        video["thumbnail_path"] = _download_thumbnail(video, root / "thumbnails")
-        video["thumbnail_status"] = "baixada"
+        try:
+            video["thumbnail_path"] = _download_thumbnail(video, root / "thumbnails")
+            video["thumbnail_status"] = "baixada"
+        except Exception as exc:
+            video["thumbnail_path"] = ""
+            video["thumbnail_status"] = f"erro: {str(exc)[:120]}"
         text, status = _transcript(str(video["id"]))
         video["transcript_status"] = status
         video["transcript_path"] = str(root / "transcripts" / f"{video['id']}.txt")
@@ -202,7 +237,7 @@ def run_audit(channel: Mapping[str, Any], settings: Mapping[str, Any], *, vision
         video["transcript_score"], video["transcript_diagnosis"] = _analyse_transcript_with_llm(text, settings)
         title_scores.append(video["title_score"])
         transcript_scores.append(video["transcript_score"])
-        if vision_card:
+        if vision_card and video.get("thumbnail_path"):
             try: video["vision"] = analyse_thumbnail_with_paligemma(video["thumbnail_path"], vision_card)
             except Exception as exc: video["vision"] = {"score": 50, "status": "erro", "diagnosis": str(exc)[:220]}
         else: video["vision"] = {"score": 50, "status": "sem_dados", "diagnosis": "Provider Paligemma não configurado."}

package/hermes_ui/llm_providers.py

@@ -55,7 +55,7 @@ LLM_PROVIDER_CATALOG: tuple[LlmProviderDefinition, ...] = (
         "nvidia_nim_paligemma",
         "OpenAI / NVIDIA NIM (Paligemma)",
         show_base_url=True,
-        default_base_url="https://integrate.api.nvidia.com/v1",
+        default_base_url="https://ai.api.nvidia.com/v1/vlm/google/paligemma",
         supports_model_discovery=False,
         excluded_from_normal_pool=True,
         description="Provider exclusivo do Analista Growth YouTube para análise visual de thumbnails.",

package/package.json

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