✅ Guia completo — sem complicações

Instale o UniBB Bot
em 5 passos simples

Guia visual interativo. Mesmo sem experiência técnica você consegue instalar em menos de 15 minutos.

🚀 Começar instalação agora
1
Baixar ZIP
2
Extrair
3
Instalar
4
Configurar
5
Pronto!
📦
Passo 1 de 5
Baixar o pacote de instalação
Clique no botão abaixo para baixar o ZIP completo com tudo que precisa.
💡
O arquivo ZIP contém o bot, os scripts de instalação automática, a extensão Chrome e todos os arquivos necessários. Você não precisa baixar mais nada separado — o instalador faz tudo.
📦
UniBB-Bot-v2.0-Windows.zip RECOMENDADO
Inclui: bot, instalador, extensão Chrome, todos os scripts
📦 Gerar e Baixar ZIP
⚠️
Onde salvar o ZIP?
Salve em um lugar fácil de encontrar, por exemplo na Área de Trabalho ou em C:\UniBBBot.
Não salve em pastas com acentos ou espaços no nome (ex: evite "Área de Trabalho" como destino de extração).
📂
Passo 2 de 5
Extrair o ZIP corretamente
Esta etapa é muito importante — siga exatamente as instruções para evitar o erro de "arquivo não encontrado".
🚨
Erro comum: Não execute o instalador de dentro do ZIP! Primeiro extraia, depois execute.
Outro erro comum: extrair dentro de uma pasta que já tem o nome errado, criando pastas duplas.
1
Crie uma pasta nova e simples
Exemplo: C:\UniBBBot — Abra o Explorador de Arquivos, vá em Disco C:\ e crie uma pasta chamada UniBBBot
2
Clique com botão direito no ZIP
Selecione "Extrair tudo..." (Windows 10/11) ou "Extrair aqui" (WinRAR/7-Zip)
3
Escolha o destino C:\UniBBBot
Mude o destino para a pasta que você criou. Clique em Extrair.
✓
A estrutura correta deve ser assim:
C:\UniBBBot\ ├── instalar.bat ← clique duplo aqui para instalar ├── iniciar.bat ├── index.html ├── setup.html ├── python\ │ ├── app.py │ ├── bot.py │ └── requirements.txt └── chrome-extension\
❌
Errado: C:\UniBBBot\UniBB-Bot-v2.0\instalar.bat — isso é dupla extração! Volte ao passo anterior.
⚙️
Passo 3 de 5
Executar o instalador automático
O instalador cuida de tudo: Visual C++, Java, Python, bibliotecas e Chromium.
🤖
O instalador faz tudo sozinho!
Ele baixa e instala automaticamente todos os programas necessários. Você só precisa clicar Sim quando aparecer alguma janela de permissão.
Tempo estimado: 5 a 15 minutos dependendo da sua internet.
📋 O instalador irá instalar automaticamente:
⚙️ Microsoft Visual C++ Redistributable 2015-2022
~25 MB
☕ Java JDK 21 LTS (Eclipse Temurin)
~160 MB
🐍 Python 3.12.3
~27 MB
📦 Flask, SocketIO, OpenAI, Playwright e mais
~50 MB
🌐 Chromium (navegador do bot)
~130 MB
▶ Como executar o instalador:
🖱️
Opção 1 — Mais fácil (recomendada)
Clique com o botão direito no arquivo instalar.bat → "Executar como administrador"
💻
Opção 2 — Via CMD
cd /d C:\UniBBBot
instalar.bat
🛡️
Se aparecer "O Windows protegeu seu computador":
Clique em "Mais informações" → "Executar mesmo assim". Isso acontece porque o arquivo foi baixado da internet.
⏳
Durante a instalação, o CMD ficará aberto mostrando o progresso.
Não feche a janela preta! Aguarde até ver "INSTALAÇÃO CONCLUÍDA COM SUCESSO!"
🔑
Passo 4 de 5
Configurar suas credenciais
Edite o arquivo .env com seus dados do Banco do Brasil e OpenAI.
📝
Ao final do instalador, ele pergunta se deseja abrir o .env. Responda S e pressione Enter.
Se não abriu, o arquivo fica em: C:\UniBBBot\python\.env
📄 O que preencher no arquivo .env:
📄 python\.env — Arquivo de configuração
UNIBB_CHAVE
Sua chave funcional BB — começa com F, Z ou pode ser seu e-mail BB
UNIBB_SENHA
A mesma senha que você usa para acessar unibb.com.br
OPENAI_API_KEY
Chave da API OpenAI para o GPT-4o responder as questões → obter chave grátis
HEADLESS
True = bot trabalha em segundo plano sem abrir janela
🔑 Como obter a chave OpenAI (gratuita nos primeiros créditos):
1️⃣ Acesse platform.openai.com/signup e crie uma conta gratuita
2️⃣ Vá em platform.openai.com/api-keys e clique em "Create new secret key"
3️⃣ Copie a chave (começa com sk-proj-...) e cole no campo acima
💡
Sem chave OpenAI? O bot ainda funciona para automação de vídeos e PDFs. As respostas de questões e provas ficam desativadas até você configurar a chave.
🎉
Passo 5 de 5
Tudo pronto! Iniciar o bot
Sua instalação está completa. Agora é só iniciar e usar!
🎉
Instalação concluída!
O UniBB Bot está instalado e configurado. Siga os passos abaixo para iniciar e usar o bot.
🚀 Opção 1 — Atalho na Área de Trabalho
O instalador criou um atalho chamado "UniBB Bot" na sua Área de Trabalho.
Clique duas vezes nele para iniciar o servidor. O navegador abrirá automaticamente em http://localhost:5000
📁 Opção 2 — Arquivo iniciar.bat
Na pasta C:\UniBBBot, clique duas vezes em iniciar.bat
📱 Depois que o painel abrir no navegador:
1 Digite sua Chave Funcional (F1234567) e Senha BB
2 Selecione o tipo de usuário e o portal (unibb.com.br)
3 Clique em "CONECTAR E INICIAR BOT"
4 No módulo Cursos, clique "ESCANEAR MEUS CURSOS" e depois "🤖 Automação Completa"
🧩 Bônus: Instalar a Extensão Chrome
1. Abra o Chrome e acesse chrome://extensions
2. Ative o Modo Desenvolvedor (chave no canto superior direito)
3. Clique em "Carregar sem compactação"
4. Selecione a pasta C:\UniBBBot\chrome-extension
✓ O ícone 🤖 aparecerá na barra do Chrome. Clique para abrir o painel da extensão.
🚀 Abrir Painel do Bot 🏠 Painel Principal
🔧 Problemas Comuns e Soluções
❌ Erro: "python: can't open file ... app.py: No such file or directory"
Causa: O arquivo foi extraído em lugar errado ou dentro de subpastas.

Solução:
1. Localize onde está o app.py no seu computador (use o buscador do Windows)
2. O iniciar.bat deve estar na pasta PAI da pasta python\
3. Estrutura correta: C:\UniBBBot\iniciar.bat + C:\UniBBBot\python\app.py
❌ Erro: "Python não encontrado" ou "'python' is not recognized"
Causa: Python não está no PATH do Windows.

Solução:
1. Execute o instalar.bat como Administrador — ele instala o Python automaticamente
2. Ou desinstale e reinstale o Python manualmente marcando "Add python.exe to PATH"
3. Reinicie o computador após a instalação
🛡️ Windows bloqueou o instalar.bat ("O Windows protegeu seu PC")
Isso é normal para arquivos baixados da internet.

Solução:
1. Clique em "Mais informações"
2. Clique em "Executar mesmo assim"
3. Confirme com "Sim" no UAC (Controle de Conta de Usuário)
❌ Erro ao instalar dependências (pip install falhou)
Causas possíveis: sem internet, firewall corporativo, antivírus.

Soluções:
1. Verifique sua conexão com a internet
2. Desative temporariamente o antivírus e tente novamente
3. Execute o CMD como Administrador e rode manualmente:
cd C:\UniBBBot\python
pip install -r requirements.txt
❌ A página http://localhost:5000 não abre
Causas possíveis: servidor não iniciou, porta em uso, firewall.

Soluções:
1. Verifique se a janela do iniciar.bat está aberta e sem erros
2. Tente acessar http://127.0.0.1:5000
3. Se a porta 5000 estiver em uso, edite o .env e mude PORT=5001
4. Verifique se o Windows Firewall não está bloqueando o Python
❌ Chromium não instala (playwright install chromium falhou)
Solução manual:
Abra o CMD como Administrador e execute: 
python -m playwright install chromium
Se ainda falhar, verifique se há firewall ou proxy bloqueando o download.
🤖 UniBB Bot v2.0 — Automação Inteligente para Universidade Corporativa BB  |  Painel  |  Baixar ZIP  |  Downloads