Skip to content

Como instalar e iniciar o JupyterLab

Rajiv Chandra
Name
Rajiv Chandra

Updated on

JupyterLab é a interface moderna para trabalhar com notebooks, código e dados.
Este guia rápido ajuda você a instalar e iniciar o JupyterLab em apenas alguns minutos.

1. Instalar Python e pip

JupyterLab roda em Python, então você precisa ter o Python (e o pip) instalados primeiro.

Windows

Baixe o instalador mais recente do Python em:
👉 https://www.python.org/downloads/ (opens in a new tab)

Durante a instalação, marque a opção “Add Python to PATH.”
O pip é incluído automaticamente.

macOS & Linux

A maioria dos sistemas já vem com Python pré-instalado. Verifique sua versão:

python3 --version

Se o Python não estiver instalado, instale-o via:

  • macOS (Homebrew):

    brew install python

  • Ubuntu / Debian:

    sudo apt install python3 python3-pip

2. Instalar JupyterLab

Quando o Python e o pip estiverem prontos, instale o JupyterLab:

pip install jupyterlab

Isso instala a versão estável mais recente (JupyterLab 4.x).

3. Iniciar o JupyterLab

Inicie o JupyterLab com:

jupyter lab

Seu navegador padrão será aberto automaticamente.
Agora você pode criar notebooks, executar código Python e gerenciar arquivos.

Opcional: Criar um ambiente virtual (recomendado)

Um ambiente virtual ajuda a isolar pacotes entre diferentes projetos.

1. Instalar virtualenv (se necessário)

pip install virtualenv

2. Criar um ambiente virtual

virtualenv myenv

3. Ativar o ambiente

Windows

.\myenv\Scripts\activate

macOS & Linux

source myenv/bin/activate

4. Instalar o JupyterLab dentro do ambiente virtual

pip install jupyterlab

5. Iniciar o JupyterLab

jupyter lab

Para sair do ambiente:

deactivate

FAQ & Tópicos avançados

(Colocado após a seção para iniciantes para manter o guia simples no início.)

P1: Como configurar o JupyterLab com Conda?

Conda é popular em ciência de dados porque gerencia tanto pacotes quanto ambientes.

1. Instalar Miniconda ou Anaconda

2. Criar um novo ambiente

conda create --name myenv

3. Ativá-lo

conda activate myenv

4. Instalar JupyterLab

conda install -c conda-forge jupyterlab

5. Iniciar o JupyterLab

jupyter lab

P2: Como faço para atualizar do Jupyter Notebook para o JupyterLab?

Você não precisa desinstalar o Notebook. Ambos podem coexistir.

Usando pip

pip install jupyterlab

Usando conda

conda install -c conda-forge jupyterlab

Após a instalação, basta executar:

jupyter lab

Seus notebooks .ipynb existentes abrirão normalmente.

P3: (Avançado) E as extensões ou os recursos do JupyterLab 4.x?

  • O JupyterLab 4.x usa um novo sistema de extensões que elimina a necessidade de Node.js para a maioria das extensões.

  • Muitas extensões populares (temas, integração com Git, inspetor de variáveis) são compatíveis com o JupyterLab 4.

  • Para instalar extensões:

    pip install jupyterlab-language-pack-<lang>
pip install jupyterlab_git

  • Para listar as extensões instaladas:

    jupyter labextension list

Se você é iniciante, pode ignorar extensões com segurança até se sentir mais confortável.

P4: (Avançado) Posso rodar o JupyterLab com Docker?

Sim. Exemplo:

docker run -p 8888:8888 jupyter/base-notebook

P5: (Avançado) Como gerenciar múltiplos kernels de Python?

Você pode instalar kernels para diferentes ambientes:

pip install ipykernel
python -m ipykernel install --user --name myenv