AI 学习环境与工具总览

这里集中记录可复用的 AI 开发环境与工具安装,不把一次性安装命令拆成多个页面。模型训练、视觉方法和具体工具的深度使用仍各自保留独立笔记。

入口与分工

安装完成不等于环境可用;每次升级后至少重新验证 Python、PyTorch/CUDA、OpenCV 和目标项目的导入。

本机运行环境

  • Python:C:\Users\12706\Desktop\ComfyUI_windows_portable\python_embeded\python.exe
  • PyTorch:2.10.0 + CUDA 13.0
  • GPU:RTX 3070 Ti,可正常调用
  • 已有:OpenCV、Kornia、Einops、NumPy、Pillow
  • 仅缺少轻量依赖 yacs,可能还需 loguru

AIRI:Windows 安装

Scoop 是 Windows 下的命令行包管理器;先安装 Scoop,再添加 AIRI bucket 并安装 AIRI:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# 重新打开 PowerShell 后执行
scoop --version
scoop bucket add airi https://github.com/moeru-ai/airi
scoop install airi/airi

如果 irm 失败,可改用 Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression。更新时执行 scoop update 和 scoop update airi。

Bun / Node:JavaScript 工具环境

需要运行 Claude Code 等 JavaScript 项目时,先安装 Node 24.x,再安装 Bun:

# Bun 安装器
powershell -c "irm bun.sh/install.ps1|iex"
# 或使用 npm
npm install -g bun

node -v
bun -v
git clone https://github.com/kdxsydq/ClaudeCode.git
cd ClaudeCode
bun install
bun run version
bun run dev

这些环境安装步骤来自原来的 AIRI、bun?两页;它们都属于一次性环境准备,合并后更容易按顺序复用,也避免在知识库里出现两个只有安装命令的入口。

验证与失败边界

python --version
python -c "import torch; print(torch.__version__); print(torch.cuda.is_available())"
python -c "import cv2, numpy, PIL; print('vision imports ok')"
node -v
bun -v
  • torch.cuda.is_available() 为 False 时,先检查驱动、CUDA/PyTorch 组合和当前 Python 环境,不要直接修改训练脚本。
  • yacs、loguru 等缺少的轻量依赖,应在实际项目报错后逐项补装;本页不把“可能需要”写成已安装事实。
  • AIRI、Bun、Node 的安装命令只解决工具可执行性;具体项目的依赖锁定、代理和权限问题仍在对应项目笔记中处理。