@danhachuel/thunderbolt 0.3.66 → 0.3.67

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.66
+> **Versão deste manual:** 0.3.67
 > **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.66 install
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.67 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes --prefer-online @danhachuel/thunderbolt@0.3.66 install
+npx --yes --prefer-online @danhachuel/thunderbolt@0.3.67 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.66 install --purge-data
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.67 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,12 @@ A área **Voz, TTS e música — Azure Speech, restantes serviços e Suno** est
 
 Na subaba **Imagem e Video**, a lista **Provider de media** inclui **FAL AI, KIE AI, Agnes AI, Nano Banana, Replicate AI, Pollinations.ai, Hugging Face Inference API, InferencePort Proxy e HeyGen** para a rota Full IA. O cartão **HeyGen** pede a API key, o **Avatar ID** e, opcionalmente, o **Voice ID**; a opção **Provider activo**, **Pool Vídeo**, **Prioridade** e **Testar Chamada API** funcionam como nos restantes cartões. O teste HeyGen usa apenas `GET /v3/users/me` e não consome uma geração. Nano Banana e Hugging Face podem permanecer no catálogo sem serem seleccionados para vídeo quando o cartão não declara capacidade de vídeo.
 
+### API Tiktok — várias aplicações
+
+Em **Configuração API > API Tiktok**, situada entre **Contas Google** e **Fontes de Materiais**, cada aplicação TikTok é configurada num card independente. O card contém exclusivamente **TikTok Client ID** e **TikTok Client Secret** e apresenta os botões **Testar chamada API**, **Guardar card** e **Apagar card**. Use **Adicionar nova API** no final da lista para criar outra aplicação sem substituir as anteriores.
+
+O botão de teste é read-only. Sem um token OAuth TikTok já autorizado, o Thunderbolt informa que é necessário concluir o Playground/autorização do TikTok for Developers, sem inventar um resultado nem enviar credenciais. O token e a autorização não são campos dos cards. Instalações que ainda tenham `tiktok_client_key` e `tiktok_client_secret` são migradas automaticamente para o primeiro card; o adapter usa o primeiro card completo e mantém fallback para os campos antigos.
+
 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.
@@ -562,7 +568,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.66 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.67 install`; o instalador detecta e reutiliza o que já estiver válido.
 
 ### Niche Finder Apify
 

package/README.md

@@ -25,7 +25,7 @@ A primeira versão implementa a camada UI independente com:
 | Edição | Menu expansível abaixo de Automação com Limpador de Metadados, Clip Generator local em Cortes e Editor Python inspirado no PYEdit para vídeos e scripts locais |
 | Upload | YouTube via `youtube-automation-agent` adaptado internamente, fallback ordenado API Oficial → Upload directo → Postiz, upload de MP4 para Postiz via API key/MCP configurável, TikTok, Instagram e Facebook Pages no front end |
 | MCP | Catálogo local opcional de Short Video Maker, AutoVio, OpenMontage e OpenCut, com portas editáveis e activação |
-| Configurações | **Contas Google**, **Configuração API** e **Notificações**; Notificações contém as subabas **Geral** e **Telegram Gateway**, com envio das mesmas operações locais para um Chat ID; API Keys divididas entre **Serviços e modelos** e **Fontes de materiais**, com várias chaves independentes por fonte, além de contas Google/YouTube por cartão, `INNERTUBE_API_KEY` global para todas as contas, providers, TTS, Nano Banana, Postiz, TikTok e Upload-Post |
+| Configurações | **Contas Google**, **Configuração API** e **Notificações**; Notificações contém as subabas **Geral** e **Telegram Gateway**, com envio das mesmas operações locais para um Chat ID; API Keys divididas entre **Serviços e modelos**, **API Tiktok** e **Fontes de materiais**, com várias chaves independentes por fonte, além de contas Google/YouTube por cartão, `INNERTUBE_API_KEY` global para todas as contas, providers, TTS, Nano Banana, Postiz, TikTok e Upload-Post |
 | Launcher | Execução via `npx`, instalação assistida, diagnóstico e preparação para distribuição |
 
 ## AI Influencers — personagens e geração de conteúdo
@@ -48,6 +48,12 @@ Quando uma etapa falha, a tarefa, a notificação e a página **Configurações
 
 Na subaba **Configuração API > API Keys > Imagem e Video**, o selector **Provider de media** inclui a mesma lista do pool Full IA. O cartão **HeyGen** usa a API V3, apresenta os campos **Avatar ID** e **Voice ID**, valida a credencial com uma chamada read-only e participa no failover de vídeo quando estiver activo e configurado. Nano Banana e Hugging Face permanecem disponíveis no catálogo; a participação efectiva no pool de vídeo depende da capacidade declarada pelo cartão, para não encaminhar vídeo para um endpoint que apenas suporte imagem.
 
+## API Tiktok — múltiplas aplicações TikTok
+
+A subaba **Configuração API > API Tiktok** fica entre **Contas Google** e **Fontes de Materiais**. Cada aplicação TikTok é apresentada num card separado e contém apenas **TikTok Client ID** e **TikTok Client Secret**, ambos guardados no storage local. O botão **Adicionar nova API** cria cards adicionais; cada card dispõe de **Guardar card**, **Testar chamada API** e **Apagar card**. A autorização OAuth, os scopes e os tokens de publicação continuam fora desta subaba, no fluxo próprio do TikTok for Developers.
+
+As credenciais antigas dos campos únicos `tiktok_client_key` e `tiktok_client_secret` são migradas automaticamente para o primeiro card sem serem eliminadas. Para compatibilidade com integrações existentes, o adapter TikTok utiliza o primeiro card completo e mantém fallback para os campos legados; a UI não altera os campos pedidos nem mistura Client ID/Secret com tokens, redirect URI ou scopes.
+
 ## 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**.

package/app/main.py

@@ -4660,6 +4660,103 @@ def render_upload_conventional():
                 st.button("Preparar Facebook Pages", key=f"upload_facebook_{task['id']}", disabled=True, help="UI preparada; publicação Facebook Pages ainda não está activa.")
 
 
+def _normalise_tiktok_api_cards(settings: dict[str, Any]) -> tuple[list[dict[str, str]], bool]:
+    raw_cards = settings.get("tiktok_api_cards")
+    cards: list[dict[str, str]] = []
+    changed = not isinstance(raw_cards, list)
+    if isinstance(raw_cards, list):
+        for index, raw_card in enumerate(raw_cards):
+            if not isinstance(raw_card, dict):
+                changed = True
+                continue
+            card_id = str(raw_card.get("id") or f"tiktok-api-{index + 1}").strip()
+            client_id = str(raw_card.get("client_id") or raw_card.get("client_key") or "").strip()
+            client_secret = str(raw_card.get("client_secret") or "").strip()
+            normalised = {"id": card_id, "client_id": client_id, "client_secret": client_secret}
+            cards.append(normalised)
+            if normalised != {key: str(raw_card.get(key) or "").strip() for key in ("id", "client_id", "client_secret")}:
+                changed = True
+    if not cards:
+        legacy_client_id = str(settings.get("tiktok_client_key") or "").strip()
+        legacy_client_secret = str(settings.get("tiktok_client_secret") or "").strip()
+        if legacy_client_id or legacy_client_secret:
+            cards = [{"id": "tiktok-api-1", "client_id": legacy_client_id, "client_secret": legacy_client_secret}]
+            changed = True
+    if changed and cards:
+        settings["tiktok_api_cards"] = cards
+        write_json("settings.json", settings)
+    return cards, changed
+
+
+def _persist_tiktok_api_cards(settings: dict[str, Any], cards: list[dict[str, str]]) -> None:
+    clean_cards = [
+        {
+            "id": str(card.get("id") or f"tiktok-api-{index + 1}").strip(),
+            "client_id": str(card.get("client_id") or "").strip(),
+            "client_secret": str(card.get("client_secret") or "").strip(),
+        }
+        for index, card in enumerate(cards)
+    ]
+    settings["tiktok_api_cards"] = clean_cards
+    first = next((card for card in clean_cards if card["client_id"] and card["client_secret"]), clean_cards[0] if clean_cards else {"client_id": "", "client_secret": ""})
+    settings["tiktok_client_key"] = first["client_id"]
+    settings["tiktok_client_secret"] = first["client_secret"]
+    write_json("settings.json", settings)
+
+
+def render_tiktok_api_cards(settings: dict[str, Any]) -> None:
+    st.title("API Tiktok")
+    st.caption("Configure várias aplicações TikTok em cards separados. Cada card mantém apenas o TikTok Client ID e o TikTok Client Secret; autorização OAuth, scopes e tokens continuam a ser geridos no TikTok for Developers Playground.")
+    cards, _ = _normalise_tiktok_api_cards(settings)
+    if not cards:
+        st.info("Ainda não existe nenhuma API TikTok configurada. Use o botão abaixo para criar o primeiro card.")
+    for index, card in enumerate(cards):
+        card_id = str(card["id"])
+        with st.container(border=True):
+            header_cols = st.columns([3.2, 1.2])
+            with header_cols[0]:
+                st.subheader(f"API TikTok {index + 1}")
+            with header_cols[1]:
+                configured = bool(card["client_id"] and card["client_secret"])
+                _api_status_badge("Configured" if configured else "Missing configuration", "ready" if configured else "missing")
+            with st.form(f"tiktok_api_card_form_{card_id}"):
+                client_id = st.text_input("TikTok Client ID", value=card["client_id"], key=f"tiktok_api_{card_id}_client_id")
+                client_secret = st.text_input("TikTok Client Secret", value=card["client_secret"], type="password", key=f"tiktok_api_{card_id}_client_secret")
+                action_cols = st.columns(3)
+                with action_cols[0]:
+                    test_clicked = st.form_submit_button("Testar chamada API", use_container_width=True)
+                with action_cols[1]:
+                    save_clicked = st.form_submit_button("Guardar card", type="primary", use_container_width=True)
+                with action_cols[2]:
+                    delete_clicked = st.form_submit_button("Apagar card", use_container_width=True)
+            edited = {"id": card_id, "client_id": client_id.strip(), "client_secret": client_secret.strip()}
+            if test_clicked:
+                cards[index] = edited
+                _persist_tiktok_api_cards(settings, cards)
+                result = test_tiktok_credentials(edited["client_id"], edited["client_secret"], settings.get("tiktok_access_token", ""))
+                if result.get("status") == "success":
+                    st.success(result.get("message") or "Chamada TikTok concluída.")
+                elif result.get("status") == "unsupported":
+                    st.warning(result.get("message") or "Conclua a autorização TikTok antes do teste.")
+                else:
+                    st.error(result.get("message") or "A chamada TikTok falhou.")
+            elif save_clicked:
+                cards[index] = edited
+                _persist_tiktok_api_cards(settings, cards)
+                st.success("Card TikTok guardado.")
+                st.rerun()
+            elif delete_clicked:
+                cards = [item for item in cards if str(item.get("id")) != card_id]
+                _persist_tiktok_api_cards(settings, cards)
+                st.success("Card TikTok apagado.")
+                st.rerun()
+    if st.button("Adicionar nova API", type="primary", use_container_width=True, key="add_tiktok_api_card"):
+        cards.append({"id": f"tiktok-api-{uuid.uuid4().hex[:10]}", "client_id": "", "client_secret": ""})
+        _persist_tiktok_api_cards(settings, cards)
+        st.success("Novo card TikTok criado.")
+        st.rerun()
+
+
 def render_google_accounts():
     st.title("Contas Google")
     st.caption("Gestão das contas Google/YouTube, documentos de credenciais, canais em lote e credenciais globais do YouTube.")
@@ -5440,7 +5537,7 @@ def render_settings():
             key=f"settings_{key}",
         )
 
-    api_keys_tab, google_accounts_tab, material_sources_tab, ai_influencers_tab, voice_test_tab = render_localized_tabs(["API Keys", "Contas Google", "Fontes de Materiais", "AI Influencers", "Teste de Voz"])
+    api_keys_tab, google_accounts_tab, tiktok_api_tab, material_sources_tab, ai_influencers_tab, voice_test_tab = render_localized_tabs(["API Keys", "Contas Google", "API Tiktok", "Fontes de Materiais", "AI Influencers", "Teste de Voz"])
 
     with api_keys_tab:
         with st.container(border=True):
@@ -5591,18 +5688,6 @@ def render_settings():
                             widget_key="api_test_voice_suno",
                         )
 
-                with st.expander("TikTok for Developers — Client ID e Client Secret", expanded=False):
-                    st.caption("Apenas as credenciais da aplicação ficam nesta UI. Redirect URI, scopes, autorização e tokens são geridos no TikTok for Developers Playground.")
-                    tiktok_client_key = text_setting("TikTok Client ID", "tiktok_client_key", secret=True)
-                    _render_credential_status(tiktok_client_key)
-                    tiktok_client_secret = text_setting("TikTok Client Secret", "tiktok_client_secret", secret=True)
-                    _render_api_test_control(
-                        settings,
-                        "tiktok",
-                        lambda: test_tiktok_credentials(tiktok_client_key, tiktok_client_secret, settings.get("tiktok_access_token", "")),
-                        widget_key="api_test_tiktok",
-                    )
-
                 with st.expander("Publicação através do Upload-Post", expanded=False):
                     upload_post_enabled = st.checkbox("Activar Upload-Post", bool(settings.get("upload_post_enabled", False)))
                     upload_post_api_key = text_setting("Upload-Post API key", "upload_post_api_key", secret=True)
@@ -5651,7 +5736,6 @@ def render_settings():
                         "elevenlabs_api_key": elevenlabs_api_key, "elevenlabs_model_id": elevenlabs_model_id,
                         "chatterbox_base_url": chatterbox_base_url, "chatterbox_api_key": chatterbox_api_key, "chatterbox_model_id": chatterbox_model_id,
                         "sonilo_api_key": sonilo_api_key, "sonilo_base_url": sonilo_base_url, "suno_api_key": suno_api_key, "suno_api_base_url": suno_api_base_url, "suno_api_endpoint": suno_api_endpoint,
-                        "tiktok_client_key": tiktok_client_key, "tiktok_client_secret": tiktok_client_secret,
                         "upload_post_enabled": upload_post_enabled, "upload_post_api_key": upload_post_api_key,
                         "upload_post_username": upload_post_username, "upload_post_platforms": upload_post_platforms,
                         "upload_post_auto_upload": upload_post_auto_upload,
@@ -5671,6 +5755,9 @@ def render_settings():
     with google_accounts_tab:
         render_google_accounts()
 
+    with tiktok_api_tab:
+        render_tiktok_api_cards(settings)
+
     with material_sources_tab:
         render_material_source_api_keys(settings)
 

package/hermes_ui/languages.py

@@ -114,7 +114,7 @@ _CORE_UI_TEXT_KEYS = (
     "Início", "Niche Finder", "Pipeline", "Pipeline TikTok", "Automação", "Edição", "AI Influencers", "Configurações",
     "Criação de Vídeos", "Criação de Músicas", "Roteiros", "Upload", "Prompts Master", "Contas TikTok", "Automação Youtube",
     "Niche Finder Kaggle", "Niche Finder Apify", "Limpador de Metadados", "Cortes", "Editor Python", "Download Mídia",
-    "Personagens", "Redes Sociais", "Tutorial Meta", "Tutorial Supabase", "Canais Youtube", "Blueprints Youtube", "MCP", "Contas Google",
+    "Personagens", "Redes Sociais", "Tutorial Meta", "Tutorial Supabase", "Canais Youtube", "Blueprints Youtube", "MCP", "Contas Google", "API Tiktok",
     "Configuração API", "Notificações", "Interface local para operação e automação de conteúdo faceless", "Canais", "activos",
     "Tarefas", "total registado", "A fazer", "na pipeline", "Em execução", "a decorrer", "Concluídos", "artefactos prontos",
     "Falhas", "requerem atenção", "Filas locais e dependências da cascata", "Niche", "Blueprints", "Brand", "Script", "Title",
@@ -153,6 +153,9 @@ UI_TRANSLATIONS: dict[str, dict[str, str]] = {
     },
 }
 
+for _translation in UI_TRANSLATIONS.values():
+    _translation.setdefault("API Tiktok", "API Tiktok")
+
 # Labels for the independent LLM provider cards.
 _LLM_TRANSLATIONS: dict[str, dict[str, str]] = {
     "pt": {

package/hermes_ui/storage.py

@@ -287,6 +287,7 @@ DEFAULTS: dict[str, Any] = {
         "postiz_auto_publish": False,
         "tiktok_client_key": "",
         "tiktok_client_secret": "",
+        "tiktok_api_cards": [],
         "tiktok_accounts": [],
         "tiktok_redirect_uri": "http://localhost:3030/oauth/tiktok/callback",
         "tiktok_scopes": "user.info.basic,video.publish,video.upload",

package/integrations/platforms.py

@@ -528,8 +528,18 @@ class YouTubeAdapter:
 
 class TikTokAdapter:
     def __init__(self, settings: dict[str, Any]):
-        self.client_key = settings.get("tiktok_client_key", "")
-        self.client_secret = settings.get("tiktok_client_secret", "")
+        cards = settings.get("tiktok_api_cards") if isinstance(settings.get("tiktok_api_cards"), list) else []
+        selected = next(
+            (
+                card for card in cards
+                if isinstance(card, dict)
+                and str(card.get("client_id") or card.get("client_key") or "").strip()
+                and str(card.get("client_secret") or "").strip()
+            ),
+            {},
+        )
+        self.client_key = str(selected.get("client_id") or selected.get("client_key") or settings.get("tiktok_client_key", "")).strip()
+        self.client_secret = str(selected.get("client_secret") or settings.get("tiktok_client_secret", "")).strip()
         # Redirect URI, scopes, OAuth e access token são geridos no TikTok for Developers Playground.
         # A UI guarda apenas as credenciais da aplicação.
         self.access_token = os.getenv("TIKTOK_ACCESS_TOKEN", "")

package/package.json

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