安装指南
Tiny-DL-Inference 的详细安装和配置说明。
系统要求
运行环境要求
| 要求 | 最低版本 | 推荐版本 |
|---|---|---|
| Node.js | 18.0 | 20.x |
| npm | 8.0 | 10.x |
| 浏览器 | Chrome 113+ / Edge 113+ | 最新版本 |
GPU 要求
WebGPU 需要兼容的 GPU：
- NVIDIA：GTX 900 系列或更新版本（驱动 470+）
- AMD：RX 400 系列或更新版本
- Intel：Arc 系列或集成显卡（最新驱动）
- Apple：M1 或更新版本（macOS Sonoma+）
安装方式
npm（推荐）
bash
npm install tiny-dl-inference1
从源码构建
1. 克隆仓库
bash
git clone https://github.com/LessUp/tiny-dl-inference.git
cd tiny-dl-inference1
2
2
2. 安装依赖
bash
npm install1
3. 构建项目
bash
npm run build1
4. 验证安装
bash
npm test
npm run typecheck1
2
2
项目脚本
| 脚本 | 描述 |
|---|---|
npm run build | 编译 TypeScript 到 ESM |
npm run typecheck | 运行 TypeScript 类型检查 |
npm test | 运行测试套件 |
npm run test:watch | 监视模式运行测试 |
npm run test:coverage | 带覆盖率报告运行测试 |
npm run lint | 运行代码检查 |
npm run clean | 清除构建产物 |
故障排除
"Cannot find module 'tiny-dl-inference'"
确保已安装包：
bash
npm ls tiny-dl-inference1
WebGPU 不可用
- 更新浏览器到最新版本
- 检查 GPU 驱动版本
- 尝试禁用 GPU 驱动沙箱（Chrome）：
--disable-gpu-sandbox