Skip to content

Home

Jump to bottom
Alberto Ivo Vieira edited this page Jan 13, 2026 · 1 revision

Welcome to the PyExplorer wiki!

🚀 PyExplorer: Aventura Python para Crianças

Bem-vindo à Wiki oficial do PyExplorer! 🌟

O PyExplorer é um jogo educativo 100% web desenvolvido em React, projetado para ensinar conceitos de programação em Python para crianças de 8 a 15 anos. Nossa missão é transformar o aprendizado de código em uma jornada divertida, visual e interativa.

📖 Sobre o Projeto

O PyExplorer remove a barreira das IDEs complexas e telas pretas assustadoras. Aqui, as crianças aprendem resolvendo desafios em um ambiente gamificado, recebendo feedback imediato e visual.

A grande mágica técnica? Todo o código Python roda no navegador do usuário! Não dependemos de servidores backend para executar os scripts, garantindo velocidade, privacidade e segurança.

🎯 Público-Alvo

  • Crianças e Adolescentes (8 a 15 anos).
  • Iniciantes absolutos em programação.
  • Educadores e pais que buscam ferramentas lúdicas de ensino.

✨ Funcionalidades Principais

1. Execução de Código no Navegador (Serverless Python)

Utilizamos Pyodide (WebAssembly) para rodar um interpretador Python completo direto no browser. Isso permite que a criança veja o resultado do seu código instantaneamente.

2. Gamificação Envolvente

  • Mundos Temáticos: O aprendizado é dividido em "mundos" (ex: Ilha das Variáveis, Montanha dos Loops).
  • Progresso e Recompensas: Ganhe estrelas ⭐, suba de nível e desbloqueie conquistas.
  • Feedback Amigável: Erros de sintaxe traduzidos para uma linguagem que a criança entende.

3. Diversidade de Desafios

O jogo não é monótono! Suportamos diversos tipos de interação:

  • ✅ Múltipla Escolha & V/F: Para fixar conceitos rápidos.
  • 🧩 Complete o Código: Preencher lacunas (fill-in-the-blanks).
  • ⌨️ Escreva a Função: Desafios onde a criança implementa a lógica completa para resolver um problema.

🛠️ Stack Tecnológico

O projeto é uma Single Page Application (SPA) moderna, construída sobre pilares robustos:

Tecnologia Uso no Projeto
⚛️ React + Vite Frontend rápido, modular e reativo.
🔥 Firebase Autenticação (Auth), Banco de Dados (Firestore) e Hospedagem.
Assembly 🐍 Pyodide Runtime Python rodando via WebAssembly.
💅 Tailwind / CSS Interface visual rica e responsiva ("Kid-friendly UI").

🗺️ Estrutura dos Mundos

O conteúdo pedagógico é organizado progressivamente:

  1. Fundamentos: print, variáveis, tipos de dados (strings, números).
  2. Lógica Booleana: True, False, comparações e if/else.
  3. Repetição: Laços for e while aplicados a cenários visuais.
  4. Estruturas de Dados: Listas, métodos de string e manipulação.
  5. Modularização: Criando e reutilizando suas próprias Funções.

🚀 Como Contribuir / Rodar Localmente

Desenvolvedores são bem-vindos! Para rodar o PyExplorer na sua máquina:

  1. Clone o repositório:

    git clone https://github.com/albertoivo/PyExplorer.git
cd PyExplorer

  2. Instale as dependências:

    npm install

  3. Configuração de Ambiente:

    • Crie um projeto no Console do Firebase.
    • Copie .env.example para .env.local e preencha suas chaves de API.

  4. Inicie o servidor:

    npm run dev

"A melhor maneira de prever o futuro é programá-lo." 🚀

Clone this wiki locally