Установка Jupyter и первый ноутбук в Python: пошаговый гайд

В конце этой инструкции у вас в браузере откроется рабочий ноутбук, в котором вы напишете print("Hello, Jupyter"), нажмёте Shift+Enter и увидите вывод под ячейкой. Всё вместе занимает 15–20 минут, из которых большая часть — скачивание пакетов. Мы ставим Jupyter в отдельное виртуальное окружение, чтобы он не смешивался с системным Python и не ломал другие проекты.

Инструкция проверена на Python 3.12 и актуальной на конец 2024 года версии пакета notebook (7.x). Команды одинаковы для Windows, macOS и Linux, различия только в способе активации окружения — они указаны отдельно.

Что нужно до начала

Соберите это заранее, чтобы не остановиться на середине:

• Python 3.9 или новее. Проверьте командой python --version (на macOS и Linux иногда python3 --version). Если Python не установлен — скачайте с python.org. На Windows при установке поставьте галочку «Add Python to PATH».
• Доступ в интернет — пакеты качаются из PyPI.
• Терминал. На Windows это PowerShell или «Командная строка», на macOS — «Терминал», на Linux — любой эмулятор.
• Права на запись в папку проекта. Устанавливать глобально с правами администратора не нужно и не рекомендуется.

Менеджер пакетов pip идёт вместе с Python начиная с версии 3.4, отдельно ставить его не нужно.

Шаг 1. Создайте папку проекта

Откройте терминал и создайте отдельную папку. Вся работа будет вестись в ней.

mkdir jupyter-start
cd jupyter-start

Проверка: команда pwd (на Windows — cd без аргументов) покажет путь, оканчивающийся на jupyter-start.

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

Виртуальное окружение^* изолирует пакеты проекта от системных. Модуль venv входит в стандартную поставку Python.

python -m venv .venv

На macOS и Linux, если python не найден, используйте python3.

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

Шаг 3. Активируйте окружение

Команда зависит от системы и оболочки:

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

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

Шаг 4. Установите Jupyter

Внутри активированного окружения поставьте пакет notebook. Он тянет за собой ядро IPython и веб-интерфейс.

pip install notebook

Скачается несколько десятков мегабайт зависимостей. Это нормально.

Проверка: команда jupyter --version выведет список компонентов и их версии, среди них notebook.

Шаг 5. Запустите Jupyter

Одна команда поднимает локальный сервер и открывает браузер:

jupyter notebook

В терминале появятся строки о запуске сервера и адрес вида http://localhost:8888/tree?token=.... Браузер откроется сам. Если нет — скопируйте эту ссылку целиком (вместе с токеном) в адресную строку.

Терминал с запущенным Jupyter закрывать нельзя — это и есть сервер. Пока окно открыто, ноутбук работает. Закроете терминал — сервер остановится.

Проверка: в браузере открылась страница с содержимым папки jupyter-start.

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

1. Нажмите кнопку New в правом верхнем углу и выберите Python 3 (ipykernel).
2. Откроется новый ноутбук с пустой ячейкой. Впишите в неё:

   print("Hello, Jupyter")

3. Нажмите Shift+Enter. Под ячейкой появится строка Hello, Jupyter.

Проверьте, что ядро действительно исполняет код, а не просто показывает текст. Впишите во вторую ячейку выражение и снова нажмите Shift+Enter:

years = 3
months = years * 12
months

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

Как завершить работу

Сохраните ноутбук: Ctrl+S (Cmd+S на macOS). Файл с расширением .ipynb появится в папке проекта. Затем закройте вкладку браузера и в терминале нажмите Ctrl+C, подтвердив остановку сервера вводом y.

Чтобы вернуться к работе позже: снова активируйте окружение (шаг 3) и выполните jupyter notebook. Переустанавливать ничего не нужно — пакеты остались в .venv.

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

• PowerShell: «выполнение сценариев отключено в этой системе». Политика безопасности блокирует скрипт активации. Разово разрешите для текущего пользователя: Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned, затем повторите активацию. Или используйте CMD вместо PowerShell.
• «python is not recognized» (Windows). Python не добавлен в PATH. Переустановите с python.org, отметив «Add Python to PATH», либо запускайте через py вместо python.
• «command not found: jupyter» после установки. Скорее всего окружение не активировано — префикса (.venv) нет в строке. Выполните шаг 3 заново.
• Браузер не открылся, а токен потерялся. В терминале выполните jupyter notebook list — команда покажет запущенные серверы с их адресами и токенами.
• Порт 8888 занят. Jupyter сам возьмёт следующий свободный (8889 и так далее). Смотрите фактический адрес в выводе терминала, а не подставляйте 8888 вручную.

Что дальше

Ноутбук работает — дальше стоит разобраться с двумя вещами. Первая: команда pip freeze > requirements.txt сохранит список установленных пакетов, чтобы воспроизвести окружение на другой машине. Вторая: если хотите современный интерфейс с вкладками и файловым менеджером, поставьте в то же окружение pip install jupyterlab и запускайте командой jupyter lab — ноутбуки .ipynb открываются в нём без изменений.

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