Aplicación interactiva de información sobre enfermedades

Una aplicación interactiva basada en navegador que proporciona información estructurada sobre enfermedades utilizando la API Sonar de Perplexity. Esta aplicación genera una interfaz HTML independiente que permite a los usuarios hacer preguntas sobre diversas enfermedades y recibir respuestas organizadas con citas.

🌟 Características

• Interfaz fácil de usar: Diseño limpio y responsivo que funciona en todos los dispositivos.
• Respuestas impulsadas por IA: Aprovecha la API Sonar de Perplexity para obtener información médica precisa.
• Tarjetas de conocimiento estructuradas: Organiza la información en Resumen, Causas y Tratamientos.
• Seguimiento de citas: Enumera las fuentes de información con enlaces en los que se puede hacer clic.
• Almacenamiento en caché del lado del cliente: Evita llamadas duplicadas a la API para preguntas hechas anteriormente.
• Implementación independiente: Genera un único archivo HTML que se puede usar sin un servidor.
• Manejo integral de errores: Mensajes de error fáciles de usar y gestión robusta de errores.

📋 Requisitos

• Python 3.6+
• Jupyter Notebook o JupyterLab (para desarrollo/generación)
• Paquetes requeridos:
  • requests
  • pandas
  • python-dotenv
  • IPython

🚀 Configuración e instalación

1. Clona este repositorio o descarga el notebook.
2. Instala los paquetes requeridos:

# Install from requirements file (recommended)
pip install -r requirements.txt

# Or install manually
pip install requests pandas python-dotenv ipython

3. Configura tu clave de API de Perplexity:
   • Crea un archivo .env en el mismo directorio que el notebook.
   • Agrega tu clave de API: PERPLEXITY_API_KEY=your_api_key_here

🔧 Uso

Ejecutando el Notebook

1. Abre el notebook en Jupyter:

jupyter notebook Disease_Information_App.ipynb

2. Ejecuta todas las celdas para generar e iniciar la aplicación basada en navegador.
3. La aplicación se abrirá automáticamente en tu navegador web predeterminado.

Usando el HTML generado

También puedes usar directamente el archivo disease_qa.html generado:

1. Ábrelo en cualquier navegador web moderno.
2. Ingresa una pregunta sobre una enfermedad (por ejemplo, "¿Qué es la diabetes?", "Háblame sobre la enfermedad de Alzheimer").
3. Haz clic en "Ask" para obtener información estructurada sobre la enfermedad.

Implementando la aplicación

Para uso personal o educativo, simplemente comparte el archivo HTML generado.

Para uso en producción, considera:

1. Configurar un backend adecuado para proteger tu clave de API.
2. Alojar el archivo en un servidor web.
3. Agregar análisis y gestión de usuarios según sea necesario.

🔍 Cómo funciona

Esta aplicación:

1. Utiliza un prompt cuidadosamente elaborado para instruir a la IA a generar JSON estructurado.
2. Procesa este JSON para extraer Resumen, Causas, Tratamientos y Citas.
3. Presenta la información en un formato de tarjeta de conocimiento limpio.
4. Implementa llamadas a la API del lado del cliente con un manejo de errores adecuado.
5. Proporciona un diseño responsivo adecuado tanto para escritorio como para dispositivos móviles.

⚙️ Detalles técnicos

Estructura de la API

La aplicación espera que la IA devuelva un objeto JSON con esta estructura:

{
  "overview": "A brief description of the disease.",
  "causes": "The causes of the disease.",
  "treatments": "Possible treatments for the disease.",
  "citations": ["https://example.com/citation1", "https://example.com/citation2"]
}

Archivos generados

• disease_qa.html - La aplicación independiente.
• disease_app.log - Registros detallados de la aplicación (al ejecutar el notebook).

Opciones de personalización

Puedes modificar:

• El estilo HTML/CSS en la función create_html_ui.
• El modelo de IA utilizado (el predeterminado es "sonar-pro").
• La estructura del prompt para diferentes campos de información.
• La ubicación y el nombre del archivo de salida.

🛠️ Extendiendo la aplicación

Posibles extensiones:

• Agregar un backend Flask/Django para proteger la clave de API.
• Implementar cuentas de usuario y preguntas guardadas.
• Agregar visualización de estadísticas de enfermedades.
• Crear una vista de comparación para múltiples enfermedades.
• Agregar reformateo de preguntas en lenguaje natural.
• Implementar mecanismos de retroalimentación para la calidad de las respuestas.

⚠️ Notas importantes

• Seguridad de la clave de API: La implementación actual incrusta tu clave de API en el archivo HTML. Esto es adecuado para uso personal, pero no para implementación pública.
• No es consejo médico: Esta aplicación proporciona información general y no debe usarse para decisiones médicas. Consulta siempre a profesionales de la salud para obtener asesoramiento médico.
• Uso de la API: Ten en cuenta los límites de tasa y los precios de la API de Perplexity para tu cuenta.

📜 Licencia

Licencia MIT

🙏 Agradecimientos

• Este proyecto utiliza la API Sonar de Perplexity AI.
• Inspirado en bases de conocimiento interactivas y plataformas de información médica.