📦 UniBB Bot — Downloads & Instalação

📦

UniBB Bot — Pacote Completo para Windows

Contém: painel web (index.html), bot Python completo, script instalador automático (.bat), extensão Chrome e todos os arquivos necessários.

Windows 10/11 Python 3.10+ Playwright OpenAI GPT-4o Extensão Chrome Instalador .bat

Programa	Versão Mínima	Obrigatório?	Custo	Link Direto
🐍 Python	`3.10+`	Obrigatório	Gratuito	python.org/downloads
🎭 Playwright (via pip)	`1.40+`	Obrigatório	Gratuito	playwright.dev/python
🌐 Google Chrome	`87+`	Obrigatório	Gratuito	google.com/chrome
🤖 OpenAI API Key	GPT-4o	Obrigatório (IA)	~R$0,10/100 questões	platform.openai.com
📝 VS Code (editor)	qualquer	Opcional	Gratuito	code.visualstudio.com
📱 Android SDK (ADB)	latest	Opcional (mobile)	Gratuito	developer.android.com
🧩 Extensão Chrome UniBB Bot	Manifest v3	Recomendado	Incluída no ZIP

🔧

Programas Necessários

Clique em "Baixar" para ir direto ao site oficial

🐍

Python 3.12

v3.12.3 — Windows 64-bit

✦ Obrigatório

Linguagem necessária para rodar o bot. Instale com a opção "Add Python to PATH" marcada.

💾 ~28 MB

⬇️ Baixar Python 3.12 (64-bit)

⚠️ Marque "Add python.exe to PATH" durante a instalação!

🌐

Google Chrome

Versão mais recente — Windows

✦ Obrigatório

Navegador usado pela extensão e pelo Playwright para automação real da plataforma UniBB.

💾 ~80 MB

⬇️ Baixar Google Chrome

📝

Visual Studio Code

v1.88+ — Windows 64-bit

◈ Recomendado

Editor de código para visualizar e editar os arquivos Python do bot. Não é obrigatório mas facilita muito.

💾 ~90 MB

⬇️ Baixar VS Code

🌿

Git for Windows

v2.44+ — Windows 64-bit

◈ Opcional

Controle de versão — útil para atualizar o bot com novos recursos facilmente via linha de comando.

💾 ~50 MB

⬇️ Baixar Git

📱

Android Platform Tools (ADB)

SDK v35 — Windows

◈ Só para app mobile

Necessário apenas para automatizar o app UniBB Mobile no Android. Conecte o celular via USB.

💾 ~11 MB

⬇️ Baixar ADB (Windows)

🤖

OpenAI API Key

GPT-4o — Conta gratuita disponível

✦ Obrigatório (IA)

Chave de API para o GPT-4o responder as questões. Custo real: ~R$ 0,10 por 100 questões.

💳 Crédito inicial gratuito disponível

🔑 Gerar API Key (OpenAI)

🧩

Extensão Chrome — UniBB Bot Assistant

Integra diretamente no navegador — detecta e responde questões automaticamente enquanto você navega no UniBB

BB

UniBB Bot Assistant

v2.0 — Manifest v3

✅ Conectado — unibb.com.br

🤖 Auto-Responder

📊 Estatísticas

Questões respondidas hoje: 47
Precisão: 93.6%
Sessão ativa: 02:14:33

O que a extensão faz?

A extensão Chrome injeta o bot diretamente no portal UniBB. Quando você abre uma página com questões, ela detecta automaticamente e oferece responder com IA — sem precisar rodar o Python!

Detecta questões automaticamente na página

Responde múltipla escolha com GPT-4o

Exibe confiança da resposta (%)

Controla o bot Python via SocketIO

Funciona em unibb.com.br e devunibb.edtech.com.br

Popup com estatísticas em tempo real

📄manifest.json

🖼️popup.html + popup.js

⚙️content.js (injetado no UniBB)

🔄background.js (service worker)

🎨popup.css + ícones

ℹ️ A extensão é instalada manualmente no Chrome (modo desenvolvedor). Veja o passo 4 abaixo.

🚀

Guia de Instalação — Windows (Passo a Passo)

Do zero ao funcionando em ~10 minutos

1

Instalar o Python 3.12

Baixe e execute o instalador. IMPORTANTE: Marque a caixa ☑ Add python.exe to PATH antes de clicar em "Install Now".

⬇️ python-3.12.3-amd64.exe

✅ Verifique após instalar: abra o CMD e digite python --version

2

Baixar o Pacote UniBB Bot

Baixe o pacote ZIP completo abaixo e extraia em uma pasta (ex: C:\unibb-bot\).

3

Executar o Instalador Automático

Dentro da pasta extraída, dê duplo clique em instalar.bat. Ele fará tudo automaticamente:

O instalador vai executar automaticamente:

✓ Verificar Python instalado
✓ pip install -r requirements.txt
✓ playwright install chromium
✓ Criar arquivo .env de configuração
✓ Abrir o painel no navegador

⚠️ Se pedir permissão do Windows Defender, clique em "Executar assim mesmo".

4

Instalar a Extensão Chrome

Siga estes passos no Google Chrome:

Chrome — Instalar extensão manual

1. Abra o Chrome e acesse: chrome://extensions
2. Ative o "Modo do desenvolvedor" (canto superior direito)
3. Clique em "Carregar sem compactação"
4. Selecione a pasta: C:\unibb-bot\chrome-extension\
5. A extensão aparecerá na barra do Chrome ✅

✅ Após instalar, clique no ícone BB na barra do Chrome para abrir o painel da extensão.

5

Configurar suas Credenciais

Edite o arquivo C:\unibb-bot\python\.env com seus dados:

.env — Configuração

UNIBB_CHAVE=F1234567
UNIBB_SENHA=sua_senha_portais_externos
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
PORTAL_URL=https://www.unibb.com.br
HEADLESS=True

6