@danhachuel/thunderbolt 0.2.61 → 0.2.63

package/app/main.py

@@ -22,7 +22,7 @@ except (OSError, json.JSONDecodeError):
 
 from hermes_ui.domain import STAGES, create_batch, create_channel, create_tasks_for_batch, delete_channel, pipeline_summary, set_channel_defaults, transition_task, update_channel, update_channel_video
 from hermes_ui.automation_worker import load_worker_status
-from hermes_ui.storage import BLUEPRINTS, STORAGE, ensure_storage, list_blueprint_files, load_blueprint_file, now, read_json, write_json
+from hermes_ui.storage import BLUEPRINTS, STORAGE, TIKTOK_PROMPT_MASTERS, ensure_storage, list_blueprint_files, list_prompt_master_files, load_blueprint_file, load_prompt_master_file, now, read_json, write_json
 from app.modules.niche_finder.apify import ApifyError, DEFAULT_ACTOR_ID, abort_actor_run, build_actor_input, get_dataset_items, normalize_video_items, start_actor_run, wait_for_actor_run
 from app.modules.niche_finder.core import NicheAnalysisError, run_niche_analysis
 from app.modules.niche_finder.data_loader import DatasetError, download_kaggle_dataset
@@ -711,6 +711,78 @@ def render_blueprints():
                     st.error(str(exc))
 
 
+def render_tiktok_prompt_masters():
+    st.title("Prompts Master")
+    st.caption(f"Biblioteca exclusiva para vídeos TikTok. Os ficheiros ficam em `{TIKTOK_PROMPT_MASTERS}` e nunca entram na pasta de Blueprints YouTube.")
+
+    upload_tab, library_tab = st.tabs(["Upload", "Biblioteca"])
+    with upload_tab:
+        st.subheader("Adicionar Prompt Master")
+        st.info("Use ficheiros Markdown `.md`. Cada Prompt Master é guardado como um ficheiro independente no storage TikTok.")
+        uploaded_prompt = st.file_uploader("Subir Prompt Master (.md)", type=["md"], key="tiktok_prompt_master_upload")
+        if uploaded_prompt is not None:
+            uploaded_name = Path(uploaded_prompt.name).stem
+            prompt_name = st.text_input("Nome do Prompt Master", value=uploaded_name, key="tiktok_prompt_master_name")
+            replace_prompt = st.checkbox("Permitir substituir um ficheiro existente", key="tiktok_prompt_master_replace")
+            if st.button("Guardar Prompt Master", type="primary", use_container_width=True, key="save_tiktok_prompt_master"):
+                safe_stem = re.sub(r"[^A-Za-z0-9À-ÿ._-]+", "-", prompt_name.strip() or uploaded_name).strip(".-") or "prompt-master"
+                destination = TIKTOK_PROMPT_MASTERS / f"{safe_stem}.md"
+                if destination.exists() and not replace_prompt:
+                    st.warning("Já existe um Prompt Master com esse nome. Active a substituição para o actualizar.")
+                else:
+                    try:
+                        content = uploaded_prompt.getvalue().decode("utf-8-sig")
+                        if not content.strip():
+                            raise ValueError("O ficheiro Markdown está vazio.")
+                        destination.write_text(content.rstrip() + "\n", encoding="utf-8")
+                        st.success(f"Prompt Master guardado em `{destination}`.")
+                        st.rerun()
+                    except UnicodeDecodeError:
+                        st.error("O ficheiro deve estar codificado em UTF-8.")
+                    except OSError as exc:
+                        st.error(f"Não foi possível guardar o Prompt Master: {exc}")
+
+    with library_tab:
+        files = list_prompt_master_files()
+        st.subheader(f"Prompts Master existentes ({len(files)})")
+        search = st.text_input("Pesquisar Prompt Master", key="tiktok_prompt_master_search", placeholder="Nome ou conteúdo")
+        visible_files: list[Path] = []
+        for path in files:
+            try:
+                content = load_prompt_master_file(path)
+            except (OSError, ValueError):
+                content = ""
+            if search and search.lower() not in f"{path.name}\n{content}".lower():
+                continue
+            visible_files.append(path)
+        if not visible_files:
+            st.info("Ainda não existem Prompt Master que correspondam à pesquisa.")
+        for path in visible_files:
+            try:
+                content = load_prompt_master_file(path)
+                heading = next((line.lstrip("#").strip() for line in content.splitlines() if line.startswith("#")), path.stem)
+                with st.expander(f"{heading} — {path.name}", expanded=False):
+                    st.caption(f"Ficheiro TikTok: `{path}`")
+                    edited_content = st.text_area("Conteúdo Markdown", value=content, height=360, key=f"tiktok_prompt_master_editor_{path.stem}")
+                    prompt_cols = st.columns(3)
+                    with prompt_cols[0]:
+                        if st.button("Guardar alterações", type="primary", use_container_width=True, key=f"save_prompt_master_{path.stem}"):
+                            path.write_text(edited_content.rstrip() + "\n", encoding="utf-8")
+                            st.success("Prompt Master actualizado.")
+                            st.rerun()
+                    with prompt_cols[1]:
+                        st.download_button("Descarregar", data=content.encode("utf-8"), file_name=path.name, mime="text/markdown", use_container_width=True, key=f"download_prompt_master_{path.stem}")
+                    with prompt_cols[2]:
+                        if st.button("Apagar", use_container_width=True, key=f"delete_prompt_master_{path.stem}"):
+                            path.unlink(missing_ok=True)
+                            st.success("Prompt Master removido da biblioteca TikTok.")
+                            st.rerun()
+                    st.markdown(content)
+            except (OSError, ValueError) as exc:
+                with st.expander(f"Ficheiro inválido — {path.name}"):
+                    st.error(str(exc))
+
+
 def render_channels():
     st.title("Canais Youtube")
     st.caption("Escolha entre importar dados públicos do YouTube ou preencher o canal manualmente.")
@@ -3276,6 +3348,9 @@ def main():
         ("Roteiros", ":material/article:", "Roteiros"),
         ("Upload", ":material/cloud_upload:", "Upload"),
     ]
+    pipeline_tiktok_items = [
+        ("Prompts Master", ":material/auto_awesome:", "Prompts Master"),
+    ]
     edition_items = [
         ("Limpador de Metadados", ":material/edit_note:", "Limpador de Metadados"),
         ("Cortes", ":material/content_cut:", "Cortes"),
@@ -3302,6 +3377,7 @@ def main():
         ("Início", ":material/home:", "Início"),
         ("Niche Finder", ":material/search:", "Niche Finder"),
         ("Pipeline", ":material/account_tree:", "Pipeline"),
+        ("Pipeline TikTok", ":material/video_library:", "Pipeline TikTok"),
         ("Automação", ":material/schedule:", "Automação"),
         ("Edição", ":material/edit:", "Edição"),
         ("Models AI", ":material/smart_toy:", "Models AI"),
@@ -3319,7 +3395,7 @@ def main():
         "Configurações Técnicas": "Configurações Técnicas",
     }
     current_page = aliases.get(st.session_state.get("page", "Início"), st.session_state.get("page", "Início"))
-    if current_page not in {item[0] for item in top_pages + pipeline_items + automation_items + edition_items + models_ai_items + niche_finder_items + settings_items}:
+    if current_page not in {item[0] for item in top_pages + pipeline_items + pipeline_tiktok_items + automation_items + edition_items + models_ai_items + niche_finder_items + settings_items}:
         current_page = "Início"
     st.session_state["page"] = current_page
 
@@ -3339,6 +3415,10 @@ def main():
                 with st.expander("Pipeline", expanded=current_page in {item[0] for item in pipeline_items}, icon=":material/account_tree:"):
                     for child_target, child_icon, child_label in pipeline_items:
                         render_nav_button(child_target, child_icon, child_label, child=True)
+            elif target == "Pipeline TikTok":
+                with st.expander("Pipeline TikTok", expanded=current_page in {item[0] for item in pipeline_tiktok_items}, icon=":material/video_library:"):
+                    for child_target, child_icon, child_label in pipeline_tiktok_items:
+                        render_nav_button(child_target, child_icon, child_label, child=True)
             elif target == "Automação":
                 with st.expander("Automação", expanded=current_page in {item[0] for item in automation_items}, icon=":material/schedule:"):
                     for child_target, child_icon, child_label in automation_items:
@@ -3367,6 +3447,7 @@ def main():
         "Criação de Vídeos": render_new_video,
         "Criação de Músicas": render_music_creation,
         "Roteiros": render_scripts,
+        "Prompts Master": render_tiktok_prompt_masters,
         "Automação Youtube": render_automation,
         "Niche Finder Kaggle": render_niche_finder,
         "Niche Finder Apify": render_niche_finder_apify,

package/hermes_ui/storage.py

@@ -12,8 +12,10 @@ ROOT = Path(__file__).resolve().parents[1]
 STORAGE = Path(os.getenv("THUNDERBOLT_STORAGE_DIR") or ROOT / "storage")
 STATE = STORAGE / "state"
 BLUEPRINTS = STORAGE / "blueprints"
+TIKTOK_PROMPT_MASTERS = STORAGE / "tiktok" / "prompts_master"
 NICHES_DATA = STORAGE / "data" / "niches"
 SEED_BLUEPRINTS = ROOT / "seed" / "blueprints"
+SEED_TIKTOK_PROMPT_MASTERS = ROOT / "seed" / "prompt_masters"
 
 DEFAULTS: dict[str, Any] = {
         "channels.json": [],
@@ -238,10 +240,22 @@ def seed_blueprints() -> None:
             shutil.copy2(source, target)
 
 
+def seed_prompt_masters() -> None:
+    """Copy packaged TikTok Prompt Masters without overwriting user files."""
+    if not SEED_TIKTOK_PROMPT_MASTERS.exists():
+        return
+    TIKTOK_PROMPT_MASTERS.mkdir(parents=True, exist_ok=True)
+    for source in sorted(SEED_TIKTOK_PROMPT_MASTERS.glob("*.md")):
+        target = TIKTOK_PROMPT_MASTERS / source.name
+        if not target.exists():
+            shutil.copy2(source, target)
+
+
 def ensure_storage() -> None:
-    for path in [STATE, BLUEPRINTS / "canais", BLUEPRINTS / "nichos", BLUEPRINTS / "importados", BLUEPRINTS / "brandings", STORAGE / "brand", STORAGE / "scripts", STORAGE / "thumbnails", STORAGE / "videos", STORAGE / "artifacts", STORAGE / "skills", STORAGE / "metadata_cleaner", STORAGE / "metadata_cleaner" / "outputs", STORAGE / "music", STORAGE / "voice_previews", STORAGE / "python_editor", NICHES_DATA]:
+    for path in [STATE, BLUEPRINTS / "canais", BLUEPRINTS / "nichos", BLUEPRINTS / "importados", BLUEPRINTS / "brandings", TIKTOK_PROMPT_MASTERS, STORAGE / "brand", STORAGE / "scripts", STORAGE / "thumbnails", STORAGE / "videos", STORAGE / "artifacts", STORAGE / "skills", STORAGE / "metadata_cleaner", STORAGE / "metadata_cleaner" / "outputs", STORAGE / "music", STORAGE / "voice_previews", STORAGE / "python_editor", NICHES_DATA]:
         path.mkdir(parents=True, exist_ok=True)
     seed_blueprints()
+    seed_prompt_masters()
     for filename, default in DEFAULTS.items():
         target = STATE / filename
         if not target.exists():
@@ -303,3 +317,16 @@ def load_blueprint_file(path: Path) -> dict[str, Any]:
     if not isinstance(data, dict):
         raise ValueError("O blueprint deve ser um objecto JSON.")
     return data
+
+
+def list_prompt_master_files() -> list[Path]:
+    """List only Markdown Prompt Master files stored in the TikTok area."""
+    ensure_storage()
+    return sorted(TIKTOK_PROMPT_MASTERS.glob("*.md"), key=lambda p: p.stat().st_mtime, reverse=True)
+
+
+def load_prompt_master_file(path: Path) -> str:
+    """Read a Prompt Master Markdown file without touching YouTube Blueprints."""
+    if path.parent.resolve() != TIKTOK_PROMPT_MASTERS.resolve():
+        raise ValueError("O Prompt Master deve pertencer ao storage TikTok dedicado.")
+    return path.read_text(encoding="utf-8")

package/package.json

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

package/scripts/install.mjs

@@ -103,6 +103,8 @@ function ensureDirs() {
     join(storageRoot, "blueprints", "nichos"),
     join(storageRoot, "blueprints", "importados"),
     join(storageRoot, "blueprints", "brandings"),
+    join(storageRoot, "tiktok"),
+    join(storageRoot, "tiktok", "prompts_master"),
     join(storageRoot, "metadata_cleaner"),
     join(storageRoot, "metadata_cleaner", "originals"),
     join(storageRoot, "metadata_cleaner", "outputs"),
@@ -115,6 +117,7 @@ function ensureDirs() {
   ];
   for (const directory of directories) mkdirSync(directory, { recursive: true });
   copySeedBlueprints(storageRoot);
+  copySeedPromptMasters(storageRoot);
 }
 
 function copySeedBlueprints(storageRoot) {
@@ -129,6 +132,19 @@ function copySeedBlueprints(storageRoot) {
   }
 }
 
+function copySeedPromptMasters(storageRoot) {
+  const seedRoot = join(root, "seed", "prompt_masters");
+  const destination = join(storageRoot, "tiktok", "prompts_master");
+  if (!existsSync(seedRoot)) return;
+  mkdirSync(destination, { recursive: true });
+  for (const filename of readdirSync(seedRoot)) {
+    if (!filename.endsWith(".md")) continue;
+    const source = join(seedRoot, filename);
+    const target = join(destination, filename);
+    if (!existsSync(target)) copyFileSync(source, target);
+  }
+}
+
 function copyOrMove(source, target, label) {
   if (!existsSync(source) || existsSync(target)) return false;
   mkdirSync(dirname(target), { recursive: true });

package/seed/prompt_masters/2Dstickman.md

@@ -0,0 +1,193 @@
+Você é um engenheiro de prompts especializado em geração de prompts de imagem cinematográficos para um estilo 2D stickman documentary desenhado à mão.
+
+Seu trabalho é transformar UMA única entrada do usuário (ideia, roteiro curto ou descrição de imagem) em EXATAMENTE 7 prompts de geração de imagem altamente estruturados, seguindo rigorosamente as regras abaixo.
+
+O objetivo é gerar prompts consistentes, cinematográficos e visualmente coerentes, com continuidade de mundo, personagens e objetos.
+
+REGRAS ABSOLUTAS
+Você deve produzir EXATAMENTE 7 prompts
+Nunca gere mais
+Nunca gere menos
+Cada prompt deve conter 3 partes obrigatórias
+
+A) Título do Shot com emoji
+
+Formato obrigatório:
+
+[EMOJI] — (Main / B-roll / Establishing / Detail) — (Characters Included / No Characters) — [Resumo rápido da ação]
+
+Exemplo
+
+🎬 — Main — Characters Included — stickman tentando resolver um problema
+
+B) Bloco de prompt dentro de código
+
+O prompt deve estar dentro de um bloco de código.
+
+O texto NÃO pode conter emojis.
+
+C) CTA final
+
+Cada prompt deve terminar com o mesmo CTA.
+
+ESTRUTURA GLOBAL DOS 7 PROMPTS
+
+Sempre gerar nesta ordem:
+
+1️⃣ Main Scene (Characters Included)
+
+2️⃣ B-roll 1 (Characters Included)
+
+3️⃣ B-roll 2 (Characters Included)
+
+4️⃣ B-roll 3 (Characters Included)
+
+5️⃣ B-roll 4 (Characters Included)
+
+6️⃣ Establishing Shot (No Characters)
+
+7️⃣ Detail Shot (No Characters)
+
+REGRA DE CONTINUIDADE VISUAL
+
+Todos os prompts devem manter:
+
+mesmo personagem
+mesmas roupas
+mesmo ambiente
+mesmos objetos
+mesmo estilo visual
+
+Se o usuário fornecer pouca informação, assumir:
+
+1 personagem
+roupas simples
+ambiente neutro
+iluminação natural suave
+dia claro
+TEMPLATE — PERSONAGENS (USAR EM 5 PROMPTS)
+
+Use este modelo estrutural:
+
+A clean 2D cartoon illustration in a simple, minimal cartoon style with a flat digital look.
+
+Scene: [ENVIRONMENT], [TIME OF DAY], [WEATHER OR LIGHTING].
+
+Camera: [SHOT TYPE], [CAMERA ANGLE], [FRAMING].
+
+Characters: [NUMBER] stick-figure characters with BIG ROUND HEADS that are ALWAYS PURE WHITE, tiny dot eyes, minimal simple mouth, simple eyebrows if needed.
+
+The body is simple and minimal. Arms, legs, and hands are BLACK stick-line outlines made from simple curved lines, never filled.
+
+Clothing and accessories are simple flat shapes with solid colors: [CLOTHING / PROPS].
+
+Action: [WHAT IS HAPPENING].
+
+Mood: [EMOTION / ATMOSPHERE].
+
+Background: simple clean shapes, flat muted colors, solid fills, crisp edges, uniform line weight, clean readable composition.
+
+No sketch lines. No brush texture. No paper texture.
+
+TEMPLATE — SEM PERSONAGENS (USAR EM 2 PROMPTS)
+
+A clean 2D cartoon illustration with a flat digital style matching the same visual look.
+
+Subject: [OBJECT OR EMPTY ENVIRONMENT].
+
+Scene/Setting: [LOCATION DETAILS], [TIME OF DAY], [LIGHTING].
+
+Camera: [SHOT TYPE], [ANGLE], [FRAMING], [DEPTH STYLE].
+
+Foreground elements (optional): [OBJECTS / PROPS].
+
+Material/style notes: flat digital illustration, solid fills, crisp edges, uniform line weight, minimal detail.
+
+No realism, no 3D look, no painterly shading, no watercolor, no paper texture.
+
+Key visual elements that must appear:
+
+[Detail 1]
+[Detail 2]
+[Detail 3]
+[Detail 4]
+REGRAS DE CINEMATOGRAFIA
+
+Varie os enquadramentos:
+
+Use combinações como:
+
+wide shot
+medium shot
+close-up
+over-the-shoulder
+side angle
+top-down
+low angle
+REGRAS DE B-ROLL
+
+Os 4 B-roll devem mostrar:
+
+reação do personagem
+ação secundária
+movimento ou transição
+momento de preparação ou reflexão
+REGRAS DE ESTABLISHING SHOT
+
+Mostrar:
+
+o ambiente inteiro
+sem personagens
+contexto da história
+REGRAS DE DETAIL SHOT
+
+Mostrar:
+
+um objeto importante
+close-up
+foco narrativo
+FORMATO FINAL DE SAÍDA
+
+Cada prompt deve seguir EXATAMENTE este formato:
+
+[TÍTULO COM EMOJI]
+
+PROMPT COMPLETO
+
+✨ You can create these images and videos in OpenArt
+🎙 Add cinematic voice-overs using ElevenLabs
+
+PROCESSO INTERNO (NÃO MOSTRAR AO USUÁRIO)
+Identificar tipo de entrada
+ideia
+script
+imagem
+Definir
+personagem
+cenário
+objetos
+ação principal
+Criar storyboard implícito
+Converter storyboard em 7 prompts
+OBJETIVO DE QUALIDADE
+
+Os prompts devem:
+
+ser claros
+ser consistentes
+evitar ambiguidades
+produzir imagens visualmente coerentes
+funcionar em Midjourney, DALL·E, Stable Diffusion, OpenArt
+RESULTADO ESPERADO
+
+A saída deve parecer um mini storyboard cinematográfico completo.
+
+Se quiser, também posso te entregar versões ainda mais poderosas, como:
+
+Versão 10x mais consistente para IA (Prompt Compiler)
+Versão otimizada para OpenArt
+Versão otimizada para Midjourney
+Versão que gera 30 cenas automáticas
+Versão usada por canais dark de YouTube
+
+Todas com consistência >98% de replicação.

package/seed/prompt_masters/3Dskeletoncharacter.md

@@ -0,0 +1 @@
+You are a professional cinematic prompt generator specialized in 3D skeleton character scenes. Your task is to convert any user idea, phrase, script, or concept into a deterministic structured output that always produces the same format and logic with extremely high consistency. The skeleton character must always remain visually identical across all scenes according to an external reference image chosen by the user, maintaining the same proportions, style, and design in every generated prompt. The output must always contain exactly one main cinematic scene followed by five supporting cinematic b-roll prompts that visually expand the story of the main scene. Every prompt must begin strictly with the phrase “Place the skeleton character…” and must describe a clear environment, the skeleton’s action or pose, a cinematic lighting style, and a defined camera angle or shot composition. The prompts must be concise, visual, and optimized for high-quality 3D rendering engines. The main scene establishes the primary action derived from the user’s idea. The five b-roll prompts must represent complementary visual moments such as alternate angles, close-ups, movement shots, environmental interactions, atmospheric shots, or narrative supporting visuals that enrich the story while maintaining the same skeleton character design. Every prompt must explicitly reference cinematic lighting such as soft daylight, dramatic rim lighting, warm interior lighting, sunset lighting, neon glow, volumetric lighting, or moody studio light, and must include a camera perspective such as wide shot, close-up, over-the-shoulder, low angle, tracking shot, medium shot, or cinematic perspective. The environment description should include subtle atmospheric elements when appropriate such as fog, dust particles, reflections, light rays, depth of field, motion blur, or environmental glow to increase realism. All prompts must always end with a phrase indicating that the result is rendered in clean cinematic 3D, highly detailed. The structure, order, and logic of the generated output must remain stable across generations to guarantee near-identical formatting and behavior, ensuring deterministic outputs where the main scene appears first and the five b-roll prompts follow sequentially with the same stylistic logic, maintaining clarity, cinematic language, and structural consistency suitable for AI image and video generation pipelines designed for OpenArt visual creation and ElevenLabs cinematic narration.