diff --git a/README.md b/README.md index 3f36862..56dcd75 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,85 @@ -# Plataformas +# **Plataformas** +![ringa-tech](https://i.ytimg.com/vi/_BjL6W71mWY/hqdefault.jpg?sqp=-oaymwEjCPYBEIoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLC_f9QnPnhjeRFvzGYkR2cuDj7c5w) -## Información general +## **Información general** Este repositorio contiene el código para el juego de Plataformas controlado por la boca cara usando Facemesh, como fue creado en mi canal de Youtube: -https://youtu.be/_BjL6W71mWY +[Ringa-Tech](https://youtu.be/_BjL6W71mWY) -## Importante + +--- +## **Importante** El juego puede controlarse con la barra espaciadora, o abriendo/cerrando la boca. El tema de abrir y cerrar la boca no es perfecto, depende del angulo en el que tienes la cara vs la camara, entre otras cosas. Abre y cierra bien la boca para que lo detecte, y si batallas, puedes ayudarme a mejorarlo! -## Configuración inicial -El proyecto lo hice con Python 3.7.9 +--- + +## **Información Adicional:** + +Este juego no puede ser ejecutado en terminales de subsistemas Linux. Cómo WSL, WSL2, Termux, entre otros. Debido a que hay problemas con los triggers. +Se puede ejecutar pero es una tarea demasiado complicada. Te comparto está información de [Stackoverflow](https://stackoverflow.com/questions/65939167/problem-using-opencv-in-wsl-when-opening-windows) en caso de que lo quieras intentar. + +--- +## **Configuración inicial** +El proyecto lo hice con Python 3.7.9. +Pero mediaPipe acepta versiones desde 3.6, hasta 3.10. + +
Instalar en WINDOWS: + +### ***Sigue los siguentes pasos:*** + +Revisar versión de Python: +``` +python --version +``` +Crear un ambiente virtual: +``` +python3 -m virtualenv venv +``` +Activar ambiente virtual: +``` +.\venv\Scripts\activate +``` +Actualizar pip: +``` +python.exe -m pip --upgrade pip +``` +Para instalar las dependencias es necesario ejecutar +``` +pip install -r requirements.txt +``` +
+ +--- +
Instalar en LINUX: + +### ***Sigue los siguentes pasos:*** + +Revisar versión de Python: +``` +python --version +``` +Crear un ambiente virtual: +``` +python3 -m venv venv +``` +Activar ambiente virtual: +``` +source venv/bin/activate +``` +Actualizar pip: +``` +python -m pip --upgrade pip +``` Para instalar las dependencias es necesario ejecutar ``` pip install -r requirements.txt ``` -## Descarga de imágenes +
+ + +--- +## **Descarga de imágenes** Por motivos de Copyright, no puedo incluir las imágenes que usé en el juego aquí. Pero puedes descargarlas de manera gratuita! Tal cual como se muestra en el video. @@ -40,18 +104,26 @@ Te dejo aquí las instrucciones: - City Enemies - 5 -## Ejecutar el juego +## **Ejecutar el juego** -Para ejecutar el juego, ejecutar +El siguiente comando para ejecutar el juego: +**WINDOWS** ``` python .\app.py ``` +**LINUX** +``` +python ./app.py +``` + Si no te funciona, prueba usando "python3" o "py" en lugar de "python" en el comando anterior. -## ¿Problemas? -Solo he probado el juego en mi equipo así que seguramente puedes encontrar problemas. +--- +## **¿Problemas?** + +En ese caso por favor levanta un [**issue** aquí en Github](https://github.com/ringa-tech/juego-python-ia-plataforma/issues), con el mayor detalle que puedas (versión de python, de paquetes, mensaje completo de error, etc). -En ese caso por favor levanta un issue aquí en Github, con el mayor detalle que puedas (versión de python, de paquetes, mensaje completo de error, etc). +Si eres ninja y lo solucionas, ¡levanta un [Pull Request!](https://github.com/ringa-tech/juego-python-ia-plataforma/pulls) -Si eres ninja y lo solucionas, ¡levanta un Pull Request! +![logo-Ringa-tech](https://www.ringa-tech.com/LogotipoV2-Simple.png)