⚙️ Guia Completo de Instalação — Windows

Instale o UniBB Bot
em 6 passos

Do zero ao bot funcionando em menos de 15 minutos. Siga cada etapa na ordem indicada.

1
Baixar ZIP
2
Python 3.12
3
instalar.bat
4
Configurar .env
5
iniciar.bat
6
Acessar Painel
1
ZIP
2
Python
3
instalar.bat
4
.env
5
Iniciar
6
Painel
1
📦 Baixar o Pacote UniBB Bot (ZIP)
Baixe o arquivo ZIP completo com todos os arquivos do bot
Obrigatório ▼

O pacote ZIP contém o painel web, o bot Python, o instalador automático e todos os arquivos necessários para funcionar.

📦
UniBB-Bot-v2.0-Windows.zip
Inclui: painel web · bot Python · instalar.bat · iniciar.bat · todos os arquivos
📦 Gerar e Baixar ZIP
⚠️
Acesse a página Gerar ZIP e clique em "GERAR E BAIXAR ZIP". O arquivo será gerado e baixado automaticamente pelo seu navegador.

Após baixar, extraia o ZIP em uma pasta de fácil acesso:

Explorador de Arquivos
Clique direito no ZIP → Extrair tudo...
Pasta de destino: C:\UniBBBot\

C:\UniBBBot\
├── instalar.bat ← execute este no passo 3
├── iniciar.bat
├── index.html
├── downloads.html
├── python\
│ ├── app.py
│ ├── bot.py
│ └── requirements.txt
└── README.md
2
🐍 Instalar o Python 3.12
Linguagem necessária para rodar o bot — instale com ADD TO PATH ativado
Obrigatório ▼
ℹ️
Atenção: se você já tem o Python 3.10+ instalado, pode pular este passo. Verifique abrindo o CMD e digitando python --version.

Baixe o instalador oficial do Python 3.12:

🐍
Python 3.12.3 — Windows 64-bit
Instalador oficial · python.org · ~28 MB
⬇ Baixar .exe 🌐 Site oficial

Durante a instalação do Python — siga EXATAMENTE estes passos:

Python 3.12.3 (64-bit) Setup
☑ MARQUE: Add python.exe to PATH (caixa na parte inferior da tela)
→ Install Now (instalação padrão para o usuário atual)

✔ Setup was successful
🚫
NÃO esqueça de marcar "Add python.exe to PATH"! Se esquecer, o instalador automático (instalar.bat) não encontrará o Python.

Verifique a instalação abrindo o Prompt de Comando (CMD) e digitando:

Prompt de Comando — Verificação
C:\> python --version
Python 3.12.3 ✔
C:\> pip --version
pip 24.0 from ... (python 3.12) ✔
3
🛠️ Executar o instalar.bat
Instalador automático — configura tudo em 7 etapas com um duplo clique
✨ Auto-instala tudo ▼

Dentro da pasta extraída (C:\UniBBBot\), localize o arquivo instalar.bat e execute como Administrador.

Windows Explorer
Clique direito em instalar.bat
→ Executar como administrador

Se aparecer aviso do Windows Defender:
→ Mais informações → Executar assim mesmo
⚠️
É necessário executar como Administrador para instalar as dependências do sistema corretamente. Se não tiver permissão de admin, o bot ainda pode funcionar, mas algumas etapas podem falhar.

O instalador executa automaticamente 7 etapas:

instalar.bat — Console de Instalação
=========================================================
UniBB Bot v2.0 - Instalador Automatico Windows
=========================================================
[1/7] ✔ Microsoft Visual C++ Redistributable 2015-2022 x64
[2/7] ✔ Java JDK 21 LTS (Eclipse Temurin / OpenJDK)
[3/7] ✔ Python 3.12.3 encontrado!
[4/7] Instalando dependências Python...
✔ Flask, Playwright, OpenAI, SocketIO instalados!
[5/7] Baixando Chromium (~130MB)...
✔ Chromium instalado!
[6/7] ✔ Arquivo python\.env criado!
[7/7] ✔ Atalho "UniBB Bot" criado na Área de Trabalho!
=========================================================
INSTALAÇÃO CONCLUÍDA COM SUCESSO!
=========================================================
Abrir .env para configurar agora? (S/N):
✅
Ao final, o instalador perguntará se deseja abrir o arquivo .env para configurar as credenciais. Digite S e pressione Enter para abrir automaticamente no Bloco de Notas.

⏱️ Tempo estimado: 5 a 15 minutos dependendo da velocidade da sua internet (o Chromium tem ~130 MB).

4
🔑 Configurar as credenciais (.env)
Edite o arquivo .env com sua chave funcional, senha e API Key do OpenAI
Obrigatório ▼

O arquivo python\.env contém todas as suas credenciais. Ele é lido pelo bot na inicialização. Nunca compartilhe esse arquivo com ninguém.

Para abrir o arquivo .env:

Localizar e editar o .env
Opção 1: O instalador abre automaticamente quando você digita "S"

Opção 2: Abra manualmente:
C:\UniBBBot\python\.env
(clique direito → Abrir com → Bloco de Notas)

Opção 3: Via CMD:
notepad C:\UniBBBot\python\.env

Conteúdo do arquivo .env — preencha os valores:

python\.env — Configuração 
# UniBB Bot v2.0 - Configuracao
# Edite este arquivo com suas credenciais reais

# ── Credenciais do Banco do Brasil ──
UNIBB_CHAVE=F1234567           # Sua chave funcional (F, Z ou e-mail)
UNIBB_SENHA=sua_senha_bb      # Senha dos portais externos

# ── Inteligência Artificial ──
OPENAI_API_KEY=sk-proj-xxxxx  # Chave da API OpenAI (obrigatória)

# ── Portal UniBB ──
PORTAL_URL=https://www.unibb.com.br
TIPO_USUARIO=funcionario       # funcionario | estagiario | aposentado

# ── Configurações do Bot ──
HEADLESS=True                  # True=sem janela | False=com janela visível
VELOCIDADE=normal             # slow | normal | fast
PORT=5000

Como obter cada credencial:

🔐
Segurança: O arquivo .env contém credenciais sensíveis. Nunca o envie por e-mail, WhatsApp ou Git. O bot usa essas informações apenas localmente, nunca as envia para servidores externos.

Após editar, salve o arquivo com Ctrl+S e feche o Bloco de Notas.

5
🚀 Iniciar o Servidor
Execute o iniciar.bat para subir o servidor Flask na porta 5000
Obrigatório ▼

Com as dependências instaladas e o .env configurado, é hora de iniciar o bot! Dê duplo clique em iniciar.bat ou use o atalho criado na Área de Trabalho.

Opção 1 — iniciar.bat (recomendado)

Windows Explorer
📁 C:\UniBBBot\
└── iniciar.bat
↑ Duplo clique aqui

Opção 2 — Via CMD / Terminal

cmd.exe
C:\> cd C:\UniBBBot\python
C:\UniBBBot\python> python app.py

O que você verá no console após iniciar:

UniBB Bot — Servidor
Iniciando UniBB Bot...
✔ Servidor Flask iniciado
✔ SocketIO WebSocket pronto
✔ Bot Playwright carregado
* Running on http://localhost:5000
* WebSocket server ready
🌐 Acesse: http://localhost:5000
✅
Mantenha o console aberto! O servidor precisa ficar rodando enquanto você usa o bot. Para encerrar, feche a janela ou pressione Ctrl+C no terminal.
6
🌐 Acessar o Painel e Usar o Bot
Abra o painel no navegador, conecte e inicie a automação
Pronto! ▼

Com o servidor rodando, abra o Google Chrome e acesse o painel de controle do bot:

http://localhost:5000
ou abra o arquivo index.html diretamente na pasta

Como usar o painel:

🎉
Pronto! O bot irá acessar o UniBB, navegar pelos cursos e completar automaticamente os módulos — assistindo vídeos, lendo PDFs e respondendo questões com IA.
💻
Requisitos do Sistema
O que você precisa ter antes de instalar
🟢 Requisitos Obrigatórios
  • ✔Windows 10/11 64-bit
  • ✔Python 3.10+ (3.12 recomendado)
  • ✔OpenAI API Key (GPT-4o)
  • ✔Internet ativa (UniBB + OpenAI)
  • ✔RAM: 4 GB+ recomendado
  • ✔Disco: ~700 MB livres (Python + Chromium + libs)
🟡 Auto-instalados pelo instalar.bat
  • ⬇Visual C++ 2015-2022 Redistributable (~25 MB)
  • ⬇Java JDK 21 LTS (Eclipse Temurin / OpenJDK) (~160 MB)
  • ⬇Flask + SocketIO + Playwright (via pip)
  • ⬇Chromium via Playwright (~130 MB)
  • ⬇OpenAI SDK e demais libs Python
  • ⬇Atalho na Área de Trabalho
❓
Perguntas Frequentes
Problemas comuns e como resolvê-los
"python não é reconhecido como comando" — O que fazer?
Isso acontece quando o Python foi instalado sem a opção "Add to PATH".

Solução: 1) Desinstale o Python pelo Painel de Controle. 2) Reinstale marcando ☑ Add python.exe to PATH na primeira tela do instalador. 3) Feche e abra um novo CMD e tente novamente.
O Windows Defender bloqueou o instalar.bat — é seguro?
Sim, é seguro. O Windows Defender bloqueia scripts .bat por padrão como medida de precaução.

Para executar: clique em "Mais informações" na janela de aviso do SmartScreen, depois clique em "Executar assim mesmo". O script apenas baixa e instala programas públicos (Python, Java, etc.).
Erro ao instalar o Chromium — "download failed"
O download do Chromium (~130 MB) pode falhar se a internet estiver instável.

Solução: Abra o CMD na pasta C:\UniBBBot\python\ e execute manualmente: python -m playwright install chromium. Se falhar novamente, aguarde alguns minutos e tente outra vez.
Como obter a chave OpenAI API?
1. Acesse platform.openai.com/signup e crie uma conta gratuita.
2. Vá em platform.openai.com/api-keys.
3. Clique em "Create new secret key".
4. Copie a chave (começa com sk-) e cole no arquivo .env ou no painel do bot.

Custo: ~R$ 0,10 por 100 questões respondidas. Muito barato para uso diário.
O bot abre uma janela do Chrome separada?
Depende da configuração HEADLESS no arquivo .env:
• HEADLESS=True (padrão): O Chromium roda em segundo plano, sem janela visível. Mais eficiente.
• HEADLESS=False: Você pode ver o navegador abrindo e navegando em tempo real. Útil para depuração.

Atenção: o Chromium instalado pelo Playwright é separado do seu Chrome pessoal.
O servidor parou de funcionar — como reiniciar?
Basta dar duplo clique em iniciar.bat novamente (ou usar o atalho na Área de Trabalho). O servidor inicia em segundos. Certifique-se de que a porta 5000 não está sendo usada por outro programa.
Qual a precisão real do bot nas questões?
Com GPT-4o e o contexto dos materiais do curso processados, a precisão fica entre 90% e 95% para questões de certificação bancária (Câmbio, CPA-10, CPA-20, Compliance, LGPD, Segurança da Informação, etc.). Para maior precisão, habilite a opção "Ler materiais PDF" antes de fazer provas.
🏠 Ir para o Painel 📦 Gerar ZIP ⬇ Downloads 📱 APK Android
🤖 UniBB Bot v2.0 — Automação inteligente para Universidade Corporativa BB  |  Playwright + GPT-4o  |  Painel Principal