Установить Jupyter и запустить первый ноутбук: без частых ошибок

К концу этой инструкции у вас в браузере откроется интерфейс Jupyter Notebook, вы создадите файл с расширением .ipynb и выполните первую ячейку с Python-кодом, увидев результат прямо под ней. Времени уйдёт 10–15 минут, если Python уже стоит, и минут 25, если ставите его с нуля. Проверено на Python 3.11 и 3.12, Jupyter Notebook 7.x.

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

Прежде чем вводить первую команду, убедитесь, что на месте базовые вещи. Половина проблем новичков — не в Jupyter, а в том, что чего-то из этого списка не было.

• Python 3.9 или новее. Проверьте в терминале: python --version или python3 --version. Если команда не найдена — установите Python с python.org (Windows/macOS) или через пакетный менеджер дистрибутива (Linux). На Windows при установке обязательно отметьте галочку Add Python to PATH.
• pip. Идёт в комплекте с современным Python. Проверка: python -m pip --version.
• Доступ в интернет для скачивания пакетов.
• Права на запись в папку, где будете работать. Не ставьте окружение в системные каталоги вроде C:\Program Files.

Ядро (kernel) — это отдельный процесс, который выполняет код ваших ячеек. Для Python это пакет ipykernel. Интерфейс Jupyter в браузере и ядро — разные вещи; их несовпадение и есть источник самой частой ошибки новичка.

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

Не ставьте Jupyter в системный Python — так вы рано или поздно сломаете зависимости других программ. Изолированное окружение решает это одной командой.

# переходим в папку проекта (создайте её заранее)
cd путь/к/вашей/папке

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

Появится подкаталог venv. Активируйте его:

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

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

# macOS / Linux
source venv/bin/activate

Проверка: в начале строки терминала появится префикс (venv). Если его нет — окружение не активировалось, и всё, что вы поставите дальше, уйдёт не туда.

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

С активным окружением ставим сам пакет. Обратите внимание: команда через python -m pip, а не просто pip — так вы гарантированно попадёте в нужный интерпретатор.

python -m pip install --upgrade pip
python -m pip install notebook

Пакет notebook подтянет и ipykernel, и веб-интерфейс. Если хотите современный редактор с вкладками и файловым деревом — вместо notebook поставьте jupyterlab. Обе среды открывают одни и те же .ipynb-файлы.

Проверка: jupyter --version выведет список компонентов с номерами версий. Если видите строки с notebook или jupyter_core — установка прошла.

Шаг 3. Запустите сервер

jupyter notebook

В терминале появятся строки с адресом вида http://localhost:8888/tree?token=..., и по умолчанию откроется браузер. Проверка: в браузере вы видите файловое дерево вашей папки. Терминал при этом занят — не закрывайте его, пока работаете; это и есть работающий сервер.

Если браузер не открылся сам — скопируйте из терминала полную ссылку с токеном и вставьте в адресную строку вручную. Без токена страница попросит пароль.

Шаг 4. Создайте ноутбук и запустите первую ячейку

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

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

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

Проверка: под ячейкой появится текст Первый ноутбук работает, а ниже — строка Out[1]: 4. Слева от ячейки номер [1] означает, что код выполнен. Если там [*] — код ещё считается; если пусто — ячейка не запускалась.

Число в квадратных скобках слева — это порядок выполнения, а не порядок ячеек на экране. Вы можете запускать ячейки в любом порядке, и именно из-за этого ноутбук легко приводит в состояние, которое невозможно воспроизвести сверху вниз. Привыкайте иногда делать Kernel → Restart and Run All.

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

Пять ошибок, которые встречаются почти у всех новичков.

• «jupyter: command not found» / «не является внутренней командой». Окружение не активировано или Jupyter поставлен в другой Python. Проверьте префикс (venv) и запустите через python -m notebook вместо голого jupyter notebook.
• «ModuleNotFoundError: No module named 'pandas'» (или любой другой пакет), хотя вы его ставили. Вы поставили пакет в одно окружение, а ноутбук использует другое ядро. В ячейке выполните import sys; print(sys.executable) — путь должен вести в ваш venv. Если нет — установите пакет из того же окружения, где запущен сервер.
• В списке New нет вашего окружения как ядра. Зарегистрируйте ядро явно: при активном окружении выполните python -m ipykernel install --user --name=venv --display-name "Python (venv)", перезапустите сервер и выберите его в Kernel → Change kernel.
• «Activate.ps1 cannot be loaded because running scripts is disabled» (Windows PowerShell). Политика выполнения скриптов запрещает активацию. Разово разрешите для текущего пользователя: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, затем повторите активацию. Или используйте cmd с activate.bat.
• «Port 8888 is already in use». Сервер уже запущен в другом терминале или порт занят. Запустите на другом порту: jupyter notebook --port 8890.

Быстрая шпаргалка по горячим клавишам

В ноутбуке два режима: командный (рамка ячейки синяя, нажмите Esc) и редактирования (рамка зелёная, нажмите Enter). Клавиши работают по-разному в зависимости от режима.

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

Первый ноутбук запущен — дальше стоит навести порядок, чтобы не наступить на грабли позже:

• Зафиксируйте зависимости: python -m pip freeze > requirements.txt. Так вы сможете восстановить окружение на другой машине.
• Добавьте venv/ и .ipynb_checkpoints/ в .gitignore, если работаете с git — иначе засорите репозиторий.
• Освойте Kernel → Restart and Run All как привычку перед тем, как показывать ноутбук кому-то: это ловит скрытую зависимость от порядка запуска ячеек.
• Когда дойдёте до графиков — поставьте matplotlib в то же окружение и начните с одной ячейки, а не сразу с большого кода.

Работу с данными, виджетами и экспортом в HTML/PDF оставим на потом — это отдельные темы, здесь мы только поставили Jupyter и убедились, что ячейки выполняются.