Skip to content

esscova/movieRec

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MovieRec

Sistema de recomendação de filmes desenvolvido com foco em análise de dados + machine learning + engenharia de software, utilizando o dataset MovieLens.

O projeto combina múltiplas abordagens de recomendação e disponibiliza uma API com FastAPI, além de um frontend moderno em React.

image

Objetivo do Projeto

Este projeto foi desenvolvido com fins de portfólio, com os objetivos de:

  • Aplicar conceitos de Sistemas de Recomendação
  • Trabalhar com pipeline de dados
  • Implementar API REST com FastAPI
  • Criar um frontend moderno com React + TypeScript
  • Integrar dados externos (TMDB)
  • Demonstrar boas práticas de engenharia

Tecnologias Utilizadas

  • Python
  • FastAPI
  • Pandas
  • Scikit-learn
  • React
  • TypeScript
  • Vite
  • TailwindCSS
  • Axios

Dados

  • MovieLens Dataset - link
  • Integração com TMDb - link

Sistemas de Recomendação Implementados

1. Popularidade

Recomenda os filmes mais avaliados.

2. Melhor Avaliação

Filmes com maior média de avaliação (com mínimo de votos).

3. Por Gênero

Filmes filtrados por gênero, com exclusão de já assistidos.

4. Filtragem Colaborativa (KNN)

Baseado em similaridade entre usuários utilizando:

  • matriz usuário-item
  • similaridade por cosseno

5. Ensemble (Borda Count)

Combina todos os sistemas:

  • cada sistema gera um ranking
  • filmes recebem pontuação por posição
  • ranking final agregado

Endpoints da API

Endpoint Descrição
/recomendar/populares Top filmes mais avaliados
/recomendar/melhores Melhores avaliados
/recomendar/genero Por gênero
/recomendar/knn Filtragem colaborativa
/recomendar/ensemble Sistema híbrido

Frontend

Interface inspirada em plataformas como Netflix:

  • Hero Section (filme em destaque)
  • Cards com hover interativo
  • Busca dinâmica
  • Integração com API em tempo real
  • Cache de imagens (TMDB)

Variáveis de Ambiente

Frontend (.env)

VITE_TMDB_API_KEY=your_api_key_here

Autor

Desenvolvido por Wellington Moreira

About

Um projeto que consegue unir práticas de Engenharia de dados, Machine Learning, construção e consumo de APIs, desenvolvimento frontend e backend.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors