El proyecto openai-quickstart-python sirve como una aplicación de ejemplo para familiarizarse rápidamente con el desarrollo de funcionalidades basadas en la API de OpenAI. Este tutorial detalla la configuración de un entorno de desarrollo robusto mediante el uso de entornos virtuales y la gestión de dependencias, facilitando así el inicio en la creación de aplicaciones con OpenAI.

Importancia de los Entornos Virtuales

En el desarrollo con Python, es común que diferentes proyectos requieran versiones específicas de paquetes. Los entornos virtuales permiten aislar las dependecnias de cada proyecto, previniendo conflictos. Para openai-quickstart-python, esto asegura la compatibilidad de bibliotecas clave como Flask y openai, gaarntizando una ejecución fluida.

Requisito Previo: Instalación de Python

Asegúrate de tener Python instalado en tu sistema. Si no es así, descárgalo e instálalo desde el sitio web oficial de Python. Verifica la instalación abriendo tu terminal y ejecutando:

python --version

Obtención del Código Fuente

Clona el repositorio del proyecto usando el siguiente comando:

git clone https://gitcode.com/gh_mirrors/op/openai-quickstart-python

Una vez completada la clonación, navega al directorio del proyecto:

cd openai-quickstart-python

Creación del Entorno Virtual

Dentro del directorio del proyecto, crea un entorno virtual con el siguiente comando:

python -m venv entorno_openai

A continuación, activa el entorno virtual. En sistemas Windows, utiliza:

entorno_openai\Scripts\activate

En macOS o Linux, el comando es:

source entorno_openai/bin/activate

La activación exitosa se indicará con la aparición de (entorno_openai) al inicio del prompt de tu terminal.

Instalación de Dependencias

Las dependencias del proyecto están listadas en el archivo requirements.txt. Con el entorno virtual activado, ejecuta:

pip install -r requirements.txt

Este archivo incluye paquetes esenciales como Flask (framwork web), openai (cliente para la API de OpenAI) y python-dotenv (gestión de variables de entorno). La instalación se realizará dentro del entorno virtual, sin afectar la configuración global de Python.

Configuración de Variables de Entorno

La aplicación requiere tu clave API de OpenAI para operar. Comienza copiando el archivo de ejemplo de variables de entorno:

cp .env.example .env

Abre el archivo .env con un editor de texto y añade tu clave API de OpenAI:

OPENAI_API_KEY=tu_clave_api_aqui

Puedes obtener tu clave API desde la página de tu cuenta en OpenAI.

Ejecución de la Aplicación

Con toda la configuración completa, inicia la aplicación ejecutando:

flask run

Una vez que la aplicación se inicie correctamente, podrás acceder a ella en tu navegador visitando http://localhost:5000.

Desactivación del Entorno Virtual

Cuando hayas terminado de trabajar en el proyecto, puedes salir del entorno virtual usando:

deactivate