GameForYouBrain

Plataforma modular de minijuegos cognitivos para poner a prueba la mente.

Objetivo

Crear una base abierta donde la comunidad pueda agregar minijuegos (plugins) con modos:

• voz
• texto
• imagen
• hibrido

El proyecto esta licenciado con GNU GPL v3 para mantener el codigo abierto.

Ruta principal actual

La ruta oficial del proyecto ahora es Python (software libre, sin necesidad de IDE de pago).

• Toolchain recomendado: Python 3.10+ y VS Code.
• El codigo C# existente se conserva como referencia de arquitectura, pero el avance principal es en Python.

Arquitectura

• python_src/gameforyoubrain/core: contratos de dominio (prompt, respuesta, resultado, errores).
• python_src/gameforyoubrain/speech: interfaces STT/TTS desacopladas.
• python_src/gameforyoubrain/devices: contratos de dispositivos por plataforma.
• python_src/gameforyoubrain/plugins: SDK y host para minijuegos comunitarios.
• python_src/gameforyoubrain/minigames: minijuegos (incluye demo de memoria).
• python_src/gameforyoubrain/app: punto de entrada ejecutable.

Requisitos

• Python 3.10 o superior.

No necesitas Visual Studio de pago para trabajar este stack.

Como ejecutar

1. Crea y activa un entorno virtual.
2. Desde la raiz del repo:

python -m venv .venv
.\.venv\Scripts\activate
pip install -e .
gfyb-demo

Para habilitar proveedores de voz (STT/TTS):

pip install -e .[voice]
gfyb-demo --mode voice

Modos disponibles:

• --mode text
• --mode voice
• --mode hybrid

Juegos disponibles:

• --game math (calculo mental rapido)
• --game memory (secuencia de memoria)

Ejemplo rapido para calarlo:

gfyb-demo --game math --mode text

En Linux/macOS usa:

python3 -m venv .venv
source .venv/bin/activate
pip install -e .
gfyb-demo

Comunidad y plugins

Las reglas para contribuciones y plugins estan en CONTRIBUTING.md.

Licencia

GNU GPL v3: revisa LICENSE.