VM.es.md

Instrucciones de configuración

A continuación encontrarás las instrucciones para configurar tu ordenador para el bootcamp de Data Science & AI de Le Wagon.

Por favor, léelas detenidamente y ejecuta todos los comandos en el siguiente orden.

Esta configuración no es un ejercicio; su único propósito es preparar tu ordenador de forma estandarizada. No experimentes ni pidas ayuda a un LLM. Si te atascas, simplemente pide ayuda a un profesor 🙋

Empecemos 🚀

Cuenta GitHub

¿Ya tienes una cuenta GitHub? Si no es el caso, ábrela ya.

👉 Sube una foto y escribe tu nombre correctamente en tu cuenta GitHub. Esto es importante porque nosotros usaremos un tablero de comando interno con tu avatar. Por favor hazlo ahora antes de dar un paso más en esta guía.

👉 Habilita la Autenticación de Dos Factores (2FA). GitHub te enviará mensajes de texto con un código cuando intentes iniciar sesión. Esto es importante para la seguridad y también pronto será necesario para contribuir código en GitHub.

Configuración de Google Cloud Platform

GCP es una solución en la nube que usarás para colocar tus productos basados en Machine Learning en producción.

🚨 Si estás en el grupo de estudiantes del Bootcamp de Medio Tiempo, ¡IGNORA ESTA SECCIÓN POR AHORA! GCP ofrece $300 en créditos durante 3 meses, así que no es buena idea activar tu cuenta GCP demasiado pronto 🙅‍♂️

Preparación del Proyecto

• Ve a Google Cloud y crea una cuenta si aún no tienes una
• En la consola de Cloud, en la lista de proyectos, selecciona o crea un proyecto Cloud

• Asígnale un nombre como Wagon Bootcamp por ejemplo
• Verás que se creará un ID automáticamente para el proyecto e. g. wagon-bootcamp-123456

Idioma de la cuenta

Abre las preferencias en tu cuenta GCP para facilitar el seguimiento de las instrucciones durante el bootcamp:

https://myaccount.google.com/language

Si el idioma de preferencia no es:

• English
• United States

Cámbialo a inglés:

• Haz clic en el logo edición (es una lapicera)
• Selecciona English
• Selecciona United States
• Haz clic en Select

Cuenta de facturación

Ahora conecta tu cuenta con tu tarjeta de crédito. Este paso es obligatorio para poder usar los servicios que suministra GCP. No te preocupes, podrás utilizar la mayoría de los servicios de GCP por medio de créditos gratuitos durante el bootcamp.

• Haz clic en Billing
• Haz clic en MANAGE BILLING ACCOUNTS
• Haz clic en ADD BILLING ACCOUNT
• Asígnale un nombre a tu cuenta de facturación, e. g. My Billing Account
• Haz clic en "I have read..." y acepta los términos de uso
• Haz clic en CONTINUE
• Selecciona tu tipo de cuenta: Individual
• Agrega tu nombre y dirección

Verás que tienes créditos gratuitos con un valor de "$300 a utilizar en los próximos 90 días".

• Haz clic en los detalles de la tarjeta
• Agrega la información de tu tarjeta de crédito
• Haz clic en START MY FREE TRIAL. Esto significa comenzar mi período de prueba.

Cuando termines, verifica que la cuenta de facturación esté conectada con tu proyecto GCP.

• Selecciona tu proyecto
• Ve a Billing
• Selecciona LINK A BILLING ACCOUNT
• Selecciona My Billing Account
• Haz clic en SET ACCOUNT

Ahora deberías ver lo siguiente:

Free trial status: $300 credit and 91 days remaining - with a full account, you'll get unlimited access to all of Google Cloud Platform.

Esto significa Estado de período de prueba: crédito de $300 y 91 días para usarlo - con la full account, tendrás acceso ilimitado a todo lo que ofrece Google Cloud Platform.

👉 Si no tienes una tarjeta de crédito 👈

Si no tienes una tarjeta de crédito, puedes abrir una cuenta en Revolut. Revolut es una aplicación que funciona como un banco y que te permitirá crear una tarjeta de crédito virtual conectada a la dirección de facturación de tu smartphone.

Ignora este paso si ya tienes una tarjeta de crédito. Simplemente úsala para hacer la configuración.

Descarga la app Revolut o ve a revolut y sigue los pasos para descargar la app (introduce tu número de teléfono móvil y haz clic en Get Started).

• Abre la app Revolut
• Agrega tu número de teléfono móvil
• Agrega el código de verificación que recibiste por SMS
• La app te preguntará por tu país, dirección, primer y segundo nombre, fecha de nacimiento y el email
• La app también te pedirá tu profesión y una selfie
• La app te pedirá una foto de tu documento nacional de identidad o pasaporte

Cuando termines, selecciona el plan estándar (gratuito). No tienes que agregar la tarjeta a Apple pay, pedir que te envíen una tarjeta a tu domicilio ni tampoco agregar dinero a la cuenta.

Ahora tienes una tarjeta virtual que podrás usar para hacer la configuración de GCP.

En la vista principal de la app Revolut

• Haz clic en Ready to use
• Haz clic en the card
• Haz clic en Show card details
• Toma nota de la información de la tarjeta de crédito virtual y úsala para completar la configuración de GCP

👉 Si recibes un email de Google diciendo "Urgent: your billing account XXXXXX-XXXXXX-XXXXXX has been suspended" 👈

Esto puede pasar justo después de haber creado la cuenta en Revolut.

• Haz clic en PROCEED TO VERIFICATION
• Te pedirán que envíes una foto de tu tarjeta de crédito (solo los últimos 4 dígitos, nada más)
• Si ya has usado Revolut, puedes enviar una captura de pantalla de tu tarjeta de crédito virtual (no olvides quitar la fecha de vencimiento de la captura)
• Explica que estás haciendo el bootcamp de Le Wagon, que no tienes una tarjeta de crédito y que acabas de crear una cuenta en Revolut para poder configurar GCP para el bootcamp con una tarjeta de crédito virtual

Es posible que te validen la cuenta pero también es posible que te pidan más información en los próximos 30 minutos.

Cuando la cuenta sea validada recibirás un email diciendo lo siguiente: "Your Google Cloud Platform billing account XXXXXX-XXXXXX-XXXXXX has been fully reinstated and is ready to use.". Esto significa que tu cuenta Google Cloud Platform ha sido restablecida

Habilitación de servicios de GCP

• Asegúrate de que la facturación está habilitada para tu proyecto Google Cloud

ℹ️ Tienes un crédito de $300 para usar con recursos de Google Cloud. Esto será más que suficiente para el bootcamp.

• Habilita las APIs AI Platform Training & Prediction y Compute Engine APIs (Esto puede tomar varios minutos)

Configuración de Cloud sdk

• Autentica el CLI de gcloud con la cuenta que usaste para GCP

gcloud auth login

• Inicia sesión en tu cuenta Google en la nueva pestaña que se abrió en tu navegador
• Lista la cuenta que tienes activa y verifica que el email que usaste para GCP está ahí

gcloud auth list

• Define tu proyecto actual (reemplaza PROJECT_ID con el ID de tu proyecto e.g. wagon-bootcamp-123456)

gcloud config set project PROJECT_ID

• Lista la cuenta que tienes activa y tu proyecto actual y verifica que tu proyecto está ahí

gcloud config list

Crea una llave 🔑 de cuenta de servicio

Como ya creaste una cuenta GCP account y un project (identificado por su PROJECT_ID), vamos a configurar las acciones (llamadas API calls) que quieres que tu código ejecute.

🤔 ¿Por qué necesitamos una clave de cuenta de servicio?

Creaste una cuenta GCP conectada a una tarjeta de crédito. Te facturarán de acuerdo al uso que les des a los recursos de Google Cloud Platform. El cargo se hará si utilizas algo después de que el período de prueba gratuito se haya terminado o si te excedes del límite de consumo que te permite dicho período.

En tu cuenta GCP has creado un solo proyecto GCP identificado por su PROJECT_ID. Los proyectos GCP te permiten organizar y monitorear la manera en que consumes los recursos GCP de forma más precisa. En este bootcamp solo crearemos un solo proyecto.

Ahora necesitamos una manera de saber qué recursos nuestro código podrá consumir dentro de un GCP project. Nuestro código consume recursos GCP por medio de llamadas API.

Ya que las llamadas API no son gratuitas, es importante definir cuidadosamente cómo nuestro código las utilizará. Sin embargo, durante el bootcamp no habrá restricciones. Le permitiremos a nuestro código que utilice todas las API GCP sin restricciones.

Así como pueden haber varios proyectos asociados a una cuenta GCP, un proyecto puede estar compuesto de muchos servicios (cualquier paquete de código, sin importar su formato, que necesite utilizar llamadas a la API de GCP para cumplir con su propósito).

GCP exige que los servicios de los proyectos que usen llamadas API se registren en la plataforma y que se configuren sus credenciales por medio del acceso concedido a una service account.

Por ahora solo tendremos que usar un solo servicio y crearemos la service account correspondiente.

Ya que la service account es lo que identifica tu aplicación (y por ende tu cuenta de facturación GCP y, en última instancia, tu tarjeta de crédito), lo mejor es ser cuidadoso en los próximos pasos.

⚠️ No compartas la 🔑 del archivo json de tu cuenta de servicio ⚠️ No la guardes en tu escritorio ni en tu código base de git (incluso si tu repositorio git es privado). Que no se te olvide en un lugar como la máquina de café y, por supuesto, no la envíes en un tweet.

• Ve a la página de las cuentas de servicio
• Selecciona tu proyecto en la lista de proyectos recientes si te piden que
• Crees una cuenta de servicio:
  • Haz clic en CREATE SERVICE ACCOUNT que significa crear une cuenta de servicio:
  • Define un Service account name para esa cuenta. Esto significa Nombre de cuenta de servicio
  • Haz clic en CREATE AND CONTINUE que significa crear y continuar
  • Haz clic en Select a role que significa selecciona un rol. Escoge Quick access/Basic luego Owner. Esto otorga acceso total a todos los recursos
  • Haz clic en CONTINUE
  • Haz clic en DONE
• Descarga la 🔑 del archivo json de la cuenta de servicio:
  • Haz clic en la cuenta de servicio recién creada
  • Haz clic en KEYS
  • Haz clic en ADD KEY y luego en Create new key
  • Selecciona JSON y haz clic en CREATE

El navegador acaba de guardar la 🔑 del archivo json de la cuenta de servicio en tu carpeta de descargas (el nombre se le asigna según el nombre de la cuenta de servicio. Es algo como le-wagon-data-123456789abc.json)

Extensiones de VS Code

Instalación

Instala algunas extensiones útiles para VS Code.

code --install-extension ms-vscode.sublime-keybindings
code --install-extension emmanuelbeziat.vscode-great-icons
code --install-extension MS-vsliveshare.vsliveshare
code --install-extension ms-python.python
code --install-extension KevinRose.vsc-python-indent
code --install-extension ms-python.vscode-pylance
code --install-extension ms-toolsai.jupyter
code --install-extension alexcvzz.vscode-sqlite

Aquí está la lista de las extensiones que estás instalando:

• Sublime Text Keymap and Settings Importer
• VSCode Great Icons
• Live Share
• Python
• Python Indent
• Pylance
• Jupyter
• SQLite

Funciones de IA en VS Code

VS Code incluye muchas y potentes funciones de IA, que son una gran herramienta una vez que ya sabes programar.

Dicho esto, depender de la IA demasiado pronto puede ocultar conceptos importantes y dificultar la comprensión de la depuración. Una vez que estés cómodo con los fundamentos, sabrás cuándo y cómo usar la IA de forma eficaz —sin dejar que haga el trabajo por ti.

Para el inicio del bootcamp, desactivaremos estas funciones. Llegado el momento apropiado en el curso, las volveremos a habilitar para que puedas utilizarlas bien.

En VS Code:

1. Abramos la "Paleta de comandos" de VS Code: escribe Ctrl-Shift-P.
2. Se abrirá la Paleta de comandos: una pequeña caja de texto en la parte superior de la pantalla. Empieza a escribir aifeatures hasta que veas "Chat: Learn How to Hide AI features". Haz clic en ella.
3. Esto abrirá la configuración y te mostrará la opción "Disable and hide built-in AI features ...". Marca la casilla delante de esa opción.

Más adelante, si quieres volver a habilitar las funciones de IA, puedes seguir las mismas instrucciones para desmarcar la casilla.

Herramientas de línea de comando

Comprueba la configuración regional (locale)

La "locale" es un mecanismo que permite adaptar los programas a su idioma y país.

Comprobemos que la configuración regional por defecto es el inglés:

locale

Si la salida no contiene LANG=en_US.UTF-8, ejecute el siguiente comando en un Ubuntu terminal para instalar la locale inglesa:

sudo locale-gen en_US.UTF-8

Si después, recibes una advertencia (bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)) en tu terminal, por favor haz lo siguiente:

Generar la configuración regional<>/summary>

Por favor, ejecuta estas líneas en tu terminal.

sudo update-locale LANG=en_US.UTF8
sudo apt-get update
sudo apt-get install language-pack-en language-pack-en-base manpages

Zsh & Git

En lugar de usar el bash shell predeterminado, usaremos zsh.

También utilizaremos git, un programa de línea de comando para control de versiones.

Vamos a instalarlos, junto con otros programas útiles:

• Abre una terminal de Ubuntu
• Copia y pega los siguientes comandos:

sudo apt update

sudo apt install -y curl git imagemagick jq unzip vim zsh tree direnv

Estos comandos te pedirán tu contraseña: escríbela.

⚠️ Cuando escribas tu contraseña no verás nada en la pantalla. Esto es normal. Es una herramienta de seguridad para ocultar tanto el contenido de tu contraseña como su longitud. Simplemente escribe tu contraseña y presiona Enter al terminar.

Instalación de la CLI de GitHub

Instalemos la CLI oficial de GitHub (Interfaz de Línea de Comando). Es un programa que se usa para interactuar con tu cuenta GitHub por medio de la línea de comando.

En tu terminal, copia y pega los siguientes comandos y escribe tu contraseña si te la piden:

sudo apt remove -y gitsome # gh command can conflict with gitsome if already installed
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install -y gh

Ejecuta el comando que te mostramos a continuación para verificar que gh se haya instalado correctamente en tu máquina:

gh --version

✔️ Si ves esta versión gh version X.Y.Z (YYYY-MM-DD), puedes continuar trabajando 👍

❌ Si no es el caso, por favor contacta a un profesor

Oh-my-zsh

Instalemos el plugin zsh Oh My Zsh.

Ejecuta este comando en la terminal:

sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Si te preguntan "Do you want to change your default shell to zsh?", presiona Y

Cuando termines, tu terminal debería lucir así:

✔️ Si es el caso, puedes continuar 👍

❌ Si no, por favor pídele ayuda a un profesor.

GitHub CLI

CLI es una abreviación de Command-line Interface que significa interfaz de línea de comando.

En esta sección usaremos GitHub CLI para interactuar directamente con GitHub desde la terminal.

Usaremos la GitHub CLI (gh) para conectarnos a GitHub utilizando SSH, un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña.

Ya debería haberse instalado en tu computadora con los comandos que ejecutaste anteriormente.

Lo primero que hay que hacer para iniciar sesión es copiar y pegar el comando siguiente en tu terminal:

⚠️ NO edites el email — Aunque user:email parezca un marcador de posición para tu dirección de correo real, no lo es — no lo reemplaces.

gh auth login -s 'user:email' -w --git-protocol ssh

gh le hará algunas preguntas:

• Generate a new SSH key to add to your GitHub account? Presiona Enter para pedirle a gh que genere las claves SSH por ti.

  Si ya tienes claves SSH, verás en su lugar Upload your SSH public key to your GitHub account?Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa Intro.

• Enter a passphrase for your new SSH key (Optional):

  • PARA LA MAYORÍA DE LOS ESTUDIANTES: Simplemente presiona Enter para omitir. No necesitas una contraseña para el bootcamp y te la pediría cada vez que uses la clave. Sin embargo, hay un riesgo de que si alguien roba tu computadora, pueda subir código a GitHub.
  • SI LA SEGURIDAD ES MUY IMPORTANTE PARA TI: Escribe una contraseña de tu elección y presiona Enter. Es muy importante que si introduces una contraseña, la anotes en algún lugar inmediatamente y no la pierdas ni la olvides. Tendrás que introducirla con frecuencia.

• Title for your SSH key. Puede dejarlo en la propuesta "GitHub CLI", presiona Enter.

Obtendrás el siguiente resultado:

! First copy your one-time code: 0EF9-D015
- Press Enter to open github.com in your browser...

Selecciona y copia el código (0EF9-D015 en el ejemplo) y luego presiona Enter.

Tu navegador se abrirá y te pedirá que autorices GitHub CLI para usar tu cuenta GitHub. Acepta y espera un poco.

Regresa a la terminal, presiona Enter nuevamente y listo. Eso es todo.

Para verificar que están conectado correctamente, escribe lo siguiente:

gh auth status

✔️ Si obtienes este mensaje: Logged in to github.com as <YOUR USERNAME> , significa que todo está bien 👍

❌ De lo contrario, contacta a un profesor.

CLI de Google Cloud

Instala la CLI de gcloud para comunicar con Google Cloud Platform a través de la terminal:

sudo apt-get update && sudo apt-get install ca-certificates gnupg curl
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
sudo apt-get update && sudo apt-get install google-cloud-cli

👉 Documentación para la instalación

• Guarda el archivo json de la cuenta de servicio en un lugar que recuerdes. Por ejemplo:

/home/LINUX_USERNAME/code/GITHUB_NICKNAME/gcp/SERVICE_ACCOUNT_JSON_FILE_CONTAINING_YOUR_SECRET_KEY.json

• Guarda la ruta absoluta al archivo JSON como una variable de entorno:

echo 'export GOOGLE_APPLICATION_CREDENTIALS=/path/to/the/SERVICE_ACCOUNT_JSON_FILE_CONTAINING_YOUR_SECRET_KEY.json' >> ~/.aliases

Dotfiles

Mejoremos la experiencia de tu máquina instalando los dotfiles 🔗 preconfigurados de Le Wagon. Son archivos de configuración para tu terminal, zsh, git y VS Code.

Obtener tu nombre de usuario de GitHub

Ejecuta el siguiente comando:

export GITHUB_USERNAME=`gh api user | jq -r '.login'`
echo $GITHUB_USERNAME

✔️ Deberías ver tu nombre de usuario de GitHub en la pantalla.

❌ Si no es así, detente aquí y pide ayuda. Puede haber un problema con el paso anterior (gh auth).

Crear un fork de los dotfiles

Para personalizar esta configuración, tendrás que crear un fork del repositorio en tu propia cuenta de GitHub.

Crear un fork genera una copia del repositorio en tu cuenta (your_github_username/dotfiles), que luego podrás modificar con tus datos personales, como tu nombre.

❗ Si ya hiciste otro bootcamp de Le Wagon (Desarrollo web, Desarrollo de software con IA, Análisis de datos, Ciencia de datos e IA), abre un ticket con un TA y abre esta sección para ver las instrucciones ❗

Es posible que tengas una versión antigua de los dotfiles de Le Wagon. Podrían ser incompatibles con la configuración actual.

Junto con un TA, haz una de las siguientes acciones:

Estoy usando la misma máquina (o una máquina nueva que ya tiene los dotfiles).

1. Ve a tu carpeta actual de dotfiles:

   cd ~/code/$GITHUB_USERNAME/dotfiles

2. Comprueba las diferencias con la versión actual de los dotfiles de Le Wagon:

   git diff upstream/master

Si no hay diferencias importantes aparte de tu nombre y correo electrónico, continúa con la configuración.

Estoy usando una máquina nueva sin los dotfiles.

1. Ve a GitHub y encuentra tu repositorio de dotfiles.

2. Comprueba cuántos commits por detrás y por delante está de lewagon/dotfiles:master. Puedes verlo justo encima de la lista de archivos.

3. Haz clic en los enlaces de commits por detrás y por delante, y desplázate hacia abajo para ver las diferencias.

Si no hay diferencias importantes aparte de tu nombre y correo electrónico, continúa con la configuración.

El paso anterior mostró diferencias importantes.

Si estás de acuerdo con perder tus dotfiles actuales (recomendado):

Ten en cuenta que esto eliminará cualquier cambio personal que hayas hecho en la configuración de tu shell, como cargar utilidades adicionales o cambiar su apariencia. Si no recuerdas haber hecho cambios, no debería haber ningún problema.

1. Elimina tu repositorio actual de dotfiles en GitHub.
2. Elimina el repositorio local:

   cd ~/code && rm -rf ~/code/$GITHUB_USERNAME/dotfiles

3. Continúa con la configuración.

Si no quieres perder tus dotfiles actuales, te recomendamos trabajar con ramas. Haz clic para abrir.

En tu portátil, o donde tengas una copia local de tu versión actual de los dotfiles.

1. Haz commit de tu versión actual de los dotfiles:

   git add .
   git status # Comprueba qué se incluirá en el commit
   git commit -m "Version prior to new setup"

2. Crea una rama de tu configuración actual de dotfiles y súbela a GitHub:

   git checkout -b old-setup
   git push origin old-setup

3. Vuelve a master: git checkout master.

4. En tu master local, ejecuta git pull upstream master.

5. Comprueba que no estés en estado MERGING. Si lo estás, resuelve los conflictos.

   Es importante que aceptes los cambios entrantes en los archivos .zshrc, .zprofile y settings.json, especialmente todo lo relacionado con pyenv y los entornos de Python.

   Si hay demasiados conflictos, usa tu editor de código para reemplazar el contenido de los archivos en conflicto por el de los dotfiles de Le Wagon.

   Haz commit de la resolución de conflictos: git commit --no-edit

6. Sube tus cambios a GitHub: git push origin master.

7. Continúa con la configuración.

Es hora de crear un fork del repositorio y clonarlo en tu ordenador:

mkdir -p ~/code/$GITHUB_USERNAME && cd $_
gh repo fork lewagon/dotfiles --clone

Si aparece la pregunta "Are you sure you want to continue connecting (yes/no/[fingerprint])?", escribe yes y pulsa Enter.

Instalar los dotfiles

Ejecuta el instalador de dotfiles con:

cd ~/code/$GITHUB_USERNAME/dotfiles && zsh install.sh

Comprueba los correos electrónicos registrados en tu cuenta de GitHub. Tendrás que elegir uno en el siguiente paso:

gh api user/emails | jq -r '.[].email'

Ejecuta el instalador de git:

cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh

☝️ Se te pedirá tu nombre (FirstName LastName) y tu correo electrónico.

⚠️ Debes introducir uno de los correos que aparecen arriba, obtenidos con el comando gh api .... Si no lo haces, Kitt no podrá realizar un seguimiento de tu progreso.

💡 Selecciona la dirección ...@users.noreply.github.com si no quieres que tu correo aparezca en repositorios públicos a los que contribuyas.

Desahilitación de la solicitud de SSH passphrase

No vas a querer que te pidan tu passphrase cada vez que te comuniques con un repositorio remoto. Por eso debes agregarle plugin ssh-agent a oh my zsh:

Primero abre el archivo .zshrc:

code ~/.zshrc

Luego:

• Identifica la línea que comienza por plugins=
• Agrega ssh-agent al final de la lista de plugins

La lista debería verse de la siguiente manera:

plugins=(gitfast last-working-dir common-aliases zsh-syntax-highlighting history-substring-search pyenv ssh-agent)

✔️ Guarda el archivo .zshrc con Ctrl + S y cierra tu editor de texto.

Instala pyenv

Ubuntu viene con una versión vieja de Python que no queremos usar. Tal vez ya hayas instalado Anaconda u otro programa para utilizar Python y paquetes de Ciencia de Datos. Si es así, no pasa nada ya que haremos una configuración profesional de Python que te permitirá cambiar de versión cuando quieras al escribir python en la terminal.

Primero instala pyenv con el siguiente comando en la Terminal:

git clone https://github.com/pyenv/pyenv.git ~/.pyenv
exec zsh

Instala algunas dependencias necesarias para crear Python desde pyenv:

sudo apt-get update; sudo apt-get install make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev sqlite3 libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev \
python3-dev

Instala Python

Instala la última versión estable de Python que sea aceptada en el currículum de Le Wagon:

pyenv install 3.12.9

Este comando puede tomar un tiempo en ejecutarse. Esto es completamente normal. ¡No dudes en ayudar a los estudiantes que estén sentados cerca de ti!

OK. Cuando este comando termine de ejecutarse, le diremos al sistema que use esta versión de Python por defecto. Esto se hace con:

pyenv global 3.12.9
exec zsh

Para verificar que esto haya funcionado, ejecuta python --version. Si ves 3.12.9, ¡todo está bien! Si no, pídele ayuda a un TA para resolver el problema por medio de versiones de pyenv y type -a python (python debería estar usando la versión .pyenv/shims de primero).

Entorno Virtual de Python

Antes de instalar paquetes de Python, aislaremos la configuración del Bootcamp en un entorno virtual dedicado. Usaremos un plugin pyenv llamado pyenv-virtualenv.

Instala un virtualenv

Primero instala este plugin:

git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
exec zsh

Crea el entorno virtual que usaremos durante todo el bootcamp:

pyenv virtualenv 3.12.9 lewagon

Define el entorno virtual con lo siguiente:

pyenv global lewagon

¡Genial! Ahora cada vez que queramos instalar un paquete Python, lo haremos en ese entorno.

Paquetes de Python

Ahora que tenemos el ambiente virtual de lewagon adecuado, es hora de instalarle algunos paquetes.

Primero, actualiza pip, la herramienta para instalar Paquetes Python desde pypi.org. Ejecuta lo siguiente en la última terminal donde esté activado el virtualenv de lewagon:

pip install --upgrade pip

Ahora instala algunos paquetes para las primeras semanas del programa:

pip install -r https://raw.githubusercontent.com/lewagon/data-setup/master/specs/releases/linux.txt

Configuración de Jupyter Notebook

Dependiendo de tu sistema, necesitamos hacer algunos cambios pequeños en tu configuración de Jupyter.

Ejecuta esto:

bash -c "$(curl -s https://raw.githubusercontent.com/lewagon/data-setup/refs/heads/master/checks/setup_jupyter.sh)"

Si tienes curiosidad sobre lo que sucede aquí, haz clic aquí.

Este script añade una configuración para mejorar la visualización de los elementos details en tus notebooks.

Si estás usando Windows WSL, también soluciona otros problemas.

Chequeo de la configuración de Python

Chequeo de Python y packages

Reinicia tu terminal:

cd ~/code && exec zsh

Verifica tu versión de Python con los siguientes comandos:

zsh -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/python_checker.sh)" 3.12.9

Ahora verifica que puedas iniciar un servidor de notebook en tu máquina:

jupyter notebook

Tu navegador web debería abrir en una ventana jupyter:

Haz clic en New y, en el menú desplegable, selecciona Python 3 (ipykernel):

Debería abrirse una pestaña en un nuevo notebook:

Asegúrate de que estés usando la versión correcta de python en el notebook. Abre una celda y ejecuta lo siguiente:

import sys; sys.version

Debería mostrar 3.12.9 seguido de algunos detalles adicionales. Si no es así, consulta con un TA.

En otra celda, ejecuta:

import pandas as pd
pd.__version___

Esto podría tomar algunos minutos en ejecutarse. Debería mostrar un número de versión, 2.2.3. Si no es así, consulta con un TA.

Puedes cerrar tu navegador web y luego cerrar el servidor jupyter con CTRL + C.

¡Listo! Ya tienes un virtual env de python completo con todos los paquetes tercerizados que necesitarás en el bootcamp.

Docker 🐋

Docker es una plataforma abierta para desarrollo, entrega y operación de aplicaciones.

Si ya tienes Docker instalado en tu máquina, por favor actualízalo con la versión más reciente

Instalación de Docker

Ve a la documentación de instalación de Docker.

Luego sigue las instrucciones del tutorial para instalar Docker usando el repositorio. Hay 2 pasos:

1. Set up Docker's apt repository. > Esto significa configurar el repositorio
2. Install the Docker packages. > Esto significa instalar el motor de Docker

Ahora, asegurémonos de que podemos ejecutar docker sin sudo.

Ejecute los siguientes comandos uno por uno:

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker
sudo rm -rf ~/.docker/

Cuando termines, podrás ejecutar lo siguiente:

docker run hello-world

Debería aparecer el siguiente mensaje:

Kitt

Deberías haber recibido un correo electrónico de Le Wagon invitándote a registrarte en Kitt (nuestra plataforma de aprendizaje).

Entonces deberías recibir una invitación adicional de Slack, invitándote a la comunidad de los alumni de Le Wagon en slack (donde podrás chatear con tus compañeros y todos los demás alumni). Haz clic en Join y completa la información que te piden.

Si no lo has recibido, por favor contacta a tu equipo de enseñanza.

Slack

Slack es una plataforma de comunicación popular en la industria tech.

Instalación

Descarga la aplicación Slack e instálala.

⚠️ Si ya estás usando Slack en tu navegador, por favor descarga e instala la aplicación de escritorio la cual tiene todas las funciones.

Parámetros

Abre la aplicación e inicia sesión en lewagon-alumni.

Asegúrate de subir una foto para tu perfil 👇

La idea es tener Slack abierto todo el día para compartir enlaces útiles / pedir ayuda / decidir dónde almorzar / etc.

Para asegurarte de que todo lo relacionado a videollamadas funcione bien, prueba tu cámara y tu micrófono:

• Abre la aplicación Slack
• Haz clic en tu foto de perfil en la esquina superior derecha
• Selecciona "Preferencias" en el menú.
• Haz clic en "Audio y vídeo" en la columna de la izquierda.
• Debajo de "Solución de problemas", haz clic en "Ejecutar una prueba de audio, vídeo y pantalla compartida". La prueba se abrirá en una nueva ventana.
• Comprueba que tus dispositivos preferidos de altavoz, micrófono y cámara aparecen en los menús desplegables y haz clic en "Iniciar prueba"
• Haz clic en el botón verde "Start test"

✔️ Cuando termine el test deberías ver mensajes de "Succeed" en verde por lo menos para tu micrófono y tu cámara. 👍

❌ Si no es el caso, contacta a un profesor.

¡También puedes instalar la aplicación Slack en tu smartphone e iniciar sesión en lewagon-alumni!

Kata (Extra)

Si has terminado la configuración, te pedimos que preguntes si alguien necesita ayuda con la suya (macOS, Linux o Windows). Las primeras clases son a las 2pm. Hablaremos de la configuración que acabas de hacer y de Kitt.

Si no tienes mucha experiencia con git y GitHub, por favor ve nuevamente el video de este workshop (puedes verlo a 1.25 de velocidad).

Si aún te queda tiempo, puedes esperar trabajar en este Kata de Tic-Tac-Toe mientras esperas la primera clase.