Skip to content

devperez08/Numerin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 Numerin: La Máquina Matemática

Numerin es una aplicación educativa e interactiva diseñada para niños de 10 años en adelante. Utiliza una metáfora visual de "máquina procesadora" para enseñar conceptos fundamentales de suma y resta de manera intuitiva y divertida.

Streamlit Python HTML5

🌟 Características Principales

  • Interfaz Interactiva Drag & Drop: Desarrollada con HTML5 nativo para una experiencia fluida.
  • Selección Múltiple: Permite seleccionar varias cajas a la vez para procesarlas en grupo.
  • Valor de Máquina Configurable: Ajusta dinámicamente cuánto suma o resta la máquina.
  • Lógica Inversa: Al devolver cajas del resultado a la máquina, esta "absorbe" su valor, enseñando la relación entre suma y resta.
  • Validaciones Inteligentes: Límites de seguridad (0 a 10 cajas) con alertas visuales.

🚀 Instalación y Configuración

Prerrequisitos

  • Python 3.8 o superior.
  • Pip (gestor de paquetes de Python).

Pasos de Configuración

  1. Clonar el repositorio:

    git clone https://github.com/devperez08/Numerin.git
    cd Numerin
  2. Crear y activar un entorno virtual:

    python3 -m venv venv
    source venv/bin/activate  # En Linux/macOS
    # venv\Scripts\activate  # En Windows
  3. Instalar dependencias:

    pip install -r requirements.txt

🎮 Cómo Jugar

  1. Lanzar la App:
    streamlit run machine.py
  2. Sumar: Selecciona una o varias cajas de la zona "Disponibles" (izquierda) y arrástralas al centro de la máquina. Aparecerán en el "Resultado" con el valor adicional.
  3. Restar: Arrastra cajas desde el "Resultado" (derecha) hacia la máquina. La máquina restará su valor y devolverá el excedente a la zona de disponibles.
  4. Configurar: Usa el panel de control lateral para cambiar el valor de la máquina (+N) o la cantidad inicial de cajas.

🛠️ Tecnologías Utilizadas

  • Backend: Python 3.
  • Frontend: Streamlit para la estructura y componentes personalizados en HTML/CSS/JS para la interactividad de arrastrar y soltar.
  • Estilos: CSS3 con diseño amigable para niños (Comic Sans MS / Inter).

Desarrollado con ❤️ para fomentar el aprendizaje lógico-matemático.

About

Interfaz interactiva en Streamlit para que niños aprendan suma y resta arrastrando cajas a una "máquina" lógica. Transforma operaciones abstractas en una experiencia visual y táctil con selección múltiple y lógica inversa para la resta. Ideal para educación inicial, combinando Python con componentes avanzados en JavaScript.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages