Inicio rápido — Python

Integra Rayuela en tu aplicación Python y obtén tu primera recomendación en menos de 5 minutos.

Requisitos previos

Python 3.7 o superior
pip (gestor de paquetes de Python)
Una cuenta en Rayuela (regístrate en rayuela.ai)
Tu API Key (disponible en el dashboard después del registro)

Paso 1: Instalación

Instala las dependencias necesarias para interactuar con la API de Rayuela.

pip install rayuela

O si usas poetry:

poetry add rayuela

Paso 2: Configuración inicial

Crea un cliente Python para interactuar con la API de Rayuela.

from rayuela import RayuelaClient, RayuelaConfig

# Configuración
client = RayuelaClient(RayuelaConfig(
    api_key="sk_prod_tu_api_key_aqui"
))

# Verificar conexión
try:
    metrics = client.get_metrics()
    print("OK: conexión exitosa")
except Exception as e:
    print(f"Error: verifica tu API Key. ({e})")

Paso 3: Obtener recomendaciones

Solicita recomendaciones personalizadas para un usuario.

from rayuela import RayuelaClient, RayuelaConfig, RecommendationOptions

client = RayuelaClient(RayuelaConfig(
    api_key="sk_prod_tu_api_key_aqui"
))

# Obtener recomendaciones para un usuario
recs = client.recommend("user_123", RecommendationOptions(
    limit=5,
    strategy="hybrid",
    recommendation_goal="user_engagement",
    explain=False,
    context={"device": "mobile"},
    filters={
        "logic": "and",
        "filters": [
            {"field": "category", "op": "eq", "value": "electronics"},
            {"field": "price", "op": "lt", "value": 1000}
        ]
    }
))

print("Recomendaciones:")
for item in recs.items:
    print(f"- {item.name} (Score: {item.score:.2f})")

Listo — siguientes pasos

Ya tienes configurado el cliente Python básico. Ahora puedes: