PerplexiCart: compras inteligentes con Perplexity Sonar API

PerplexiCart ayuda a los usuarios a tomar decisiones de compra informadas y alineadas con sus valores. Impulsado por la Perplexity Sonar API, analiza productos en la web y devuelve información estructurada con recomendaciones priorizadas, pros/contras, análisis de compensaciones y sentimiento del usuario, adaptado a preferencias como Ecológico, Durabilidad, Ético y necesidades específicas de la región.

Características

• Recomendaciones de productos inteligentes más allá de la simple comparación de especificaciones
• Alineación de valores basada en prioridades (Mejor valor, Ecológico, Ético, Durabilidad, Hecho en India)
• Personalización contextual (tipo de piel, patrones de uso, región, etc.)
• Salida de investigación estructurada con:
  • Resumen de la investigación y principales recomendaciones
  • Alineación de valores con razonamiento
  • Pros/Contras y especificaciones clave
  • Sentimiento del usuario e información de la comunidad (Reddit, Quora)
  • Análisis de compensaciones y consejos de compra
• Fuentes transparentes con citas para verificación

Requisitos previos

• Node.js 18+ y npm/yarn
• Python 3.10+ y pip
• Clave de API de Perplexity

Instalación

# Clone the repository
git clone https://github.com/fizakhan90/perplexicart.git
cd perplexicart

# Backend (FastAPI) setup
cd backend
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

# Frontend (Next.js) setup
cd ../frontend
npm install

Configuración

Crea un archivo .env en el directorio backend:

PERPLEXITY_API_KEY=your_perplexity_api_key

(Opcional) Agrega cualquier configuración específica de la aplicación según sea necesario (caché, valores predeterminados de región, etc.).

Uso

1. Iniciar Backend (FastAPI):

   cd backend
   uvicorn main:app --reload  # adapt module:app if your entrypoint differs
   

2. Iniciar Frontend (Next.js):

   cd frontend
   npm run dev
   

3. Abrir la aplicación: Visita http://localhost:3000 y busca un producto. Selecciona tu prioridad (por ejemplo, Ecológico) y agrega contexto opcional (tipo de piel, región).

Explicación del código

• Backend (FastAPI): Orquesta las llamadas a Sonar con ingeniería de prompt dinámica basada en la consulta, la prioridad seleccionada y el contexto
• Salidas estructuradas: Aplica un esquema JSON estricto a través de response_format para garantizar una representación consistente de la interfaz de usuario
• Investigación web en vivo: Dirige a Sonar a buscar en plataformas de comercio electrónico, foros, blogs de reseñas e informes de sostenibilidad
• Análisis semántico: Extrae la alineación de valores, pros/contras, sentimiento y cita las fuentes para mayor transparencia
• Frontend (Next.js/React): Presenta una vista clara y fácil de usar de las recomendaciones, compensaciones y citas

Cómo se utiliza la API de Sonar

PerplexiCart aprovecha la Perplexity Sonar API como su núcleo de inteligencia, generando dinámicamente prompts personalizados basados en las entradas del usuario, como consultas de búsqueda, prioridades y contexto. La API realiza una investigación web exhaustiva en sitios de comercio electrónico, foros y plataformas de reseñas, con respuestas estructuradas en un formato JSON consistente. A través del análisis semántico, extrae información clave del producto, incluida la alineación con las prioridades del usuario, los pros/contras y el sentimiento, todo respaldado por fuentes citadas. El backend de FastAPI procesa estas respuestas estructuradas antes de servirlas al frontend de Next.js para una experiencia de usuario pulida.

Enlaces

• Demostración en vivo: https://perplexicart.vercel.app/
• Repositorio de GitHub: https://github.com/fizakhan90/perplexicart