En esta entrada os explico como instalar y usar un pequeño script de python que he escrito. dicho script se conecta al API de OpenAI para usar GPT-3.5_turbo para traducir archivos de un idioma a otro. Sin importar que sean archivos largos. Es necesario tener una clave API de OpenAi para usar el programa. Esta Api tiene un coste, pero es muy bajo, del orden de 1 céntimo de euro la traducción.

La mayor parte de esta entrada está escrita con ChatGTP y sirve como ejemplo de lo sencillo que es escribir documentación y apuntes con esta herramienta. En cualquier caso, yo soy el editor de la entrada, eligo jo que quiero que se explique y por tanto : yo soy el autor. Podemos debatir este tema, que no es trivial.

Instalar Github Desktop

¿Qué es Github?

Según ChatGPT

GitHub es como un Google Drive para programadores, pero con algunas características adicionales muy útiles. Imagina que estás trabajando en un proyecto y quieres guardar versiones diferentes del mismo, para poder volver a una versión anterior si algo sale mal. Eso es lo que GitHub hace. Además, si trabajas en equipo, cada miembro puede trabajar en partes diferentes del proyecto al mismo tiempo, y luego GitHub ayuda a unir todo el trabajo de forma ordenada. Por último, también es como una red social para programadores, porque puedes compartir tus proyectos con otros, e incluso colaborar en proyectos de otras personas.

Es una buena explicación.

Instalar Github Desktop

GitHub Desktop es una interfaz gráfica que permite interactuar con GitHub sin usar la línea de comandos. Es útil para gestionar repositorios, realizar commits, push y pull, resolver conflictos, entre otras cosas. Aquí te dejo unas instrucciones breves para instalarlo en Windows:

1. Ve a la página oficial de GitHub Desktop en https://desktop.github.com/

2. Haz clic en el botón “Download for Windows (64bit)” si tu sistema operativo es de 64 bits. Si no estás seguro, puedes comprobarlo yendo a Configuración de Windows -> Sistema -> Acerca de -> Tipo de sistema.

3. Una vez descargado el archivo .exe, haz doble clic en él para comenzar la instalación.

4. Sigue las instrucciones que aparecen en pantalla para completar la instalación.

5. Una vez que la instalación se haya completado, podrás abrir GitHub Desktop desde el menú Inicio de Windows.

6. La primera vez que abras la aplicación, te pedirá que inicies sesión con tu cuenta de GitHub. Si no tienes una, puedes crearla en https://github.com/

7. Una vez que hayas iniciado sesión, puedes comenzar a usar GitHub Desktop para gestionar tus repositorios de GitHub.

Instalar Python

ChatGPT dice que :

Python es un lenguaje de programación, lo que significa que es una forma de darle instrucciones a un ordenador. Es como una receta de cocina para la máquina: le dices exactamente qué hacer y cómo hacerlo. Lo que hace a Python especial es que está diseñado para ser fácil de leer y escribir. Es como un libro de recetas que se esfuerza por ser sencillo y claro, evitando las complicaciones innecesarias. Por eso, a menudo se utiliza para enseñar programación a los principiantes. Pero no te equivoques, Python es muy poderoso y se utiliza en muchos lugares, desde sitios web hasta investigación científica y desarrollo de juegos.

Además, debemos tener en cuenta que es un lenguaje interpretado :

Un lenguaje interpretado, como Python, es un tipo de lenguaje de programación que se ejecuta línea por línea, es decir, en tiempo real. Imagina que estás en una obra de teatro y el director te va diciendo qué hacer escena por escena, en vez de darte todo el guión de una vez. Así funciona Python, el ordenador va leyendo y realizando las instrucciones del código que escribiste una por una.

Esto tiene algunas ventajas, como que es más fácil de aprender y usar, además de que puedes probar partes de tu código a medida que avanzas. Sin embargo, puede ser un poco más lento que otros lenguajes que se compilan (es decir, se traducen completamente a lenguaje de máquina) antes de ejecutarse.

Para instalar Python 3.10 en Windows, puedes seguir estos pasos:

1. Ve al sitio web oficial de Python en https://www.python.org/

2. Haz clic en la pestaña “Downloads” en la parte superior de la página.

3. Verás un botón que dice “Download Python 3.10.x” (x será un número dependiendo de la última versión disponible). Haz clic en ese botón para descargar el instalador.

4. Una vez que el archivo .exe se haya descargado, haz clic en él para abrir el instalador.

5. En la ventana del instalador, asegúrate de marcar la casilla “Add Python 3.10 to PATH” en la parte inferior. Esto hará que puedas usar Python desde la línea de comandos de Windows.

6. Luego, haz clic en “Install Now”.

7. El instalador comenzará a copiar archivos y configurar Python en tu sistema. Este proceso puede tardar unos minutos.

8. Una vez que la instalación se haya completado, verás una pantalla que dice “Setup was successful”. ¡Ya tienes Python 3.10 instalado en tu sistema!

9. Para comprobar que la instalación fue exitosa, puedes abrir la línea de comandos (CMD o PowerShell) e ingresar el comando python --version. Esto debería mostrar la versión de Python que acabas de instalar.

Lo que no dice ChatGPT es que debes asegurarte de marcar “añadir python.exe” al PATH. …y eliminar la limitación de longitud del PATH (Disable path length limit).

Instalación de la API de OpenAI para Python

Para instalar la API de OpenAI para Python, necesitarás usar pip, que es una herramienta que viene con Python y sirve para instalar paquetes o bibliotecas adicionales.

Sigue estos pasos:

1. Abre la línea de comandos de tu computadora. En Windows, puedes buscar “CMD” o “Command Prompt” en el menú de inicio.

2. Una vez abierta la línea de comandos, escribe el siguiente comando y presiona Enter:

pip install openai

Quizas “pip” no funciona en tu sistema y debes usar “pip3”

3. Espera a que se complete la instalación. Verás varios mensajes en la línea de comandos mientras se descarga e instala el paquete.

Obtener una clave de acceso al API de openai

Para obtener una API Key de OpenAI, debes seguir estos pasos:

1. Ve a la página web de OpenAI en https://beta.openai.com/signup/ y crea una cuenta si aún no la tienes.

2. Una vez que hayas iniciado sesión, ve al Dashboard (Tablero de control).

3. En el Dashboard, busca la sección de “API Keys” (Claves API).

4. Haz clic en “Create new API Key” (Crear nueva clave API).

5. Te pedirá que escribas un nombre para la clave y que selecciones algunas opciones. Una vez que hayas hecho esto, haz clic en “Create”.

6. Te mostrará una nueva API Key. Asegúrate de copiarla y guardarla en un lugar seguro, ya que no podrás verla de nuevo.

7. Ahora puedes usar esta clave API en tu código para interactuar con la API de OpenAI.

Recuerda tratar tu API Key como si fuera una contraseña, ya que proporciona acceso a tu cuenta de OpenAI y a los servicios pagados. No la compartas con nadie y no la publiques en lugares públicos como repositorios de código en GitHub.

Es posible que debas dar de alta un mecanismo de pago en la plataforma ya que el acceso a las API es de pago. Para hacer pruebas con modelos como GPT-3.5_turbo el coste es muy bajo. Del orden de céntimos o milesimas de euro por llamada. Modelos como DALL-E o GPT-4 son más caros.

GDPR y API de OpenAI

OpenAI, con sede en los Estados Unidos, no debe recibir datos personales de usuarios europeos a través de su API sin garantías de cumplimiento de la GDPR. Esto significa que cuando utilices la API de OpenAI, debes asegurarte de no enviar datos que puedan identificar a una persona, como nombres, direcciones de correo electrónico, números de teléfono, y cualquier otro dato que se pueda usar para identificar a alguien.

Es importante entender que la responsabilidad de garantizar que los datos enviados a la API de OpenAI cumplan con la GDPR recae en el usuario que envía los datos. Por lo tanto, siempre debes tener cuidado al manejar y procesar datos personales y asegurarte de que estás cumpliendo con todas las leyes y regulaciones aplicables.

( Si quieres usar el API de OpenAI con datos sensibles en Europa debes usar la versión del API en el Cloud de Microsoft Azure https://azure.microsoft.com/en-us/products/cognitive-services/openai-service/ )

Mi programa de traducción

Mi programa de traduccion se encuentra en mi repositorio de github https://github.com/granludo/gpt-test , en la carpeta file-translator. Debes usar Github Desktop para clonar la carpeta en tu ordenador.

Estas son las instrucciones del Readme.md en castellano:

Por Marc Alier @granludo https://wasabi.essi.upc.edu/ludo

Licenciado bajo la Licencia Pública General de GNU v3.0

Programa simple en Python 3 que utiliza el modelo GPT-3.5-turbo de OpenAI para traducir archivos de un idioma a otro. Divide el archivo en fragmentos de 20 líneas.

requisitos

Necesitas tener una clave para usar la API de OpenAI, puedes obtener una aquí: https://beta.openai.com/docs/developer-quickstart/api-key este programa busca la clave en un archivo indicado en la variable “mykeypath” por defecto en la ruta ‘..//..//mykey.json’. (O sea dentro de la carpeta github)

Ejemplo del contenido de mykey.json:

{ “key”: “sk-7QzXHpaajenpuakn1tgHT3Bxxxxxxxxxxx” }

Necesitas instalar los paquetes json y openai

pip install openai

uso

python3 gpt-traductor.py archivo_origen idioma_origen idioma_destino archivo_destinoEjemplo

python3 gpt-translate.py sample.md catalan italian sample_translated.md

Espero que os sea de utilidad.