--- title: Instalar Jupyter Notebook y JupyterLab por consola desde cero y aprender a usarlos url: https://jarroba.com/instalar-jupyter-notebook-y-jupyterlab-por-consola-desde-cero-y-aprender-a-usarlos/ author: Ramón Invarato date: 2021-04-19 modified: 2026-10-21 language: es license: CC BY-NC-SA 3.0 (https://creativecommons.org/licenses/by-nc-sa/3.0/) — attribution: "Instalar Jupyter Notebook y JupyterLab por consola desde cero y aprender a usarlos", Ramón Invarato, jarroba.com categories: Lenguajes de Programación tags: Jupyter, JupyterLab, linux, Notebook, python, WSL --- # Instalar Jupyter Notebook y JupyterLab por consola desde cero y aprender a usarlos > Instalar Jupyter Notebook y JupyterLab fácilmente en cualquier sistema operativo y aprender a trabajar en entorno interactivo multilenguaje. Jupyter Notebook y JupyterLab son herramientas de desarrollo de código abierto muy poderosas para trabajar interactivamente con múltiples lenguajes de programación y serán muy útiles para el análisis de datos, el análisis exploratorio, la visualización de datos, etc.; sobre todo para trabajar con “Big Data” (por ejemplo, [mediante Apache Spark; si estás interesado, después de leer este artículo recomiendo echar un vistazo al artículo completo que hemos preparado de Spark](https://jarroba.com/instalar-apache-spark-en-cualquier-sistema-operativo-y-aprender-a-programarlo-con-python-scala-o-java/)). **Jupyter Notebook y JupyterLab se pueden instalar en cualquier sistema operativo** (Windows, Linux, Mac), aunque para hacerlo de una manera más homogénea (y por ser más “estándar”) vamos a centrarnos en la instalación en Linux **mediante la consola** (que es muy parecido para Mac) y para Windows es igual, pero utilizaremos WSL2 (por lo que utilizaremos Linux); es más, para este artículo se ha probado con WSL2 con Ubuntu sobre Windows **Nota sobre instalar WSL2 en Windows**: es muy rápido de instalar, tan solo es activar una característica de Windows “Subsistema de Windows para Linux” e instalar del Market un sistema operativo como Ubuntu; tienes los pasos en [Instalación de WSL (Microsoft Learn)](https://docs.microsoft.com/es-es/windows/wsl/install-win10) . En este artículo voy a explicar **paso a paso y desde cero**. La instalación realmente no requiere más de unos pocos minutos y el resto es utilizar Jupyter para lo que necesitemos. **Nota si buscas instalar Jupyter mediante Anaconda**: el artículo presente no requiere Anaconda (pues al instalar Anaconda ya instala Jupyter Notebook y JupyterLab) y esta instalación es independiente (a la gestionada completamente con Anaconda), pues se realizará sobre el Python base; aún así, [si quieres instalar Anaconda y tener Jupyter podrás ver todos los pasos explicados en este artículo con vídeos](https://jarroba.com/entornos-de-python-anaconda-y-comun/) (Aviso para prevenir confusiones: Anaconda gestiona su propio Python y Jupyter, que es diferente al que se describe en este artículo, en el cual aprenderemos a gestionar Jupyter manualmente sobre un Python base). ## ¿Qué es Jupyter Notebook y JupyterLab? Una vez que iniciemos **Jupyter Notebook** podremos acceder a este mediante **una página web y tendremos un entorno interactivo para trabajar con documentos Notebooks** con soporte para múltiples lenguajes. Por otro lado, tenemos **JupyterLab que es una mejora respecto a Jupyter Notebook** (uno se sustenta en el otro) tanto visualmente como para trabajar mucho más cómodamente con ficheros Notebook, con nuevas funcionalidades y otros añadidos que no tiene Jupyter Notebook (y te aseguro que se echan muy en falta, como “un explorador de ficheros lateral” o un “potente sistema de pestañas”). **JupyterLab ofrece la experiencia como otros IDEs** de escritorio, pero en web. **Ambos, se instalan como paquetes Python** mediante “PIP”, por lo que voy a explicar paso a paso como prepararlo todo: tanto la instalación de Python como de Jupyter Notebook y JupyterLab. ## Instalar Python Tanto si quieres **programar con Python**, como si quieres **programar sobre** **los Notebooks bien de Jupyter como de JupyterLab** necesitamos instalar Python. Cuidado #### **Actualizar APT** Si APT no tiene los enlaces a los repositorios actualizados, podremos no encontrar todo lo que se necesitará a continuación (dando error con la descarga). Para **actualizar APT** los listados bastará con ejecutar (esto no actualiza el Software instalados): ```bash sudo apt update ``` Para instalar Python es sencillo, solo tenemos que **instalar una versión de Python estable** que queramos **con APT** (por ejemplo, yo he escogido “python3.9”): ```bash sudo apt install python3.9 ``` Consejo #### ****Consultar las versiones de Python disponibles**** Podemos consultar las versiones de Python actuales en la página de la documentación oficial [Python 3.15 documentation (Python docs)](https://docs.python.org) y en el recuadro de la izquierda podemos ver las versiones actuales. Recomiendo las versiones estables (las que tienen la palabra “stable” al lado). [![Captura de la documentación oficial de Python con el recuadro «Docs by version» que lista las versiones disponibles](https://jarroba.com/wp-content/uploads/2021/04/Versiones-de-Python-en-la-documentacion-oficial-www.Jarroba.com_.png)](https://jarroba.com/wp-content/uploads/2021/04/Versiones-de-Python-en-la-documentacion-oficial-www.Jarroba.com_.png) **Probamos que Python esté correctamente** instalado consultando la versión: ```bash python3 --version ``` Si no funciona prueba con (depende de las variables de entorno y la versión de Python que tengas instalada): ```bash python --version ``` [![Captura de la terminal con el comando python3 --version que muestra Python 3.8.5](https://jarroba.com/wp-content/uploads/2021/04/Probar-Python-www.Jarroba.com_.png)](https://jarroba.com/wp-content/uploads/2021/04/Probar-Python-www.Jarroba.com_.png) **Prueba también que funcione PIP** (en algunas versiones está preinstalado, en otras no; si antes la comprobación de la versión de Python te funcionó con “python3” tendrás que usar “pip3”, si te funcionó con “python” a secas tendrás que usar “pip”): ```bash pip3 --version ``` O si no te funciona el anterior, prueba con: ```bash pip --version ``` [![Captura de la terminal con el comando pip --version que muestra pip 20.2.3 para Python 3.8](https://jarroba.com/wp-content/uploads/2021/04/Probar-PIP-www.Jarroba.com_.png)](https://jarroba.com/wp-content/uploads/2021/04/Probar-PIP-www.Jarroba.com_.png) Cuidado #### ******Si no te funciona PIP****** Entonces tienes que **instalar PIP** con: ```bash sudo apt install python3-pip ``` **Pruébalo**: ```bash pip --version ``` Si lo anterior te funciona, sáltate lo que resta de este cuadro. Si tienes problemas, puedes instalar PIP de la **manera tradicional manual**, primero **descargando el fichero “get-pip.py”**: ```bash wget https://bootstrap.pypa.io/get-pip.py ``` **Ejecutar el fichero “get-pip.py” con Python**: ```bash python get-pip.py ``` **Añadir a la variable de entorno PATH** (no es obligatorio, ver al final de este cuadro): ```bash export PATH="$HOME/.local/bin:$PATH" ``` **Pruébalo**: ```bash pip --version ``` Si no añades la variable de entorno al PATH, también podrás ejecutar PIP, pero tendrás que hacerlo con un comando como (no podrás llamar cómodamente a “pip”, aunque es lo mismo): ```bash python -m pip install PAQUETE ``` **Nota si quieres aprender Python**: hemos abierto un curso gratuito de Python en [https://jarroba.com/courses/curso-de-python-gratis/](https://jarroba.com/courses/curso-de-python-gratis/) donde aprenderás Python desde una perspectiva profesional para trabajar con grandes cantidades de datos, con muchos ejemplos de código y teoría en vídeo. ## Instalar Jupyter y JupyterLab **Después de instalar Python y PIP**, procedemos a instalar Jupyter y después JupyterLab para poder trabajar más cómodamente. **Nota sobre Jupyter vs JupyterLab:** JupyterLab es una versión mejorada de Jupyter que ofrece más funcionalidad, con la que recomiendo trabajar, aunque también puedes trabajar con Jupyter. **Instalar Jupyter**: ```bash pip install jupyter ``` **Instalar Jupiter Lab** (es necesario haber instalado previamente Jupyter): ```bash pip install jupyterlab ``` **Donde arranquemos Jupyter o JupyterLab será la carpeta donde se guardarán los Notebooks** que creemos en Jupyter o JupyterLab. Recomiendo crear una carpeta de “proyectos” (o “notebooks” o como queramos): ```bash mkdir proyectos ``` Entrar en ella: ```bash cd proyectos ``` Y **arrancamos el servidor de “JupyterLab”** con el comando: ```bash jupyter lab ``` Cuando se haya iniciado (tarda unos segundos), aparecerá una **URL que copiaremos y pegaremos en el navegador** (o [http://localhost:8888/lab](http://localhost:8888/lab)): [![Captura de la terminal al ejecutar jupyter lab, con la URL local con token resaltada para abrir en el navegador](https://jarroba.com/wp-content/uploads/2021/04/Iniciar-el-servidor-de-Jupyter-Lab-www.Jarroba.com_-1024x271.png)](https://jarroba.com/wp-content/uploads/2021/04/Iniciar-el-servidor-de-Jupyter-Lab-www.Jarroba.com_.png) **Esta URL nos abrirá nuestro JupyterLab local**que ya podremos utilizar (y todos los Notebooks que creemos se guardarán en esta carpeta “proyectos”). [![Captura de JupyterLab abierto en el navegador en localhost:8888/lab, mostrando el Launcher](https://jarroba.com/wp-content/uploads/2021/04/Abrir-Jupyter-Lab-en-un-Navegador-www.Jarroba.com_.png)](https://jarroba.com/wp-content/uploads/2021/04/Abrir-Jupyter-Lab-en-un-Navegador-www.Jarroba.com_.png) **No cierres la consola ni el servidor mientras utilizas JupyterLab, ya que está funcionando sobre este** (realmente la consola sí la puedes cerrar, pero luego te será un poco más pesado apagar el servidor). Cuando acabes de trabajar con JupyterLab, aparte de cerrar la pestaña del navegador donde esté abierto JupyterLab, tendrás que **apagar el servidor de JupyterLab** (pues te está consumiendo recursos de tu ordenador) pulsando: **[ctrl]+[c]** Nota #### ******Si quieres utilizar Jupyter en vez de JupyterLab****** Los pasos son todos los mismos (quitando la instalación de “JupyterLab”), pero en vez de arrancar con el comando “jupyter lab” arrancamos con: ```bash jupyter notebook ``` Esto igual que JupyterLab, se inicia el servidor de Jupyter y nos da una URL que copiar (o [http://localhost:8888/tree](http://localhost:8888/tree)), y tras copiar en el navegador la URL se abrirá Jupyter Notebook: [![Captura de Jupyter Notebook en el navegador en localhost:8888/tree con la lista de ficheros vacía](https://jarroba.com/wp-content/uploads/2021/04/Abrir-Jupyter-en-un-Navegador-www.Jarroba.com_-1024x200.png)](https://jarroba.com/wp-content/uploads/2021/04/Abrir-Jupyter-en-un-Navegador-www.Jarroba.com_.png) El resto funciona igual, salvo que la interfaz de Jupyter es más simplona, con menos opciones y ayudas que JupyterLab que es más completa. Está bien conocerla, pues puede que nos sea útil. Para apagar el servidor también es con: [ctrl] + [c] ## Tutorial rápido JupyterLab en Python No va a ser un tutorial extensivo (falta explicar otras muchas cosas como Markdown, accesos rápidos, etc.), pero sí te ofreceré más que suficiente como para que trabajes cómoda y rápidamente. **Creamos un nuevo fichero Notebook** pulsando sobre el acceso rápido del Launcher (si no aparece pulsar el botón del “+”) en la categoría “Notebook”, llamado “Python 3” (o también se puede crear en “File/New/Notebook”): [![Captura de JupyterLab con el botón «+» y el acceso «Python 3» de Notebook resaltados para crear un notebook](https://jarroba.com/wp-content/uploads/2021/04/Crear-un-Notebook-de-Python-con-Jupyter-Lab-www.Jarroba.com_.png)](https://jarroba.com/wp-content/uploads/2021/04/Crear-un-Notebook-de-Python-con-Jupyter-Lab-www.Jarroba.com_.png) Se nos habrá abierto y creado un fichero Notebook con el nombre “Untitled.ipynb”. Podemos **renombrar el fichero** para que tenga un nombre que queramos pulsando con el botón derecho del ratón sobre el fichero en el navegador de archivos de la izquierda y seleccionando “Rename” (Cámbiale el nombre pero conserva la extensión “.ipynb”, yo le llamaré “MiPrimerProyecto.ipynb”): [![Captura de JupyterLab con el menú contextual de Untitled.ipynb y la opción «Rename» resaltada](https://jarroba.com/wp-content/uploads/2021/04/Renombrar-un-Notebook-en-Jupyter-Lab-www.Jarroba.com_.png)](https://jarroba.com/wp-content/uploads/2021/04/Renombrar-un-Notebook-en-Jupyter-Lab-www.Jarroba.com_.png) En el Notebook abierto de la derecha podemos **escribir código Python en una celda** **y ejecutarlo con el triángulo** (o con la combinación de teclado: [mayus]+[enter] ): [![Captura de JupyterLab con un notebook que ejecuta print("Hola") en una celda y el botón de ejecutar resaltado](https://jarroba.com/wp-content/uploads/2021/04/Ejecutar-codigo-Python-en-un-Notebook-en-Jupyter-Lab-www.Jarroba.png)](https://jarroba.com/wp-content/uploads/2021/04/Ejecutar-codigo-Python-en-un-Notebook-en-Jupyter-Lab-www.Jarroba.png) **Debajo de la celda con código Python mostrará la salida** (y podremos realizar todas las bondades de JupyterLab, como escribir código en varias celdas y ejecutarlo por separado, cambiar el orden a las celdas, introducir comentarios Markdown, etc.). Para guardar las modificaciones que hagamos en un Notebook ir a “File/Save Notebook” (o con la combinación de teclado: [ctrl]+[s] ) Nota #### ********Los ficheros Notebook creados con JupyterLab******** Los ficheros creados con JupyterLab (o Jupyter si usamos este otro), se encuentran en la carpeta donde hemos iniciado JupyterLab. Podemos verlos por ejemplo con “ls”: [![Captura de la terminal de Linux con el comando ls mostrando el fichero MiPrimerProyecto.ipynb](https://jarroba.com/wp-content/uploads/2021/04/Comprobar-nuestros-ficheros-Notebook-creados-en-Linux-www.Jarroba.png)](https://jarroba.com/wp-content/uploads/2021/04/Comprobar-nuestros-ficheros-Notebook-creados-en-Linux-www.Jarroba.png) Pero realmente es más cómodo (sobre todo si trabajas con WSL de Windows) acceder a ellos es “descargándolos” desde el navegador de ficheros de JupyterLab seleccionando el fichero que queramos descargar y pulsando “Download”: [![Captura del navegador de ficheros de JupyterLab con el menú contextual y la opción Download resaltada](https://jarroba.com/wp-content/uploads/2021/04/Descargar-un-ficheros-Notebook-desde-Jupyter-Lab-www.Jarroba.png)](https://jarroba.com/wp-content/uploads/2021/04/Descargar-un-ficheros-Notebook-desde-Jupyter-Lab-www.Jarroba.png) O subiéndolos, arrastrando ficheros directamente al navegador de ficheros de JupyterLab (o pulsando en la flecha de cargar ficheros): [![Captura de JupyterLab con el botón de subir ficheros resaltado y un fichero arrastrado al navegador de ficheros](https://jarroba.com/wp-content/uploads/2021/04/Subir-un-ficheros-Notebook-desde-Jupyter-Lab-www.Jarroba.com_.png)](https://jarroba.com/wp-content/uploads/2021/04/Subir-un-ficheros-Notebook-desde-Jupyter-Lab-www.Jarroba.com_.png) Y este aparecerá dentro de la carpeta de “proyectos” de Linux. ## Bibliografía - [Project Jupyter](https://jupyter.org/) - [Welcome to Python.org](https://www.python.org/)