Skip to content

Latest commit

 

History

History
168 lines (99 loc) · 6.1 KB

setup-espanol.md

File metadata and controls

168 lines (99 loc) · 6.1 KB

Instrucciones de configuración

🛠️ Herramientas que utilizaremos

Trabajaremos con:

  1. git: A través de GitHub Desktop y la línea de comandos para asegurarnos de que podamos colaborar en el código.
  2. conda y poetry: Para gestionar nuestros entornos Python.
  3. Virtual Studio Code (VSCode): Para escribir nuestro código.
  4. Paquetes de código abierto: Ploomber, JupySQL, Jupyter notebooks, FastAPI, Haystack y Chainlit.
  5. Docker: Para contenerizar nuestras aplicaciones.

🚀 Software para instalar

Revisa las instrucciones de configuración del entorno para el entorno local que usarás en este curso.

Instalar GitHub Desktop Fuente: https://desktop.github.com/

Haz clic en el botón Descargar para {OS}.

Configuración de Github SSH (si estás usando Git desde la terminal en lugar de GitHub Desktop) El Protocolo de Shell Seguro (SSH) proporciona un canal de comunicación seguro en una red no segura. ¡Configurémoslo!

1. Genera un par de claves SSH privada/pública. 
ssh-keygen -o -t rsa -C "tu dirección de correo electrónico para github"

  1. Guarda el par de archivos. ¡La ubicación predeterminada ~/.ssh/id_rsa está bien!

  2. En el indicador, escribe una frase de contraseña segura.

  3. Copia el contenido de la clave pública que compartiremos con GitHub.

    • Mac: `pbcopy < ~/.ssh/id_rsa.pub``

    • Windows (WSL): clip.exe < ~/.ssh/id_rsa.pub

    • Linux: xclip -sel c < ~/.ssh/id_rsa.pub

  4. Ve a tu cuenta de GitHub y ve a Configuración.

  5. Bajo Acceso, haz clic en la pestaña SSH y claves GPG a la izquierda.

image

  1. Haz clic en el botón Nueva clave SSH.

image

  1. Nombra la clave y pega la clave pública que copiaste. Haz clic en el botón Agregar clave SSH.

image

Instalar miniconda Fuente: https://docs.conda.io/projects/miniconda/en/latest/#id2

Elige la distribución que tenga sentido para tu sistema operativo.

Instalar y configurar VSCode Fuente: https://code.visualstudio.com/docs/setup/setup-overview

Elige la distribución que tenga sentido para tu sistema operativo.

Instalar las extensiones de Python y Jupyter Notebook Haz clic en la pestaña Extensiones .

Escribe "Python" en la barra de búsqueda.

Haz clic en Instalar tanto en la Extensión de Python como en la Extensión de Cuaderno Jupyter de Microsoft.

Creando una copia local del repositorio

Cada equipo decidirá quién será el propietario del repositorio. El propietario creará una copia del repositorio y compartirá el acceso con los miembros del equipo.

  1. Haz clic en el botón Usar esta plantilla en la esquina superior derecha del repositorio.
  2. Selecciona "Crear un nuevo repositorio" y completa los campos.

  1. El propietario del repositorio compartirá el repositorio con los miembros del equipo recopilando sus ID de GitHub y agregándolos como colaboradores.

  1. Cada miembro del equipo clonará el repositorio en su máquina local. Puedes usar GitHub Desktop o la línea de comandos para clonar el repositorio. Para usar GitHub Desktop, haz clic en el botón Code y selecciona Abrir con GitHub Desktop.

Si prefieres usar la línea de comandos, copia el enlace SSH y ejecuta el siguiente comando en tu terminal.

Configurando un entorno virtual

Una vez que hayas instalado todo el software necesario y hayas clonado el repositorio, deberás configurar un entorno virtual. Un entorno virtual es una herramienta que ayuda a mantener separadas las dependencias requeridas por diferentes proyectos al crear entornos virtuales de Python aislados. Esta es una de las herramientas más importantes que la mayoría de los desarrolladores de Python utilizan.

Desde GitHub Desktop, haz clic derecho en el nombre del repositorio y luego haz clic en el botón Abrir en Visual Studio Code. Esto abrirá el repositorio en VSCode.

Una vez que VSCode esté abierto, abre una nueva terminal haciendo clic en el menú Terminal, luego selecciona Nueva Terminal.

Asegúrate de que tu terminal sea de tipo "bash" o "línea de comandos" para ejecutar comandos de conda.

Configurando un entorno virtual usando conda

  1. Crea un nuevo entorno conda utilizando el siguiente comando.
conda create -n hacktoberfest-env python=3.10
  1. Activa el entorno utilizando el siguiente comando.
conda activate hacktoberfest-env
  1. Instala poetry.
pip install poetry
  1. Instala los paquetes requeridos utilizando el siguiente comando.
poetry install

Nota Esto solo functionara si estas dentro del directorio del repositorio.

Conectemos VSCode al entorno virtual que acabamos de crear.

Esto asume que aún estás trabajando desde la carpeta correspondiente al repositorio que acabas de clonar.

  1. Abre la Paleta de Comandos (Mac: Shift⌘+P , Windows: Ctrl+Shift+P)

  2. Escribe "Intérprete de Python".

  3. Haz clic en Python: Seleccionar Intérprete

  4. Selecciona el entorno Conda que instalaste anteriormente (hacktoberfest-env)

¡Ahora estás listo para comenzar a programar!