Installation

Instalación y Configuración

Esta guía te mostrará cómo instalar y configurar Prompt Engineering Frameworks en tu entorno local.

Requisitos Previos

Antes de comenzar, asegúrate de tener instalados los siguientes componentes:

• Python 3.9 o superior
• pip (gestor de paquetes de Python)
• Git
• Cuenta de OpenAI con API key
• Opcionalmente, cuenta en Resend para el sistema de contacto

Instalación Paso a Paso

1. Clonar el Repositorio

git clone https://github.com/686f6c61/prompt-engineering-frameworks.git
cd prompt-engineering-frameworks

2. Crear y Activar Entorno Virtual

Linux/macOS:

python3 -m venv venv
source venv/bin/activate

Windows:

python -m venv venv
venv\Scripts\activate

3. Instalar Dependencias

pip install -r requirements.txt

4. Configurar Variables de Entorno

1. Copia el archivo de ejemplo a un nuevo archivo .env:

   cp .env.example .env

2. Edita el archivo .env con tu editor preferido:

   nano .env  # o cualquier otro editor

3. Completa las siguientes variables:

   # API Key para OpenAI
   OPENAI_API_KEY=tu_api_key_aquí
   
   # Clave secreta para Flask
   FLASK_SECRET_KEY=una_clave_segura_aleatoria
   
   # API Key para Resend (envío de correos)
   RESEND_API_KEY=tu_api_key_de_resend
   
   # Configuración de correos electrónicos
   EMAIL_FROM=Tu Nombre <tu@dominio.com>
   EMAIL_TO=destinatario@ejemplo.com
   
   # Configuración de entorno
   FLASK_ENV=development  # Cambia a production en entorno de producción
   FLASK_PORT=3000
   

Ejecución de la Aplicación

Entorno de Desarrollo

Para ejecutar la aplicación en modo desarrollo:

python main.py

La aplicación estará disponible en http://localhost:3000 (o el puerto que hayas configurado).

Entorno de Producción

Para entornos de producción, se recomienda utilizar Gunicorn:

gunicorn -c gunicorn.conf.py main:app

Alternativamente, puedes usar el script proporcionado:

./run.sh

Configuración para Despliegue

Render

El repositorio incluye archivos de configuración para desplegar en Render:

• render.yaml: Configuración del servicio
• render.sh: Script para el despliegue

Para desplegar en Render, simplemente conecta tu repositorio desde el panel de control de Render y configura las variables de entorno necesarias.

Variables de Entorno en Producción

En un entorno de producción, asegúrate de configurar las siguientes variables:

• OPENAI_API_KEY: Tu clave API de OpenAI
• FLASK_SECRET_KEY: Una clave secreta robusta
• RESEND_API_KEY: Tu clave API de Resend para envío de correos
• EMAIL_FROM: Dirección de correo electrónico remitente
• EMAIL_TO: Dirección de correo electrónico destinatario
• FLASK_ENV: Debe ser "production"
• FLASK_PORT: Puerto para el servidor (generalmente proporcionado por el proveedor)

Personalización de la Configuración

Cambiar el Puerto

Modifica la variable FLASK_PORT en el archivo .env:

FLASK_PORT=8000

Configuración del seguimiento analítico

La aplicación incluye por defecto el código de Google Analytics. Para usar tu propio código:

1. Localiza en el archivo templates/base.html el siguiente bloque:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-BYM5KDT6C6"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'G-BYM5KDT6C6');
</script>

2. Sustituye el ID G-BYM5KDT6C6 por tu propio ID de Google Analytics

Solución de Problemas

Error: "Unable to open database file"

Asegúrate de que el directorio de la aplicación tiene permisos de escritura.

Error: "Port already in use"

Si el puerto ya está en uso, puedes:

1. Cambiar el puerto en el archivo .env
2. Terminar el proceso que está usando ese puerto:

   lsof -i:3000  # Encuentra el PID del proceso
   kill -9 [PID]  # Termina el proceso

Error con la API de OpenAI

Verifica que tu API key sea válida y tenga saldo disponible.