🤖 Ambientando o Robô Fofoqueiro

# ===================================================================
#              Setup do Robô Fofoqueiro da Acessibilidade
# ===================================================================
# Objetivo: Configurar o ambiente no Google Colab instalando bibliotecas,
#           criando pastas e exibindo mensagens de boas-vindas do robô.
# Alunos: [A SER PREENCHIDO]
# Orientadora: Gisele Nunes
# Data  : 2026
# ===================================================================

# -*- coding: utf-8 -*-

# Importa o módulo sys para acessar funcionalidades do sistema, como verificar
# se estamos rodando no Google Colab.
import sys

# Importa o módulo os para criar pastas no sistema de arquivos.
import os

def verifica_ambiente():
    # Verifica se o módulo 'google.colab' está presente nos módulos carregados.
    # Se estiver, significa que o código está rodando dentro do Google Colab.
    if 'google.colab' in sys.modules:
        # Exibe mensagem de confirmação para o usuário.
        print("✅ Tamo no Colab! Bagulho doido vai rodar lisinho.")
        # Retorna True indicando ambiente válido.
        return True
    else:
        # Caso contrário, avisa que o ambiente não é o Colab.
        print("❌ Eita! Isso aqui não é o Colab, meu consagrado.")
        # Retorna False indicando ambiente inválido.
        return False

# Chama a função de verificação e armazena o resultado na variável AMBIENTE_COLAB.
AMBIENTE_COLAB = verifica_ambiente()

# Se o ambiente NÃO for o Colab (ou seja, verifica_ambiente retornou False),
# interrompe a execução do programa com uma mensagem de erro.
if not AMBIENTE_COLAB:
    raise SystemExit("Para de viajar, sobe esse notebook no Colab primeiro!")

# Exibe uma mensagem informando que as instalações vão começar.
print("\n📦 Instalando as paradinhas... Pega um café...")

# Lista com os nomes das bibliotecas que serão instaladas.
bibliotecas = ["speechrecognition", "gtts", "opencv-python", "pandas", "numpy", "pydub", "requests", "IPython"]

# Percorre cada biblioteca na lista para instalar.
for lib in bibliotecas:
    # Se a biblioteca for 'speechrecognition', instala com o nome 'SpeechRecognition'
    # e a flag -q (quiet) para reduzir a saída no terminal.
    if lib == "speechrecognition":
        !pip install SpeechRecognition -q
    # Se for a biblioteca opencv-python, instala a versão headless (sem interface gráfica),
    # mais leve para servidores e ambientes como Colab.
    elif lib == "opencv-python":
        !pip install opencv-python-headless -q
    # Se for pydub, além de instalar a biblioteca via pip, instala o ffmpeg (necessário para
    # manipulação de áudio) usando o gerenciador de pacotes apt-get.
    elif lib == "pydub":
        !pip install pydub -q
        !apt-get install -y ffmpeg -qq
    # Para todas as outras bibliotecas, instala normalmente via pip.
    else:
        !pip install {lib} -q
    # Exibe mensagem de que a biblioteca foi instalada com sucesso.
    print(f" ✅ {lib} instalado")

# Após a instalação, importa as bibliotecas para uso no código.

# Biblioteca para reconhecimento de fala (transformar áudio em texto).
import speech_recognition as sr

# Biblioteca para converter texto em áudio (Text-to-Speech).
from gtts import gTTS

# Biblioteca para visão computacional (processamento de imagens e vídeo).
import cv2

# Biblioteca para manipulação de dados estruturados (tabelas/planilhas).
import pandas as pd

# Biblioteca para operações matemáticas e arrays multidimensionais.
import numpy as np

# Biblioteca para manipulação de áudio (cortar, converter, etc.).
from pydub import AudioSegment

# Bibliotecas para requisições HTTP, manipulação de JSON, serialização com pickle e controle de tempo.
import requests, json, pickle, time

# Biblioteca do Google Colab para exibir áudio e outros elementos interativos.
from IPython.display import Audio, display

# Mensagem final de que todas as importações foram bem-sucedidas.
print("\n🎉 Bibliotecas importadas com sucesso!")

# Lista com os nomes das pastas que serão criadas no ambiente.
pastas = ["sons", "imagens", "logs", "codigos"]

# Percorre cada nome de pasta na lista.
for pasta in pastas:
    # Tenta criar a pasta. O parâmetro exist_ok=True evita erro se a pasta já existir.
    os.makedirs(pasta, exist_ok=True)
    # Confirma a criação da pasta para o usuário.
    print(f" 📂 Pasta '{pasta}/' criada")

# String com uma arte ASCII representando o robô fofoqueiro.
ascii_robo = r"""
   _________________________
  /                         \
 |  🤖 ROBÔ FOFOQUEIRO 🤖    |
 |  "Eu sei o que você fez   |
 |   no último Natal..."     |
  \_________________________/
"""

# Exibe a arte ASCII na tela.
print("\n" + ascii_robo)

# Mensagem de boas-vindas indicando que o robô está pronto.
print("👉 Fala meu parça! O trem tá no ar.")

# Exibe um cabeçalho visual para a checklist final.
print("\n📋 CHECKLIST FINAL")
print("="*50)

# Mensagem final confirmando que o setup foi concluído.
print("✅ Setup concluído com sucesso!")
print("="*50)

# Mensagem de despedida/humor do robô.
print("\n🤖 'Ó o trem agora é oficial: Robô Fofoqueiro na área!'")
# FIM DO SETUP