Skip to content

Este proyecto, desarrollado durante el Bootcamp de Ciencia de Datos de SoyHenry, ofrece una API para entusiastas de los videojuegos. Proporciona recomendaciones de usuarios y juegos basadas en revisiones anteriores y preferencias de la plataforma Steam.

Notifications You must be signed in to change notification settings

FlorLascu/Steam_Games_API_Project

Repository files navigation

Steam_logo

Proyecto: Construcción de un Sistema de Recomendación de Juegos

Resumen:

El proyecto consistió en explorar tres conjuntos de datos completos de la plataforma de juegos Steam, para que luego de un exhaustivo proceso de ETL y EDA pudiera realizar un analisis de sentimiento sobre las recomendaciones de los usuarios. Luego,con las bases de datos ya procesadas, crear finalmente, un modelo de Recomendación y otras tantas funciones que luego se convertirían en endpoints de nuestra API deployada en Render

En esta presentación se encuentran los pasos, métodos, procesos y decisiones implicados en el desarrollo del proyecto.
En caso de querer profundizar sobre cualquiera de los puntos presentados, el archivo Resumen del Proyecto contiene de manera detallada y completa cada paso del mismo, explicado a detalle.
Así mismo, los notebooks a los que se hacen referencia en este Readme también tienen el desarollo del código.

Sin mas, paso a comentar los pasos realizados:

Pasos Realizados:

1. Exploración y Limpieza de Datos:

Mi viaje comenzó con un proceso ETL exhaustivo, donde realicé la limpieza de datos, validación y eliminación de duplicados.
Comprender la información en cada conjunto de datos fue crucial, sentando las bases para un análisis más profundo.
En esta etapa el primer desafío fue leer los archivos, cuestión que parecería trivial, pero que requirió de varias pruebas y error hasta lograrlo.
El adicional de dificultad se presentó nuevamente, cuando al abrir los datos nos encontramos con listas de diccionarios anidadas

Games:

La base de datos maestra de todos los juegos existentes en Steam presentó desafíos debido a su falta de información, muchas columnas incompletas. Esto me llevóa tener que decidir para cada dato su eliminación o imputación para no perder información.

Reviews:

El archivo reviews contiene todos los posteos de usuarios a los distintos juegos de la plataforma de Steam. Procesarla presentó sus desafíos debido a que los datos en la misma se encontraban, para cada usuario, en forma de una lista de diccionarios anidados

Items:

Extraer información relevante de las estructuras JSON anidadas dentro de los perfiles de usuario fue también desafiante pero gratificante. Esto implicó iterar a través de los datos y expandirlos en columnas para construir un conjunto de datos útil para un análisis exhaustivo.

Con el ETL finalizado continuamos con el proceso.
Se pueden ver en detalle los procesos recorridos con las dataset proporcionados en:

ETL_games
ETL_reviews
ETL_items

2. Análisis de Sentimientos en Reseñas:

Centrándome en el marco de datos de reseñas, que contenía más de 55,000 reseñas de usuarios, realicé un análisis de sentimientos.
Los métodos elegidos fueron: NLTK y Textblob.
Procedí primero experimentando con NLTK ya que no era un método que hubieramos visto en detalle en clase.
Pero al resultar muy costoso a nivel de recuros (tardaba 8 minutos en clasificar), decidí probar también con Textblob. Aunque Textblob es un enfoque mucho más simple y proporciona un resultado bastante bueno, el enfoque NLTK ofreció una clasificación mucho mejor de las reseñas positivas y neutrales y las reseñas negativas también fueron identificadas de manera mucho más precisa.
Además, el enfoque NLTK tiene una gama más amplia de características o variables para jugar y experimentar con el fin de mejorar el proceso de clasificación.
Se pueden seguir y visualizar todos los pasos del desarrollo de estos dos métodos en Feature Engineering en el primer detalle: 3.1
Luego decidí comparar su rendimiento, considerando factores como la precisión de la clasificación y la eficiencia computacional.

Puntuación del Análisis de Sentimientos:

Para evaluar los dos procesos de análisis de sentimientos que realicé decidí crear un sistema de puntuación. Esta puntuación se agregó al Dataframe reviews en una columna que nombré: 'rating'
La puntuación se definió con una fórmula que asignaba a la reseña una puntuación según:

  • La calificación que otros usuarios asignaron a la recomendación, si les resultó o no útil.
  • Si el usuario recomendó o no al juego a pesar de su reseña. (columna recommed)
  • Sentiment resultante del analisis de Sentimiento realizado, positivo = 2 y negativo = 0.

Este scoring fue luego el corazón de nuestro Sistema de Recomendación de Filtrado Colaborativo.
Para ver en detalle como fue creada la función para el 'Rating' ver Recommendation_Model

Conclusiones:

Tomando los resultados de nuestra comparativa entre métodos, NLTK logró una puntuación del 81%, superando el 71% de Textblob, aunque con un tiempo computacional más largo.

6. Análisis Exploratorio de Datos (EDA):

Durante el proceso de EDA pudimos ver para cada dataset, entre otros:

  • el rango de las variables
  • sus relaciones o independencia
  • su valor como información y potencial
  • un analisis de correlación para el precio y generos en games que resultó negativo. En fin, un trabajo muy valioso que se puede apreciar en detalle en:

EDA_games
EDA_reviews
EDA_items

El EDA proporcionó ideas sobre variables y sus relaciones, preparando el terreno para construir el núcleo del proyecto: un modelo de aprendizaje automático para recomendación de juegos.

7. Construcción del Sistema de Recomendación:

Para ambos modelos partimos de los datos de reviews de usuarios.
Desarrollé dos métodos para la recomendación:

  1. Filtrado Colaborativo En este método, se calcula la similitud entre los perfiles de los usuarios o entre los perfiles de los ítems utilizando la medida de similitud del coseno. Esta medida de similitud cuantifica la similitud entre las preferencias de los usuarios o las características de los ítems.
  2. Machine Learning similitud del coseno en combinación con KNN: En este método, se emplea el algoritmo KNN para identificar los vecinos más cercanos y la similitud del coseno para encontrar las similitudes (score) entre los usuarios o ítems
    Para ambas, creamos una función de busqueda por nombre de juego, ya que el input no es el id del juego sino su título.
    El scoring para la similitud entre items y usuarios tiene como base los:
  • user_id
  • item_id
  • rating (el desarrollado a partir de sentiment + recommender + helpful)

Para ambos modelos a su vez, se crean dos tipos de funciones:

  • item-item:

    def find_similar_games(game_name:str): cuando se ingresa el nombre del juego, tiene un motor de búsqueda que utiliza la similitud del coseno, el cual devuelve el juego con el nombre más similar al ingresado. Luego, de acuerdo con el Modelo de Filtrado Colaborativo, proporciona una lista de recomendaciones basadas en las puntuaciones y calificaciones de las reseñas de los usuarios, usuarios similares a aquellos que les gustó el juego ingresado.

  • usuario-item

    def find_user_recommendations(user_id:str): cuando se ingresa un ID de usuario, proporciona una lista de recomendaciones basadas en la matriz csr.item-usuario creada en el modelo de aprendizaje automático, utilizando KNN (K-Nearest Neighbors).

Los pasos detallados para la creación de cada modelo y sus funciones están documentados en Modelo de Recomendación.

8. Funciones Destacadas Desarrolladas:

En este apartado, desarrollé todas las funciones que luego se visualizarán en Render según lo solicitado en el scope del proyecto.
Y se puede ver el paso a paso en el apartado 3.2 Feature Engineering

  1. developer(developer:str): devuelve una estructura JSON que muestra para el desarrollador el porcentaje de juegos Free y su historial de desarrollo de items a lo largo de los años
  2. user_data(user_id:str): Muestra el gasto del usuario, el porcentaje de juegos recomendados y el recuento total de juegos.
  3. UserForGenre(genre: str): Proporciona el usuario con la mayor cantidad de horas jugadas para el género dado, categorizado por año.
  4. best_developer_year(year:int): Devuelve los 3 mejores desarrolladores recomendados por los usuarios para un año dado.
  5. developer_review_analysis(developer:str): Resume las reseñas positivas y negativas de un desarrollador en particular.
  6. find_similar_games(game_name:str): Encuentra juegos similares basados en similitud coseno y proporciona recomendaciones.
  7. find_user_recommendations(user_id:str): Ofrece recomendaciones personalizadas basadas en interacciones entre usuarios y elementos.

9. Implementación de FASTAPI y Render:

Comencé primero por aprender desde lo básico: que es una API?
Cuando finalmente pude entender que es una API y como se utilizan, seguí con estudiar y entender el lenguaje que se utiliza para crear los endpoints, de decoradores, de respuesta JSONResponse, Query y pydantics varios.

Con todo este aprendizaje a cuestas, cree las funciones y sus endopoints en FASTAPI y pude hacer que todo corriera sin dificultades y sin erores en local.
La alegría duró poco, en el primer intento de realizar el deploy en render comenzaron las fallas, la falta de espacio y tocó ir para atrás una y otra vez.
Pero finalmente, despúes de varias experimentaciones y revisión de las funciones para que leyeran df mas compactas y modificar los filtrados para que funcionaran de manera interactiva desde el inicio para asi no tener que cargar las datasets originales, evitar al máximo los merge o los datasets tan pesados, la API estuvo live:

Render_Home

Implementar la API en Render presentó desafíos significativos debido a la capacidad limitada de datos. Superar esto requirió solución de problemas creativos y extensos ensayos y errores. Sin embargo, la implementación exitosa sin errores o fallas fue inmensamente gratificante, culminando en un viaje de aprendizaje y crecimiento de una semana.

9.1 Correr la API Steam_games_API en local

La API tiene su repositorio propio, por el tema del volumen y la limitación de la capacidad de render a 512MB total.
Para hacer el deploy de la misma en local, basta seguir las siguientes instrucciones:

  1. Clonar el repositorio o bajarlo del GitHub a local. Desde acá lo pueden ver: Steam_games_API
  2. Activar el entorno virtual, abrir la carpeta del repositorio o la copia de la carpeta download con Visual.
  3. Abrir la terminal:

uvicorn main:app --reload

El comando "uvicorn main:app --reload" se utiliza para ejecutar la aplicación FastAPI llamada "app" ubicada en un archivo llamado main del repositorio, con la recarga automática habilitada. El archivo main es el desarrollo de la API, sus endpoints y sus dataset.
Esto significa que el servidor se reiniciará automáticamente cada vez que se detecten cambios en el código, lo que permite una experiencia de desarrollo más fluida.

  1. Una vez que en la terminal se lea: Application startup complete significa que podremos abrir el navegador y disponibilizar la API para explorarla: Application_Startup

  2. Ir a la ruta: 127.0.0.1:8000 Se abrirá un modesto Home page con el link a los docs de la API, donde podremos experimentar con los resultados de las funciones y el model de Recomendación creado.

FASTAPI_Landing

Como se puede ver, esto es en local. Veremos la diferencia cuando corramos render.

  1. Dar click en el boton de View Documentation, o bien navegar a 127.0.0.1:8000/docs
  2. Estando en Documentos podemos interactuar con cada una de las funciones, simplemete hay que seguir las instrucciones que estan cargadas en la descripción de cada función, darle click al boton the Try it out! y listo, podemos explorarlas sin dificultades.

FASTAPI_Instrucciones

  1. Aca se pueden visualizar un ejemplo, en este caso para el modelo de recomendación:

output_ejemplo

Una vez terminada la exploración se apaga desde la terminal, ya sea cerrando la terminal o con 'CRTL+C'

Stopping

9.2 Deploy de FASTAPI en Render

Para ello cree, como describí antes, un repositorio exclusivo para el Deploy: Steam_games_API

Este repo es el que utiliza render para correr el deploy. Los pasos, una vez familiarizada con el proceso, son relativamente fácil y muy intuitivos:

  1. Se crea la cuenta de FASTAPI y se la vincula a la cuenta de GitHub, y luego se le da click a New en el boton del Dashboard.
  2. Se selecciona Web Services (nuestra API es una REST API, web) y se selecciona el repo del deploy.
  3. Una vez seleccionado, Render hace tod el trabajo.
  4. Y como resultado nos disponibiliza un url donde esta nuestra API deployada:

Render_dashboard

  1. Como mi API ya esta deployada, voy a boton de Manually deploy y selecciono last committ:

API_render

Recursos

Estos son los tutoriales y páginas de consulta utilizados y consultados para el desarrollo del presente proyecto:

About

Este proyecto, desarrollado durante el Bootcamp de Ciencia de Datos de SoyHenry, ofrece una API para entusiastas de los videojuegos. Proporciona recomendaciones de usuarios y juegos basadas en revisiones anteriores y preferencias de la plataforma Steam.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages