🛠️ Установка инструментов

Что понадобится

Python

Проверьте, есть ли Python уже сейчас — команда печатает версию:

python --version
python3 --version   # macOS и Linux

Курсу нужен Python 3.12 или новее. Если команда не найдена или версия старее — ставьте заново.

Windows

winget install Python.Python.3.12

Либо установщик с python.org. В первом окне установщика обязательно отметьте Add python.exe to PATH — без этой галочки терминал не увидит команду python.

macOS

brew install python@3.12

Linux и WSL

sudo apt update
sudo apt install python3 python3-venv python3-pip

Виртуальное окружение и пакеты

Пакеты ставятся не в систему, а в отдельное окружение внутри папки проекта. Так у каждого курса свой набор версий, и они не конфликтуют.

mkdir python-for-ai
cd python-for-ai
python -m venv .venv

Активация зависит от оболочки:

Признак успеха — префикс (.venv) в начале строки приглашения.

Пакеты курса ставятся уже внутри активированного окружения:

pip install python-dotenv google-genai huggingface_hub transformers langchain langgraph

Зафиксировать состав окружения, чтобы повторить его на другой машине:

pip freeze > requirements.txt
pip install -r requirements.txt

Ключи API

Правильная схема — файл .env рядом с кодом:

.env

GOOGLE_API_KEY=ваш_ключ
HF_TOKEN=ваш_токен

.gitignore

.env
.venv/

Чтение в коде:

import os
from dotenv import load_dotenv

load_dotenv()
api_key = os.environ["GOOGLE_API_KEY"]

Редактор

Курс написан под Visual Studio Code — команды и названия расширений ниже даны для него.

Расширения ставятся кнопкой в Marketplace или командой в терминале:

code --install-extension ms-python.python
code --install-extension ms-python.vscode-pylance

Проверка, что всё встало

Команды, после которых можно начинать первый урок:

Частые проблемы

Вместо запуска Python открывается Microsoft Store

Это windows-заглушка python.exe. Отключается в «Параметры → Приложения → Дополнительные параметры приложений → Псевдонимы выполнения приложения»: выключите python.exe и python3.exe. После этого переоткройте терминал.

PowerShell не даёт активировать окружение

Сообщение «выполнение сценариев отключено в этой системе». Разрешите скрипты своему пользователю — права администратора не нужны:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

pip поставил пакет, а импорт не находит его

Почти всегда окружение не активировано. Проверьте префикс (.venv) и путь, который печатает pip -V — он должен вести внутрь папки .venv.

VS Code запускает не тот Python

Палитра команд (Ctrl+Shift+P) → Python: Select Interpreter → выберите интерпретатор из .venv вашей папки. Внизу справа в строке состояния видно, какой выбран.

Первый запуск скачивает гигабайты

Это нормально: модели Hugging Face кэшируются в домашней папке при первом обращении. Второй запуск идёт с диска и быстро.

Ошибка про CUDA или отсутствие видеокарты

Модели курса работают и на процессоре — просто медленнее. Ставьте CPU-сборку torch, если видеокарты нет.

Навигация

• ← К оглавлению курса «Python for AI»
• Начать: урок 01
• 📚 Все предметы