setup-llm-course-windows

name	setup-llm-course-windows
description	在 Windows 系统上为大模型课程自动配置 conda 虚拟环境并安装所有 Python 依赖包。当用户在 Windows 上需要配置 AI 课程环境、创建 conda 环境、安装 PyTorch/transformers/openai 等深度学习和大模型相关依赖时使用此技能。前提条件是用户已安装好 Miniconda 或 Anaconda。

Windows 大模型课程环境配置

描述

本技能用于在 Windows 系统上自动配置大模型课程所需的完整 Python 开发环境。包括创建 conda 虚拟环境、配置国内镜像源、安装 PyTorch 及所有课程依赖包，并验证安装结果。

使用场景

• 用户请求在 Windows 上配置大模型/AI 课程的 Python 环境
• 用户需要创建 conda 虚拟环境并安装深度学习相关依赖
• 用户提到需要安装 transformers、openai、PyTorch 等课程所需的包
• 用户说"配置环境"、"安装依赖"、"准备课程环境"等

前提条件

• Windows 10/11 操作系统
• 已安装 Miniconda 或 Anaconda（本技能不包含 Miniconda 的下载和安装）

如果用户尚未安装 Miniconda，请告知用户需要先下载安装 Miniconda，然后再使用本技能。

指令

按以下步骤顺序执行。每一步执行后检查输出，确认成功后再继续下一步。

步骤 1：验证 conda 可用

在终端中运行：

conda --version

如果输出版本号（如 conda 24.x.x），继续下一步。

如果提示"不是内部或外部命令"，尝试初始化：

conda init powershell

如果遇到执行策略错误，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后提示用户关闭并重新打开终端。

步骤 2：配置国内镜像源

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --set show_channel_urls yes
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

步骤 3：创建课程专用虚拟环境

conda create -n llm-course python=3.10 -y

步骤 4：激活环境

conda activate llm-course

确认命令行前缀变为 (llm-course)。

步骤 5：安装 PyTorch

先询问用户："你的电脑是否有 NVIDIA 独立显卡？"

如果没有 NVIDIA 显卡（选择 CPU 版本）：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

如果有 NVIDIA 显卡（选择 CUDA 版本）：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121

步骤 6：安装课程全部依赖包

pip install "numpy>=1.24.0" "matplotlib>=3.7.0" "seaborn>=0.12.2" "pandas>=2.0.0" "scikit-learn>=1.3.0" "tqdm>=4.66.0" "requests>=2.31.0" "openai>=1.0.0" "tiktoken>=0.5.0" "transformers>=4.36.0" "accelerate>=0.25.0" "sentence-transformers>=2.2.0" "peft>=0.7.0" "trl>=0.7.0" "datasets>=2.16.0" "jupyter>=1.0.0" "ipywidgets>=8.0.0"

如果某个包安装失败，单独重试该包。

步骤 7：验证安装

创建并运行以下 Python 验证脚本：

import sys
print(f"Python: {sys.version}")

packages = {
    "numpy": "numpy",
    "matplotlib": "matplotlib",
    "seaborn": "seaborn",
    "pandas": "pandas",
    "scikit-learn": "sklearn",
    "torch": "torch",
    "openai": "openai",
    "tiktoken": "tiktoken",
    "transformers": "transformers",
    "accelerate": "accelerate",
    "sentence-transformers": "sentence_transformers",
    "peft": "peft",
    "trl": "trl",
    "datasets": "datasets",
    "tqdm": "tqdm",
    "requests": "requests",
    "jupyter": "jupyter",
    "ipywidgets": "ipywidgets",
}

failed = []
for name, module in packages.items():
    try:
        m = __import__(module)
        ver = getattr(m, "__version__", "ok")
        print(f"  {name}: {ver}")
    except ImportError:
        failed.append(name)
        ()

 failed:
    ()
:
    ()

如果有包未安装成功，单独使用 pip install 重新安装失败的包。

步骤 8：配置 API Key（可选）

询问用户是否已有阿里百炼 DashScope API Key。

如果有，帮助设置环境变量：

[System.Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "用户提供的key", "User")

提示用户重启 Trae 使环境变量生效。

如果没有，告知用户可以在 https://dashscope.console.aliyun.com/ 申请，课前准备好即可。

完成

告知用户：

1. 环境配置已完成
2. 每次使用前需要先运行 conda activate llm-course 激活环境
3. 可以用 jupyter notebook 启动 Jupyter 来打开课程 .ipynb 文件