Update app.py

app.py

@@ -2,6 +2,7 @@
 # AdaptLearn Enhanced - Hugging Face Spaces Deployment
 # Next-Generation Adaptive Education System
 # Gemma 3 Hackathon Submission - GEMMA 3 COMO MODELO PRINCIPAL
+# CONFIGURAÇÃO SEGURA COM SECRETS
 # ==============================================================================
 
 import os
@@ -62,39 +63,108 @@ class Gemma3AIManager:
             "gpt2",                          # Fallback final
         ]
         
-        # Configurar token HF
+        # Configurar token HF de forma segura
         self._setup_hf_token()
         
     def _setup_hf_token(self):
-        """Configurar token do Hugging Face para Gemma 3"""
+        """Configurar token do Hugging Face para Gemma 3 usando SECRETS SEGUROS"""
         
-        # Tentar obter token de diferentes fontes
+        print("🔐 Configurando autenticação Hugging Face...")
+        
+        # Tentar obter token APENAS de secrets seguros do Hugging Face Spaces
         token_sources = [
-            os.getenv("HUGGINGFACE_HUB_TOKEN"),      # Variável de ambiente
-            os.getenv("HF_TOKEN"),                   # Alternativa comum
-            os.getenv("HUGGING_FACE_TOKEN"),         # Outra alternativa
+            os.getenv("HF_TOKEN"),                   # SECRET PRINCIPAL do Space
+            os.getenv("HUGGINGFACE_HUB_TOKEN"),      # SECRET alternativo
+            os.getenv("HUGGING_FACE_TOKEN"),         # SECRET alternativo
+            os.getenv("HF_AUTH_TOKEN"),              # SECRET alternativo
         ]
         
-        for token in token_sources:
-            if token and token.strip():
-                self.hf_token = token.strip()
-                print(f"✅ Token HF encontrado: {token[:10]}...")
-                break
+        for i, token in enumerate(token_sources):
+            if token and token.strip() and len(token.strip()) > 10:
+                # Validar formato básico do token HF
+                token_clean = token.strip()
+                if token_clean.startswith('hf_') and len(token_clean) > 30:
+                    self.hf_token = token_clean
+                    print(f"✅ Token HF válido encontrado via SECRET #{i+1}")
+                    print(f"🔐 Token formato: {token_clean[:8]}...{token_clean[-4:]}")
+                    print("🎉 GEMMA 3 SERÁ DESBLOQUEADO!")
+                    break
+                else:
+                    print(f"⚠️ Token encontrado mas formato inválido na fonte #{i+1}")
         
         if not self.hf_token:
-            print("⚠️ Token HF não encontrado - Gemma 3 não será acessível")
-            print("💡 Configure HUGGINGFACE_HUB_TOKEN nas secrets do Space")
+            print("❌ NENHUM TOKEN HF VÁLIDO ENCONTRADO")
+            print("🔐 Para ativar Gemma 3, configure um secret no Space:")
+            print("   1. Vá em Settings → Variables and secrets")
+            print("   2. Adicione um novo secret:")
+            print("      Name: HF_TOKEN")
+            print("      Value: seu_token_do_hugging_face")
+            print("   3. Reinicie o Space")
+            print("📖 Obtenha seu token em: https://huggingface.co/settings/tokens")
+            print("🔄 Usando modo fallback até token ser configurado")
         
         # Fazer login automático se token disponível
         if self.hf_token:
             try:
                 from huggingface_hub import login
-                login(token=self.hf_token)
+                login(token=self.hf_token, add_to_git_credential=False)
                 print("🎉 Login HF realizado com sucesso!")
+                print("🧠 Gemma 3 agora está disponível!")
+                return True
             except Exception as e:
                 print(f"⚠️ Erro no login HF: {e}")
+                print("🔄 Token pode estar inválido - usando fallbacks")
                 self.hf_token = None
+                return False
         
+        return False
+        
+    def get_token_status(self):
+        """Obter status detalhado do token para debugging"""
+        status = {
+            'token_configured': self.hf_token is not None,
+            'token_format_valid': False,
+            'login_successful': False,
+            'sources_checked': []
+        }
+        
+        # Verificar todas as fontes de token
+        token_sources = {
+            'HF_TOKEN': os.getenv("HF_TOKEN"),
+            'HUGGINGFACE_HUB_TOKEN': os.getenv("HUGGINGFACE_HUB_TOKEN"),
+            'HUGGING_FACE_TOKEN': os.getenv("HUGGING_FACE_TOKEN"),
+            'HF_AUTH_TOKEN': os.getenv("HF_AUTH_TOKEN")
+        }
+        
+        for name, value in token_sources.items():
+            source_status = {
+                'name': name,
+                'found': value is not None,
+                'length': len(value) if value else 0,
+                'valid_format': False
+            }
+            
+            if value and value.strip():
+                clean_token = value.strip()
+                source_status['valid_format'] = (
+                    clean_token.startswith('hf_') and 
+                    len(clean_token) > 30
+                )
+                
+            status['sources_checked'].append(source_status)
+        
+        if self.hf_token:
+            status['token_format_valid'] = True
+            # Testar se login funcionou
+            try:
+                from huggingface_hub import whoami
+                whoami(token=self.hf_token)
+                status['login_successful'] = True
+            except:
+                status['login_successful'] = False
+        
+        return status
+    
     def load_model(self):
         """Carregar Gemma 3 como prioridade principal"""
         
@@ -114,6 +184,7 @@ class Gemma3AIManager:
                     
                     if not self.hf_token:
                         print(f"⚠️ Token HF necessário para {model_name} - pulando")
+                        print("💡 Configure HF_TOKEN nas secrets do Space para usar Gemma 3")
                         continue
                     
                     try:
@@ -298,7 +369,10 @@ class Gemma3AIManager:
                 continue
         
         print("❌ Nenhum modelo pôde ser carregado - usando modo template")
-        print("💡 Para usar Gemma 3: adicione HUGGINGFACE_HUB_TOKEN nas secrets")
+        print("💡 Para usar Gemma 3:")
+        print("   1. Obtenha token em: https://huggingface.co/settings/tokens")
+        print("   2. Adicione como secret HF_TOKEN no Space")
+        print("   3. Reinicie o Space")
         return False
     
     def generate_text(self, prompt, max_new_tokens=80, task_complexity="medium", image=None):
@@ -1276,6 +1350,8 @@ def create_gradio_interface():
             
             # Status do sistema com foco no Gemma 3
             ai_status = system.ai_manager.get_status()
+            token_status = system.ai_manager.get_token_status()
+            
             tech_status = f"""
 ### 🔧 **STATUS DO SISTEMA**
 
@@ -1288,6 +1364,10 @@ def create_gradio_interface():
 **Multimodal:** {'✅ ATIVO' if ai_status.get('multimodal', False) else '🔄 Apenas Texto'}  
 **Token HF Configurado:** {'✅ SIM' if ai_status.get('hf_token_configured', False) else '❌ NÃO'}  
 
+**🔐 Detalhes do Token:**
+**Login Bem-sucedido:** {'✅ SIM' if token_status['login_successful'] else '❌ NÃO'}  
+**Formato Válido:** {'✅ SIM' if token_status['token_format_valid'] else '❌ NÃO'}  
+
 **📊 Performance:**
 **Taxa de Sucesso:** {ai_status['success_rate']:.1%}  
 **Total de Gerações:** {ai_status['total_generations']}  
@@ -1300,6 +1380,21 @@ def create_gradio_interface():
 {'✅ Templates de Chat Avançados' if ai_status.get('features', {}).get('chat_template', False) else '❌ Templates Básicos'}
 
 **🚀 {'GEMMA 3 ONLINE - MÁXIMO PODER AI!' if ai_status.get('gemma3_active', False) else 'MODO FALLBACK - AINDA TOTALMENTE FUNCIONAL!'}**
+
+**🔐 Status dos Secrets Verificados:**
+"""
+            
+            for source in token_status['sources_checked']:
+                status_icon = "✅" if source['valid_format'] else "❌" if source['found'] else "⚪"
+                tech_status += f"**{source['name']}:** {status_icon} {'Válido' if source['valid_format'] else 'Encontrado mas inválido' if source['found'] else 'Não encontrado'}\n"
+            
+            if not ai_status.get('hf_token_configured', False):
+                tech_status += """
+**💡 Para Ativar Gemma 3:**
+1. Vá em Settings → Variables and secrets
+2. Adicione secret: Name=`HF_TOKEN`, Value=`seu_token_hf`
+3. Reinicie o Space
+4. Obtenha token em: https://huggingface.co/settings/tokens
 """
             
             return adapted_content, analysis, tech_status
@@ -1329,6 +1424,7 @@ Este conteúdo foi adaptado para seu estilo de aprendizagem.
         """Testar funcionalidade do sistema com prioridade Gemma 3"""
         try:
             ai_status = system.ai_manager.get_status()
+            token_status = system.ai_manager.get_token_status()
             
             # Teste de análise
             test_state = system.analyze_learning_state("Tenho TDAH e preciso de ajuda para focar", None, None)
@@ -1351,7 +1447,7 @@ Este conteúdo foi adaptado para seu estilo de aprendizagem.
             
             ai_type = "Gemma 3 Aprimorado" if ai_status.get('gemma3_active', False) else "AI Padrão/Fallback"
             
-            return f"""
+            test_result = f"""
 ### 🧪 **TESTE ABRANGENTE DO SISTEMA**
 
 **🧠 Status AI:** {gemma_status}  
@@ -1359,11 +1455,24 @@ Este conteúdo foi adaptado para seu estilo de aprendizagem.
 **📡 Modelo:** {ai_status['model']}  
 **⚡ Capacidades:** {ai_capabilities}
 
+**🔐 Verificação de Autenticação:**
+**Login HF Realizado:** {'✅ SIM' if token_status['login_successful'] else '❌ NÃO'}  
+**Token Configurado:** {'✅ SIM' if token_status['token_configured'] else '❌ NÃO'}  
+**Formato Válido:** {'✅ SIM' if token_status['token_format_valid'] else '❌ NÃO'}
+
 **🔍 Teste de Recursos Gemma 3:**
 **Multimodal:** {'✅ FUNCIONANDO' if ai_status.get('multimodal', False) else '❌ Não Disponível'}  
 **Contexto 128K:** {'✅ ATIVO' if ai_status.get('features', {}).get('long_context', False) else '❌ Contexto Padrão'}  
-**Atenção Deslizante:** {'✅ HABILITADO' if ai_status.get('features', {}).get('sliding_window', False) else '❌ Atenção Padrão'}  
-**Token HF:** {'✅ CONFIGURADO' if ai_status.get('hf_token_configured', False) else '❌ NÃO CONFIGURADO'}
+**Atenção Deslizante:** {'✅ HABILITADO' if ai_status.get('features', {}).get('sliding_window', False) else '❌ Atenção Padrão'}
+
+**🔍 Status dos Secrets:**
+"""
+            
+            for source in token_status['sources_checked']:
+                status = "✅ Válido" if source['valid_format'] else "⚠️ Inválido" if source['found'] else "❌ Ausente"
+                test_result += f"**{source['name']}:** {status} ({source['length']} chars)\n"
+            
+            test_result += f"""
 
 **🔍 Testes de Componentes:**
 **Detecção de Perfil:** ✅ Funcionando - Detectado: {test_state['profile']}  
@@ -1384,13 +1493,34 @@ Este conteúdo foi adaptado para seu estilo de aprendizagem.
 • Taxa de Sucesso: {ai_status['success_rate']:.1%}
 
 **🚀 {'GEMMA 3 - O FUTURO DA EDUCAÇÃO AI!' if ai_status.get('gemma3_active', False) else 'FALLBACKS INTELIGENTES GARANTEM FUNCIONALIDADE COMPLETA!'}**
+"""
+            
+            if not token_status['token_configured']:
+                test_result += """
+
+**💡 INSTRUÇÕES PARA ATIVAR GEMMA 3:**
+
+**🔐 Configuração Segura dos Secrets:**
+1. **Obtenha seu token:** https://huggingface.co/settings/tokens
+2. **Vá nas configurações do Space:** Settings → Variables and secrets
+3. **Adicione um novo secret:**
+   - **Name:** `HF_TOKEN`
+   - **Value:** `hf_xxxxxxxxxxxxx` (seu token)
+4. **Clique "Add secret"**
+5. **Reinicie o Space:** Factory reboot
+6. **Aguarde o carregamento** e teste novamente
+
+**✅ Vantagens dos Secrets:**
+• Token permanece privado e seguro
+• Não exposto no código público  
+• Acesso automático ao Gemma 3
+• Conformidade com políticas do HF
 
-**💡 Instruções de Configuração:**
-Para ativar o Gemma 3:
-1. Obtenha um token do Hugging Face em: https://huggingface.co/settings/tokens
-2. Adicione o token nas secrets do Space como HUGGINGFACE_HUB_TOKEN
-3. Reinicie o Space para carregar o Gemma 3
+**🎯 Após configuração:** Sistema automaticamente detectará e usará Gemma 3!
 """
+            
+            return test_result
+            
         except Exception as e:
             return f"❌ Teste falhou: {e}"
     
@@ -1426,6 +1556,7 @@ Para ativar o Gemma 3:
         gr.Markdown("""
         # 🎓 AdaptLearn Enhanced - Gemma 3 Edition
         ### Sistema de Educação Adaptativa de Nova Geração - Powered by Gemma 3
+        ### 🔐 **SISTEMA SEGURO COM SECRETS** 🔐
         
         **🚀 RECURSOS GEMMA 3 PRINCIPAIS:**
         • 🧠 **Motor Gemma 3 Autêntico** - Modelo multimodal de última geração do Google  
@@ -1437,7 +1568,7 @@ Para ativar o Gemma 3:
         • 🌐 **Acesso Cloud 24/7** - Poder AI confiável disponível em qualquer lugar  
         • 📱 **Compatibilidade Universal** - Experiência completa em todos os dispositivos
         
-        **💡 Configuração Gemma 3:** Para desbloquear as capacidades completas do Gemma 3, adicione seu token Hugging Face nas secrets do Space
+        **🔐 Segurança:** Tokens são gerenciados via secrets seguros do Hugging Face Spaces
         """, elem_classes=["gemma3-box"])
         
         with gr.Row():
@@ -1448,7 +1579,7 @@ Para ativar o Gemma 3:
                     label="👤 Descreva Seu Perfil de Aprendizagem",
                     placeholder="ex: Tenho dislexia e preciso de explicações simples, ou Tenho TDAH e me distraio facilmente...",
                     value="Tenho TDAH e preciso de conteúdo interativo e envolvente com pausas frequentes",
-                    info="🧠 O Gemma 3 analisará e se adaptará às suas necessidades específicas com inteligência multimodal"
+                    info="🧠 O Gemma 3 analisará suas necessidades específicas com inteligência multimodal (requer token nas secrets)"
                 )
                 
                 gr.Markdown("---")
@@ -1459,7 +1590,7 @@ Para ativar o Gemma 3:
                     lines=4,
                     placeholder="Digite qualquer conteúdo educacional que deseja adaptar...",
                     value="A fotossíntese é o processo pelo qual as plantas convertem luz solar, água e dióxido de carbono em glicose e oxigênio usando clorofila.",
-                    info="🎯 O Gemma 3 adaptará inteligentemente este conteúdo com compreensão multimodal"
+                    info="🎯 O Gemma 3 adaptará inteligentemente este conteúdo com compreensão multimodal (requer token nas secrets)"
                 )
                 
                 profile_input = gr.Textbox(
@@ -1676,16 +1807,30 @@ Para ativar o Gemma 3:
         
         ---
         
-        ### 🔧 **Configuração do Token Gemma 3**
+        ### 🔐 **Configuração Segura do Token Gemma 3**
+        
+        **Para ativar o Gemma 3 com segurança:**
         
-        Para ativar as capacidades completas do Gemma 3:
+        1. **🎫 Obtenha seu token:** Vá em https://huggingface.co/settings/tokens
+        2. **⚙️ Abra Settings do Space:** Clique em "Settings" no topo da página
+        3. **🔒 Vá para Secrets:** Clique em "Variables and secrets"
+        4. **➕ Adicione novo secret:**
+           - **Name**: `HF_TOKEN`
+           - **Value**: `hf_xxxxxxxxxx` (seu token HF)
+        5. **💾 Salve o secret:** Clique em "Add secret"
+        6. **🔄 Reinicie o Space:** Clique em "Factory reboot"
+        7. **⏱️ Aguarde o carregamento** e teste o sistema
         
-        1. **Obtenha um Token HF**: Vá para https://huggingface.co/settings/tokens
-        2. **Crie um Token**: Clique em "New token" e selecione permissões "Read"
-        3. **Configure no Space**: Adicione o token como `HUGGINGFACE_HUB_TOKEN` nas secrets do Space
-        4. **Reinicie**: Restart o Space para carregar o Gemma 3
+        **🔐 Vantagens dos Secrets:**
+        - ✅ Token permanece privado e seguro
+        - ✅ Não exposto no código público
+        - ✅ Acesso automático ao Gemma 3
+        - ✅ Conformidade com políticas do HF
+        - ✅ Carregamento automático na inicialização
         
-        **💡 Sem token**: O sistema funcionará com fallbacks inteligentes, mas sem capacidades Gemma 3
+        **💡 Status atual**: Sistema funcionará com fallbacks inteligentes até token ser configurado nas secrets
+        
+        **🎯 Após configuração**: Reinicie o Space e o Gemma 3 será carregado automaticamente!
         """)
     
     return demo
@@ -1702,10 +1847,12 @@ def main():
     ║                  ADAPTLEARN ENHANCED                         ║
     ║              Powered by Gemma 3 Multimodal AI               ║
     ║              Hugging Face Spaces Edition                     ║
+    ║                   CONFIGURAÇÃO SEGURA                        ║
     ╚══════════════════════════════════════════════════════════════╝
     """)
     
-    print("🚀 AdaptLearn Enhanced - Deployment Gemma 3:")
+    print("🚀 AdaptLearn Enhanced - Deployment Seguro Gemma 3:")
+    print("  🔐 Autenticação: Somente via secrets seguros do HF Spaces")
     print("  🧠 Primário: Gemma 3 Multimodal para compreensão visão + linguagem")
     print("  🎯 Secundário: Gemma 3 Text-only para processamento avançado de linguagem")
     print("  🔄 Fallbacks: Gemma 2 e outros modelos para confiabilidade") 
@@ -1713,6 +1860,7 @@ def main():
     print("  🎯 Geração de conteúdo adaptativo multimodal em tempo real")
     print("  🌐 Disponibilidade cloud 24/7 no Hugging Face Spaces")
     print("  📱 Interface otimizada para mobile e desktop")
+    print("  🔐 Zero hardcoded tokens - máxima segurança")
     print("")
     
     try:
@@ -1754,8 +1902,9 @@ def get_system_capabilities():
     """Obter capacidades do sistema para documentação"""
     return {
         'name': 'AdaptLearn Enhanced',
-        'version': '3.0 - Gemma 3 Edition',
-        'deployment': 'Cloud-otimizado para Hugging Face Spaces',
+        'version': '3.0 - Gemma 3 Edition (Secure)',
+        'deployment': 'Cloud-otimizado para Hugging Face Spaces com configuração segura',
+        'security': 'Autenticação via secrets seguros - zero hardcoded tokens',
         'primary_ai_models': ['google/gemma-3-4b-it', 'google/gemma-3-2b-it', 'google/gemma-3-1b-pt'],
         'fallback_models': ['google/gemma-2-2b-it', 'microsoft/DialoGPT-medium', 'distilgpt2', 'gpt2'],
         'learning_profiles': ['Neurotípico', 'Dislexia', 'TDAH', 'Autismo', 'Deficiência Auditiva'],
@@ -1769,6 +1918,13 @@ def get_system_capabilities():
             'Templates de chat avançados',
             'Adaptação educacional AI'
         ],
+        'security_features': [
+            'Gestão segura de tokens via HF Secrets',
+            'Zero exposição de credenciais no código',
+            'Validação automática de formato de token',
+            'Login seguro com fallback inteligente',
+            'Monitoramento de status de autenticação'
+        ],
         'features': [
             'Análise multimodal em tempo real',
             'Adaptação de conteúdo powered by AI', 
@@ -1776,9 +1932,10 @@ def get_system_capabilities():
             'Gamificação adaptativa',
             'Deploy cloud pronto',
             'Otimizado para mobile',
-            'Sistemas de fallback',
+            'Sistemas de fallback robustos',
             'Disponibilidade 24/7',
-            'Suporte Gemma 3 autêntico'
+            'Suporte Gemma 3 autêntico',
+            'Configuração segura via secrets'
         ],
         'accessibility': {
             'dyslexia_support': True,
@@ -1794,18 +1951,143 @@ def get_system_capabilities():
             'audio_analysis': 'Algoritmos customizados',
             'visual_analysis': 'OpenCV + custom',
             'deployment': 'Hugging Face Spaces',
+            'security': 'HF Secrets Management',
             'fallback_systems': 'Adaptação baseada em template + Gemma 2'
         }
     }
 
+def validate_hf_token_format(token):
+    """Validar formato do token Hugging Face"""
+    if not token or not isinstance(token, str):
+        return False, "Token deve ser uma string"
+    
+    token = token.strip()
+    
+    if not token.startswith('hf_'):
+        return False, "Token deve começar com 'hf_'"
+    
+    if len(token) < 35:
+        return False, "Token muito curto (mínimo 35 caracteres)"
+    
+    if len(token) > 50:
+        return False, "Token muito longo (máximo 50 caracteres)"
+    
+    # Verificar caracteres válidos (alphanumeric + underscore)
+    valid_chars = set('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_')
+    if not all(c in valid_chars for c in token):
+        return False, "Token contém caracteres inválidos"
+    
+    return True, "Token com formato válido"
+
+def get_token_setup_instructions():
+    """Obter instruções detalhadas para configuração do token"""
+    return {
+        'steps': [
+            {
+                'step': 1,
+                'title': 'Obter Token HF',
+                'description': 'Vá para https://huggingface.co/settings/tokens',
+                'details': 'Crie um token com permissões de leitura de repositórios'
+            },
+            {
+                'step': 2,
+                'title': 'Acessar Settings do Space',
+                'description': 'Clique em "Settings" no topo da página do Space',
+                'details': 'Procure pelo ícone de engrenagem ao lado do nome do Space'
+            },
+            {
+                'step': 3,
+                'title': 'Ir para Secrets',
+                'description': 'Clique em "Variables and secrets"',
+                'details': 'Esta seção permite configurar variáveis privadas'
+            },
+            {
+                'step': 4,
+                'title': 'Adicionar Secret',
+                'description': 'Clique em "New secret"',
+                'details': 'Configure: Name = HF_TOKEN, Value = seu_token_hf'
+            },
+            {
+                'step': 5,
+                'title': 'Salvar e Reiniciar',
+                'description': 'Salve o secret e reinicie o Space',
+                'details': 'Use "Factory reboot" para garantir carregamento completo'
+            }
+        ],
+        'tips': [
+            'O token deve começar com "hf_"',
+            'Mantenha o token privado e seguro',
+            'Não compartilhe o token em código público',
+            'O sistema detectará automaticamente o token configurado',
+            'Após configuração, o Gemma 3 será carregado automaticamente'
+        ],
+        'troubleshooting': {
+            'token_not_detected': 'Verifique se o nome do secret é exatamente "HF_TOKEN"',
+            'invalid_format': 'Token deve começar com "hf_" e ter 35-50 caracteres',
+            'login_failed': 'Verifique se o token tem permissões adequadas',
+            'model_not_loading': 'Tente fazer "Factory reboot" do Space'
+        }
+    }
+
+def generate_status_report():
+    """Gerar relatório de status do sistema"""
+    try:
+        # Verificar disponibilidade de bibliotecas
+        libs_status = {
+            'transformers': TRANSFORMERS_AVAILABLE,
+            'opencv': OPENCV_AVAILABLE,
+            'torch': True,  # Assumindo que está disponível se transformers funciona
+            'gradio': True,  # Necessário para interface
+            'numpy': True   # Dependência básica
+        }
+        
+        # Verificar tokens disponíveis
+        token_sources = {
+            'HF_TOKEN': os.getenv("HF_TOKEN") is not None,
+            'HUGGINGFACE_HUB_TOKEN': os.getenv("HUGGINGFACE_HUB_TOKEN") is not None,
+            'HUGGING_FACE_TOKEN': os.getenv("HUGGING_FACE_TOKEN") is not None,
+            'HF_AUTH_TOKEN': os.getenv("HF_AUTH_TOKEN") is not None
+        }
+        
+        # Verificar se algum token válido está disponível
+        valid_token_found = False
+        for token_name, token_value in token_sources.items():
+            if token_value:
+                token = os.getenv(token_name)
+                if token and validate_hf_token_format(token)[0]:
+                    valid_token_found = True
+                    break
+        
+        return {
+            'timestamp': datetime.now().isoformat(),
+            'libraries': libs_status,
+            'tokens': token_sources,
+            'valid_token_available': valid_token_found,
+            'gemma3_ready': TRANSFORMERS_AVAILABLE and valid_token_found,
+            'fallback_available': TRANSFORMERS_AVAILABLE,
+            'system_ready': True  # Sistema sempre funciona com fallbacks
+        }
+        
+    except Exception as e:
+        return {
+            'timestamp': datetime.now().isoformat(),
+            'error': str(e),
+            'system_ready': True  # Sistema sempre funciona com templates
+        }
+
 # Exportar componentes principais
 __all__ = [
     'AdaptiveEducationSystem',
     'Gemma3AIManager',
     'create_gradio_interface',
-    'get_system_capabilities'
+    'get_system_capabilities',
+    'validate_hf_token_format',
+    'get_token_setup_instructions',
+    'generate_status_report'
 ]
 
-print("🎓 AdaptLearn Enhanced - Gemma 3 Multimodal Edition Pronto!")
+print("🎓 AdaptLearn Enhanced - Gemma 3 Multimodal Edition Seguro!")
+print("🔐 Configuração segura com secrets - zero tokens hardcoded")
 print("🧠 Prioriza Gemma 3 multimodal AI com sistemas de fallback inteligentes")
 print("🚀 Execute main() para lançar a aplicação aprimorada com Gemma 3")
+print("💡 Configure HF_TOKEN nas secrets do Space para ativar Gemma 3!")