david1r20/bella-tavola-model

Bella Tavola Model

Modelo de classificacao binaria usado no projeto Bella Tavola para estimar risco de fraude/comportamento suspeito em transacoes.

Objetivo

O modelo recebe caracteristicas sinteticas de uma transacao e retorna uma predicao binaria:

• 0: legitimo
• 1: fraude

Features de entrada

Feature	Tipo	Descricao
valor_transacao	float	Valor da transacao em reais
hora_transacao	int	Hora da transacao, de 0 a 23
distancia_ultima_compra	float	Distancia em relacao a ultima compra
tentativas_senha	int	Quantidade de tentativas de senha
pais_diferente	int	1 se o pais for diferente do cadastro, 0 caso contrario

Uso

from huggingface_hub import hf_hub_download
import joblib

model_path = hf_hub_download(
    repo_id="david1r20/bella-tavola-model",
    filename="model.pkl",
)
model = joblib.load(model_path)

features = [[120.0, 20, 2.5, 1, 0]]
prediction = model.predict(features)
probability = model.predict_proba(features)

Treinamento

O modelo foi treinado com dados sinteticos gerados no projeto Bella Tavola. As features foram criadas para simular padroes de risco, como transacoes de maior valor, horarios incomuns, distancia elevada da ultima compra, mais tentativas de senha e pais diferente.

Limitacoes

Este modelo foi treinado com dados sinteticos e tem finalidade academica. Ele nao deve ser usado em producao sem validacao com dados reais, analise de vies, monitoramento e retreinamento adequado.

Dependencias

As dependencias principais estao em requirements.txt neste repositorio.