Настройка vscode для разработки ML-моделей

Рассказываем, как настроить Visual Studio Code (vscode) в Windows для разработки ML-моделей в Analytic Workspace.

План такой:

1. Установить Python последней версии. Если у вас уже есть установленная версия Python (не ниже версии 3.8), то можно попробовать пропустить этот шаг.
2. Установить средство разработки vscode.
3. Через инструменты vscode установить все нужные библиотеки, в т.ч. Jupyter Notebook.

Установка Python

Заходим на официальный сайт Python и качаем последнюю версию языка.

После завершения скачивания запускаем установочный пакет. На первом экране:

1. Обязательно (!) ставим галочку "Add python.exe to PATH".

   Почему важна галочка PATH

   Если не выставить этот флаг при установке, то запуск инструментов Python (python, pip и т.п.) из командной строки удет невозможен.

   Если забыли выставить эту галочку, то проще всего запустить установку заново.

2. Запускаем установку, нажав "Install Now". На всех остальных экранах мастера установки можно не менять предлагаемые по умолчанию значения параметров.

3. После завершения установки перезагружаем компьютер.

   Что? Перезагрузить компьютер?

   Да-да, за 20+ лет в Windows основные вещи почти не меняются .

   Скорее всего, достаточно будет просто завершить сеанс текущего пользователя и зайти заново. Но полная перезагрузка всегда надежна в таких вопросах.

Установка vscode

Скачиваем установочный пакет с официального сайта vscode.

Запускаем скачанный установочный пакет и соглашаемся со всеми предлагаемыми по умолчанию значениями параметров.

Настройка vscode

Создаем папку, в которой будут находиться файлы ноутбуков. Запускаем vscode (в меню "Пуск" после установки должен появиться ярлык), и открываем созданную папку через меню "File -> Open Folder".

После открытия папки на экране возникнет вопрос "Доверяем ли мы авторам этой папки" (т.е., нам самим). Да, доверяем.

В правой панели (Explorer) создаем файл с расширением ipynb (это важно! например, intro.ipynb) и открываем его на редактирование. В правом нижнем углу появится приглашение к установке рекомендованных для разработки на Python расширений. Жмем "Install".

Если вдруг приглашение к установке рекомендованных расширений не появилось, то заходим в раздел Extensions, указываем в строке поиска "python" и устанавливаем расширение "Python" от Microsoft.

После установки расширений открываем внутренний терминал vscode (пункт меню Terminal -> New terminal). И там последовательно указываем две команды:

pip install --upgrade pip wheel setuptools

и затем

pip install --upgrade analytic-workspace-client[ml] catboost

Кроме catboost, таким же образом можно установить и другие библиотеки для машинного обучения и анализа данных.

После установки библиотек из терминала, нажимаем "Select Kernel" в правом верхнем углу экрана. И в появившемся окне выбираем "Install/Enable suggested extensions Python + Jupyter".

После этого в правом нижнем углу появится индикатор установки "Installing Jupyter extension...". Дожидаемся окончания установки расширения.

После установки сверху появится ещё одно окно. Выбираем пункт "Python environment...".

И далее выбираем рекомендованное окружение

Проверяем установку

В первой ячейке вводим текст и запускаем её.

import aw_client
import catboost

catboost.__version__

Возникнет ещё один вопрос на установку ещё одного расширения. Соглашаемся.

Дожидаемся завершения установки.

Мы должны увидеть, что ячейка выполнилась успешно, и под ней была напечатана версия catboost.