@danhachuel/thunderbolt 0.3.47 → 0.3.49

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.47
+> **Versão deste manual:** 0.3.49
 > **Pacote npm:** `@danhachuel/thunderbolt`
 > **Porta padrão da UI:** `localhost:3030`  
 > **Repositório:** [github.com/DanHachuel/thunderbolt](https://github.com/DanHachuel/thunderbolt)
@@ -100,13 +100,13 @@ Execute:
 Windows PowerShell ou MobaXterm:
 
 ```powershell
-npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.47 install
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.49 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes --prefer-online @danhachuel/thunderbolt@0.3.47 install
+npx --yes --prefer-online @danhachuel/thunderbolt@0.3.49 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.
@@ -114,7 +114,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.47 install --purge-data
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.49 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.
@@ -361,10 +361,12 @@ Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
 
 Em **Configuração API > API Keys**, o expander **LLM — providers e modelos** continua a guardar cartões independentes para os providers textuais. O campo **Prioridade** substitui o antigo checkbox **LLM principal**: o cartão com valor **1** é tentado primeiro, depois o **2**, o **3** e assim sucessivamente. Pode manter várias API keys do mesmo provider em cartões distintos; a geração textual percorre o pool por essa ordem e tenta a prioridade seguinte apenas em quota, timeout, erro de transporte ou falha transitória. A chave interna de cartão activo permanece apenas como espelho de compatibilidade das instalações antigas.
 
-O bloco **Limite LLM NVIDIA NIM** permite ligar **Activar limitador NVIDIA NIM — 40 RPM**. O valor padrão é 40 pedidos numa janela de 60 segundos. O contador é persistido localmente por cartão/chave e aplica-se à criação manual, aos workers e às automações. A opção vem desligada para não alterar instalações existentes; ligue-a quando o endpoint activo for NVIDIA NIM e a sua conta tiver esse limite.
+Dentro do expander **LLM — providers e modelos**, acima dos cartões de providers, está o card **Limite LLM NVIDIA NIM**. Ele permite ligar **Activar limitador NVIDIA NIM — 40 RPM**. O valor padrão é 40 pedidos numa janela de 60 segundos. O contador é persistido localmente por cartão/chave e aplica-se à criação manual, aos workers e às automações. A opção vem desligada para não alterar instalações existentes; ligue-a quando o endpoint activo for NVIDIA NIM e a sua conta tiver esse limite.
 
 O expander **Imagem e Video** substitui o antigo bloco isolado da Nano Banana. Os cartões disponíveis são **Nano Banana**, **Pollinations.ai**, **Agnes AI**, **Hugging Face Inference API**, **Cloudflare Workers AI**, **InferencePort Proxy**, **阿里云 (Alibaba Cloud Model Studio)**, **KIE AI** e **FAL AI**. Em cada cartão, configure a API key/token, o modelo, a Base URL, o estado **Provider activo**, a participação no **Pool Imagem**, a participação no **Pool Vídeo** e a prioridade. **Image Size** e **Aspect Ratio** não aparecem nos cartões e não são editáveis: são defaults internos aplicados automaticamente no prompt da geração. O botão **Testar Chamada API** faz apenas uma verificação read-only; não inicia geração de imagem ou vídeo.
 
+A área **Voz, TTS e música — Azure Speech, restantes serviços e Suno** está dividida em cartões independentes para **Azure Speech**, **ElevenLabs**, **SiliconFlow**, **MiniMax TTS**, **Chatterbox**, **Sonilo** e **Suno**. Cada cartão agrupa apenas as credenciais, parâmetros e diagnóstico do serviço correspondente. O Suno aparece num cartão próprio porque é uma integração de criação musical, enquanto os restantes providers são serviços de voz/TTS.
+
 | Provider | Configuração mínima | Pool suportado |
 |---|---|---|
 | Nano Banana | API key e modelo Gemini; composição aplicada internamente | Imagem |
@@ -522,7 +524,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.47 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.49 install`; o instalador detecta e reutiliza o que já estiver válido.
 
 ### Niche Finder Apify
 

package/README.md

@@ -69,7 +69,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.47
+## Navegação da UI 0.3.49
 
 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**, **Redes Sociais**, **Tutorial Meta** e **Tutorial Supabase**, nessa ordem. **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.
 
@@ -85,7 +85,9 @@ Em **Configuração API > API Keys**, a subaba **Fontes de materiais** segue o p
 
 A subaba **Serviços e modelos** mantém as credenciais de providers e serviços que não são fontes de materiais. A chave `gemini_image_api_key` da Nano Banana continua separada de `gemini_api_key` do LLM textual. `INNERTUBE_API_KEY` permanece exclusivamente em **Configurações > Contas Google**, no bloco de configuração global fora dos cartões, e não é duplicada em API Keys.
 
-Nos cartões de **LLM — providers e modelos**, o campo **Prioridade** define a ordem de tentativa do pool textual. O valor **1** é usado primeiro; em quota, timeout, erro de transporte ou falha transitória, o router tenta a prioridade **2**, depois **3** e assim sucessivamente. O checkbox antigo **LLM principal** deixou de existir. A chave interna de cartão activo continua apenas como espelho de compatibilidade para instalações antigas.
+A área expansível **Voz, TTS e música — Azure Speech, restantes serviços e Suno** está organizada em cartões independentes para **Azure Speech**, **ElevenLabs**, **SiliconFlow**, **MiniMax TTS**, **Chatterbox**, **Sonilo** e **Suno**. Cada cartão contém apenas os campos do respectivo serviço e o seu próprio botão de diagnóstico; o Suno fica visualmente separado por ser um agente de criação musical, não um provider TTS.
+
+Nos cartões de **LLM — providers e modelos**, o campo **Prioridade** define a ordem de tentativa do pool textual. O valor **1** é usado primeiro; em quota, timeout, erro de transporte ou falha transitória, o router tenta a prioridade **2**, depois **3** e assim sucessivamente. O checkbox antigo **LLM principal** deixou de existir. O card **Limite LLM NVIDIA NIM** fica dentro deste mesmo expander, acima dos cartões de providers, e os seus controlos continuam partilhados pela UI, pipeline e automações. A chave interna de cartão activo continua apenas como espelho de compatibilidade para instalações antigas.
 
 O expander **Imagem e Video** reúne cartões independentes para **Nano Banana**, **Pollinations.ai**, **Agnes AI**, **Hugging Face Inference API**, **Cloudflare Workers AI**, **InferencePort Proxy**, **阿里云 (Alibaba Cloud Model Studio)**, **KIE AI** e **FAL AI**. Cada cartão permite configurar API key/token quando necessário, modelo, Base URL, activar o provider, escolher participação no **Pool Imagem** e/ou **Pool Vídeo**, definir prioridade e executar **Testar Chamada API**. Os parâmetros técnicos de composição, como **Image Size** e **Aspect Ratio**, não são apresentados nem editáveis nos cartões: ficam como defaults internos e são acrescentados automaticamente ao prompt da geração de imagem e/ou vídeo. O InferencePort usa por defeito `http://localhost:8080/v1` e não exige chave; o Cloudflare requer Account ID; os restantes providers devem ser preenchidos de acordo com a conta e endpoint disponibilizados pelo serviço.
 

package/app/main.py

@@ -5096,8 +5096,8 @@ def _render_llm_card(settings: dict[str, Any], cards: list[dict[str, Any]], inde
                 st.error(f"Último teste: {saved_test['message']}")
 
 
-def render_llm_provider_cards(settings: dict[str, Any], *, embedded: bool = False) -> None:
-    """Renderizar cartões LLM fora da form global para permitir acções por cartão."""
+def render_llm_provider_cards(settings: dict[str, Any], *, embedded: bool = False) -> dict[str, Any]:
+    """Renderizar cartões LLM e o limitador NIM dentro do mesmo expander."""
     migrated, changed = ensure_llm_provider_cards(settings)
     cards = [dict(item) for item in migrated.get(LLM_CARDS_KEY, [])]
     if changed:
@@ -5105,6 +5105,16 @@ def render_llm_provider_cards(settings: dict[str, Any], *, embedded: bool = Fals
         write_json("settings.json", settings)
     with st.expander("LLM — providers e modelos", expanded=False):
         st.caption("Configure cada provider num cartão independente. Pode repetir o mesmo provider para manter várias API keys; a prioridade 1 é tentada primeiro e o router segue para as prioridades seguintes em falhas elegíveis.")
+        with st.container(border=True):
+            st.markdown("### Limite LLM NVIDIA NIM")
+            st.caption("Quando ligado, limita apenas cartões cujo endpoint é integrate.api.nvidia.com a 40 pedidos por janela de 60 segundos, partilhados entre UI, pipeline e automações.")
+            rpm_cols = st.columns(3)
+            with rpm_cols[0]:
+                llm_rpm_limit_enabled = st.checkbox("Activar limitador NVIDIA NIM — 40 RPM", value=bool(settings.get("llm_rpm_limit_enabled", False)), key="settings_llm_rpm_limit_enabled")
+            with rpm_cols[1]:
+                llm_rpm_limit = st.number_input("Pedidos por janela", min_value=1, max_value=1000, value=int(settings.get("llm_rpm_limit", 40)), step=1, key="settings_llm_rpm_limit")
+            with rpm_cols[2]:
+                llm_rpm_window_seconds = st.number_input("Janela (segundos)", min_value=1, max_value=3600, value=int(settings.get("llm_rpm_window_seconds", 60)), step=1, key="settings_llm_rpm_window_seconds")
         for index in range(len(cards)):
             _render_llm_card(settings, cards, index, embedded=embedded)
         st.divider()
@@ -5127,6 +5137,11 @@ def render_llm_provider_cards(settings: dict[str, Any], *, embedded: bool = Fals
             cards.append(new_card)
             _persist_llm_cards(settings, cards)
             st.rerun()
+    return {
+        "llm_rpm_limit_enabled": bool(llm_rpm_limit_enabled),
+        "llm_rpm_limit": int(llm_rpm_limit),
+        "llm_rpm_window_seconds": int(llm_rpm_window_seconds),
+    }
 
 
 def _media_card_config_status(card: dict[str, Any]) -> tuple[str, str]:
@@ -5320,92 +5335,106 @@ def render_settings():
                         widget_key="api_test_apify",
                     )
 
-                render_llm_provider_cards(settings, embedded=True)
-
-                with st.container(border=True):
-                    st.markdown("### Limite LLM NVIDIA NIM")
-                    st.caption("Quando ligado, limita apenas cartões cujo endpoint é integrate.api.nvidia.com a 40 pedidos por janela de 60 segundos, partilhados entre UI, pipeline e automações.")
-                    rpm_cols = st.columns(3)
-                    with rpm_cols[0]:
-                        llm_rpm_limit_enabled = st.checkbox("Activar limitador NVIDIA NIM — 40 RPM", value=bool(settings.get("llm_rpm_limit_enabled", False)), key="settings_llm_rpm_limit_enabled")
-                    with rpm_cols[1]:
-                        llm_rpm_limit = st.number_input("Pedidos por janela", min_value=1, max_value=1000, value=int(settings.get("llm_rpm_limit", 40)), step=1, key="settings_llm_rpm_limit")
-                    with rpm_cols[2]:
-                        llm_rpm_window_seconds = st.number_input("Janela (segundos)", min_value=1, max_value=3600, value=int(settings.get("llm_rpm_window_seconds", 60)), step=1, key="settings_llm_rpm_window_seconds")
+                llm_rpm_settings = render_llm_provider_cards(settings, embedded=True)
+                llm_rpm_limit_enabled = bool(llm_rpm_settings["llm_rpm_limit_enabled"])
+                llm_rpm_limit = int(llm_rpm_settings["llm_rpm_limit"])
+                llm_rpm_window_seconds = int(llm_rpm_settings["llm_rpm_window_seconds"])
 
                 render_media_provider_cards(settings, embedded=True)
 
                 with st.expander("Voz, TTS e música — Azure Speech, restantes serviços e Suno", expanded=False):
-                    cols = st.columns(2)
-                    with cols[0]:
+                    st.caption("Cada serviço está separado no seu próprio cartão. Os botões de teste ficam dentro do cartão correspondente e fazem apenas diagnóstico, sem gerar áudio ou música.")
+
+                    with st.container(border=True):
+                        st.markdown("#### Azure Speech")
+                        st.caption("TTS da Microsoft Azure para narração e catálogo de vozes.")
                         azure_speech_key = text_setting("Azure Speech key", "azure_speech_key", secret=True)
                         _render_credential_status(azure_speech_key)
                         azure_speech_region = text_setting("Azure Speech region", "azure_speech_region")
-                        siliconflow_tts_api_key = text_setting("SiliconFlow TTS API key", "siliconflow_tts_api_key", secret=True)
-                        _render_credential_status(siliconflow_tts_api_key)
-                        minimax_tts_api_key = text_setting("MiniMax TTS API key", "minimax_tts_api_key", secret=True)
-                        _render_credential_status(minimax_tts_api_key)
-                        minimax_tts_base_url = text_setting("MiniMax TTS Base URL", "minimax_tts_base_url")
-                        minimax_tts_model_id = text_setting("MiniMax TTS model", "minimax_tts_model_id")
-                        minimax_tts_voice_id = text_setting("MiniMax TTS voice ID", "minimax_tts_voice_id")
-                    with cols[1]:
-                        elevenlabs_api_key = text_setting("ElevenLabs API key", "elevenlabs_api_key", secret=True)
-                        _render_credential_status(elevenlabs_api_key)
-                        elevenlabs_model_id = text_setting("ElevenLabs model", "elevenlabs_model_id")
-                        chatterbox_base_url = text_setting("Chatterbox Base URL", "chatterbox_base_url")
-                        chatterbox_api_key = text_setting("Chatterbox API key", "chatterbox_api_key", secret=True)
-                        _render_credential_status(chatterbox_api_key, local=True, required=False)
-                        chatterbox_model_id = text_setting("Chatterbox model", "chatterbox_model_id")
-                        sonilo_api_key = text_setting("Sonilo API key", "sonilo_api_key", secret=True)
-                        _render_credential_status(sonilo_api_key)
-                        sonilo_base_url = text_setting("Sonilo Base URL", "sonilo_base_url")
-                        st.markdown("**Suno — agente musical opcional**")
-                        suno_api_key = text_setting("Suno API key", "suno_api_key", secret=True)
-                        _render_credential_status(suno_api_key)
-                        suno_api_base_url = text_setting("Suno API Base URL", "suno_api_base_url", help_text="Use o endpoint compatível fornecido pelo seu acesso Suno; não é inventado pelo Thunderbolt.")
-                        suno_api_endpoint = text_setting("Suno API endpoint", "suno_api_endpoint", help_text="Ex.: /api/generate")
-
-                    st.markdown(f"**{ui_text('Testar credenciais TTS e música', current_ui_language())}**")
-                    voice_test_cols = st.columns(3)
-                    with voice_test_cols[0]:
                         _render_api_test_control(
                             settings,
                             "voice:azure_speech",
                             lambda: test_voice_provider("azure_speech", {"azure_speech_key": azure_speech_key, "azure_speech_region": azure_speech_region}),
                             widget_key="api_test_voice_azure",
                         )
-                        _render_api_test_control(
-                            settings,
-                            "voice:siliconflow",
-                            lambda: test_voice_provider("siliconflow", {"siliconflow_tts_api_key": siliconflow_tts_api_key}),
-                            widget_key="api_test_voice_siliconflow",
-                        )
-                        _render_api_test_control(
-                            settings,
-                            "voice:minimax",
-                            lambda: test_voice_provider("minimax", {"minimax_tts_api_key": minimax_tts_api_key, "minimax_tts_base_url": minimax_tts_base_url}),
-                            widget_key="api_test_voice_minimax",
-                        )
-                    with voice_test_cols[1]:
+
+                    with st.container(border=True):
+                        st.markdown("#### ElevenLabs")
+                        st.caption("TTS ElevenLabs para vozes multilíngues.")
+                        elevenlabs_api_key = text_setting("ElevenLabs API key", "elevenlabs_api_key", secret=True)
+                        _render_credential_status(elevenlabs_api_key)
+                        elevenlabs_model_id = text_setting("ElevenLabs model", "elevenlabs_model_id")
                         _render_api_test_control(
                             settings,
                             "voice:elevenlabs",
                             lambda: test_voice_provider("elevenlabs", {"elevenlabs_api_key": elevenlabs_api_key}),
                             widget_key="api_test_voice_elevenlabs",
                         )
-                        _render_api_test_control(
-                            settings,
-                            "voice:chatterbox",
-                            lambda: test_voice_provider("chatterbox", {"chatterbox_api_key": chatterbox_api_key, "chatterbox_base_url": chatterbox_base_url}),
-                            widget_key="api_test_voice_chatterbox",
-                        )
-                    with voice_test_cols[2]:
-                        _render_api_test_control(
-                            settings,
-                            "voice:sonilo",
-                            lambda: test_voice_provider("sonilo", {"sonilo_api_key": sonilo_api_key, "sonilo_base_url": sonilo_base_url}),
-                            widget_key="api_test_voice_sonilo",
-                        )
+
+                    tts_cols = st.columns(2)
+                    with tts_cols[0]:
+                        with st.container(border=True):
+                            st.markdown("#### SiliconFlow")
+                            st.caption("Provider TTS SiliconFlow.")
+                            siliconflow_tts_api_key = text_setting("SiliconFlow TTS API key", "siliconflow_tts_api_key", secret=True)
+                            _render_credential_status(siliconflow_tts_api_key)
+                            _render_api_test_control(
+                                settings,
+                                "voice:siliconflow",
+                                lambda: test_voice_provider("siliconflow", {"siliconflow_tts_api_key": siliconflow_tts_api_key}),
+                                widget_key="api_test_voice_siliconflow",
+                            )
+
+                        with st.container(border=True):
+                            st.markdown("#### MiniMax TTS")
+                            st.caption("Provider MiniMax com endpoint, modelo e voz configuráveis.")
+                            minimax_tts_api_key = text_setting("MiniMax TTS API key", "minimax_tts_api_key", secret=True)
+                            _render_credential_status(minimax_tts_api_key)
+                            minimax_tts_base_url = text_setting("MiniMax TTS Base URL", "minimax_tts_base_url")
+                            minimax_tts_model_id = text_setting("MiniMax TTS model", "minimax_tts_model_id")
+                            minimax_tts_voice_id = text_setting("MiniMax TTS voice ID", "minimax_tts_voice_id")
+                            _render_api_test_control(
+                                settings,
+                                "voice:minimax",
+                                lambda: test_voice_provider("minimax", {"minimax_tts_api_key": minimax_tts_api_key, "minimax_tts_base_url": minimax_tts_base_url}),
+                                widget_key="api_test_voice_minimax",
+                            )
+
+                    with tts_cols[1]:
+                        with st.container(border=True):
+                            st.markdown("#### Chatterbox")
+                            st.caption("Provider compatível com a API OpenAI; pode ser local e sem API key.")
+                            chatterbox_base_url = text_setting("Chatterbox Base URL", "chatterbox_base_url")
+                            chatterbox_api_key = text_setting("Chatterbox API key", "chatterbox_api_key", secret=True)
+                            _render_credential_status(chatterbox_api_key, local=True, required=False)
+                            chatterbox_model_id = text_setting("Chatterbox model", "chatterbox_model_id")
+                            _render_api_test_control(
+                                settings,
+                                "voice:chatterbox",
+                                lambda: test_voice_provider("chatterbox", {"chatterbox_api_key": chatterbox_api_key, "chatterbox_base_url": chatterbox_base_url}),
+                                widget_key="api_test_voice_chatterbox",
+                            )
+
+                        with st.container(border=True):
+                            st.markdown("#### Sonilo")
+                            st.caption("Provider TTS Sonilo com endpoint próprio.")
+                            sonilo_api_key = text_setting("Sonilo API key", "sonilo_api_key", secret=True)
+                            _render_credential_status(sonilo_api_key)
+                            sonilo_base_url = text_setting("Sonilo Base URL", "sonilo_base_url")
+                            _render_api_test_control(
+                                settings,
+                                "voice:sonilo",
+                                lambda: test_voice_provider("sonilo", {"sonilo_api_key": sonilo_api_key, "sonilo_base_url": sonilo_base_url}),
+                                widget_key="api_test_voice_sonilo",
+                            )
+
+                    with st.container(border=True):
+                        st.markdown("#### Suno — agente musical opcional")
+                        st.caption("Suno é utilizado para criação de música e fica separado dos providers de voz/TTS.")
+                        suno_api_key = text_setting("Suno API key", "suno_api_key", secret=True)
+                        _render_credential_status(suno_api_key)
+                        suno_api_base_url = text_setting("Suno API Base URL", "suno_api_base_url", help_text="Use o endpoint compatível fornecido pelo seu acesso Suno; não é inventado pelo Thunderbolt.")
+                        suno_api_endpoint = text_setting("Suno API endpoint", "suno_api_endpoint", help_text="Ex.: /api/generate")
                         _render_api_test_control(
                             settings,
                             "voice:suno",

package/package.json

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