Установить Jupyter и запустить первый ноутбук в Python

К концу этой инструкции у вас в браузере откроется рабочая тетрадка Jupyter, вы выполните первую ячейку с кодом на Python и увидите результат прямо под ней. Займёт это 15-20 минут, если Python уже стоит, и на пять минут больше, если ставите его с нуля. Никакой магии: Jupyter — это обычный пакет Python, который запускает локальный веб-сервер и рисует интерфейс в браузере.

Материал написан под Python 3.11-3.12 и JupyterLab 4.x (это актуальная линейка на момент написания). Классический Jupyter Notebook тоже жив, но новые проекты ставят JupyterLab — он и в этой инструкции.

Что нужно иметь до начала

Проверьте это заранее, чтобы не упереться в середине.

• Python 3.9 или новее. Проверка в терминале: python --version или python3 --version. Если команда не находится — Python не установлен или не в PATH.
• pip. Обычно ставится вместе с Python. Проверка: pip --version.
• Терминал. На Windows — PowerShell или cmd, на macOS/Linux — обычный терминал.
• Права на запись в папку, где создадите окружение. Домашняя папка подходит всегда.

Если Python нет — скачайте установщик с python.org. На Windows при установке поставьте галочку Add Python to PATH, иначе команда python не будет находиться.

Не ставьте Jupyter командой pip install в системный Python. Через полгода у вас будет пять проектов с несовместимыми версиями библиотек и ни одного рабочего. Виртуальное окружение — это не «для профи», это первое, что делают все.

Шаг 1. Создать виртуальное окружение

Виртуальное окружение¹ изолирует пакеты проекта от системных. Создаём папку проекта и окружение внутри неё.

# создаём и заходим в папку проекта
mkdir my-jupyter
cd my-jupyter

# создаём окружение с именем venv
python -m venv venv

Проверка: рядом появилась папка venv с подпапками bin (macOS/Linux) или Scripts (Windows).

Шаг 2. Активировать окружение

Команда активации отличается по системе.

# macOS / Linux
source venv/bin/activate

# Windows (PowerShell)
venv\Scripts\Activate.ps1

# Windows (cmd)
venv\Scripts\activate.bat

Проверка: в начале строки терминала появилось (venv). Пока оно там — все установки идут в окружение, а не в систему.

Если в PowerShell вылезла ошибка про запрет выполнения скриптов — см. раздел «если не получилось».

Шаг 3. Установить JupyterLab

Обновим pip и поставим сам JupyterLab.

python -m pip install --upgrade pip
pip install jupyterlab

Установка тянет за собой десятки зависимостей, это нормально — подождите минуту-две. Проверка: команда jupyter lab --version печатает номер версии, например 4.2.0.

Шаг 4. Запустить сервер и открыть интерфейс

jupyter lab

Что произойдёт: терминал напечатает несколько строк с адресом вида http://localhost:8888/lab?token=..., а браузер откроется на этой странице сам. Если не открылся — скопируйте ссылку с токеном из терминала целиком и вставьте в браузер.

Проверка: вы видите интерфейс JupyterLab — слева файловый браузер, справа область Launcher с плитками для создания ноутбуков и консолей.

Важно: не закрывайте терминал, пока работаете. Он и есть сервер. Закроете — интерфейс в браузере перестанет отвечать.

Шаг 5. Создать первый ноутбук и выполнить ячейку

1. В Launcher нажмите плитку Python 3 в разделе Notebook. Создастся файл Untitled.ipynb.
2. Кликните в первую ячейку и впишите:

message = "Первый ноутбук работает"
print(message)
2 + 2

1. Нажмите Shift+Enter — это выполнит ячейку и перейдёт к следующей.

Проверка: под ячейкой появится строка Первый ноутбук работает, а ниже — 4. Последнее выражение ячейки Jupyter показывает автоматически, без print. Это ключевое отличие от запуска обычного скрипта.

Чем .ipynb отличается от .py

Ноутбук — это не текстовый файл с кодом. Внутри .ipynb лежит JSON: ячейки, их вывод и метаданные ядра. Отсюда две особенности, о которые спотыкаются новички.

Практический вывод: если выполнили ячейки не по порядку, переменная может содержать не то, что вы думаете. Когда результат странный — Kernel → Restart Kernel and Run All Cells. Это перезапускает Python и прогоняет ноутбук сверху вниз, как честный скрипт.

Если не получилось

• python: command not found — Python не в PATH. Попробуйте python3. На Windows переустановите с галочкой Add Python to PATH.
• PowerShell: ...Activate.ps1 cannot be loaded because running scripts is disabled — политика выполнения запрещает скрипты. Выполните один раз в PowerShell: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, подтвердите и повторите активацию.
• jupyter: command not found после установки — окружение не активировано либо установка ушла в другой Python. Убедитесь, что в строке есть (venv), и запускайте через python -m jupyterlab.
• Браузер не открылся — скопируйте из терминала полную ссылку с token= и откройте вручную. Без токена страница попросит его ввести.
• Address already in use на порту 8888 — уже запущен другой Jupyter. Закройте его или запустите на другом порту: jupyter lab --port 8890.

Что делать дальше

Первый ноутбук работает — теперь наведите порядок в окружении. Зафиксируйте установленные пакеты командой pip freeze > requirements.txt, чтобы позже воспроизвести окружение. Если планируете держать несколько проектов с разными библиотеками — держите отдельное venv под каждый. Для остановки сервера вернитесь в терминал и нажмите Ctrl+C, затем деактивируйте окружение командой deactivate.

Следующий предмет для изучения — установка библиотек данных (pandas, matplotlib) в это же окружение и подключение ноутбука к нескольким ядрам. Это отдельная тема, здесь мы только поставили базу.

¹ Виртуальное окружение — изолированная папка с собственной копией интерпретатора и набором пакетов. Позволяет держать в разных проектах разные версии библиотек, не конфликтуя между собой.