人工智能游乐场

本示例基于 Intel Arc A-Series dGPU 和 Ultra iGPU 的 xpu 实现

欢迎来到 AI Playground beta 开源项目和 AI PC 入门应用程序，用于在由英特尔® Arc™ GPU 提供支持的 PC 上进行 AI 图像创建、图像风格化和聊天机器人。 AI Playground 利用 GitHub 和 Huggingface 的库，这些库可能并非在全球所有国家/地区都可用。

自述文件.md

英语（自述文件.md）

最低规格

AI Playground beta 目前可作为打包安装程序提供，也可作为我们的 Github 存储库中的源代码提供。要运行 AI Playground，您必须拥有满足以下规格的 PC

Windows操作系统
英特尔酷睿 Ultra-H 处理器、英特尔酷睿 Ultra 200V 系列处理器或具有 8GB vRAM 的英特尔 Arc GPU（独立）

安装 - 打包安装程序：

AI Playground 有多个打包的安装程序，每个安装程序都特定于硬件。这些软件包使最终用户可以更轻松地安装 AI Playground 并使其在 PC 上运行。请注意，虽然这确实使过程变得更加容易，但这是开源测试版软件，其中组件和版本可能会发生冲突。检查“疑难解答”部分以了解已知问题。

选择正确的安装程序（适用于配备 Intel Arc GPU 的台式机系统，或适用于 Intel Core Ultra-H 系统），下载到您的 PC，然后运行安装程序。
安装程序将分为两个阶段。它将首先从安装程序安装组件和环境。第二阶段将从源头引入组件。安装的第二阶段将需要几分钟的时间，并且需要稳定的互联网连接。
首次运行时，加载屏幕最多需要一分钟
下载用户指南以获取应用信息

适用于 Intel Core Ultra 200V (LNL) 的 AI Playground 1.22b - 发行说明 |下载
适用于英特尔酷睿 Ultra-H (MTL) 的 AI Playground 1.22b - 发行说明 |下载
适用于桌面 dGPU (ACM) 的 AI Playground 1.22b - 发行说明 |下载
AI Playground 用户指南

安装故障排除：

确保您的系统具有 Intel Arc GPU。转到 Windows 开始菜单。在“显示适配器”下键入“设备管理器”，查看 GPU 设备的名称。它应该描述一个 Intel Arc GPU。如果显示“Intel(R) Graphics”，则您的系统没有内置 Intel Arc GPU 并且不符合最低规格
安装中断：在线安装部分可能会被 IT 网络、防火墙或睡眠设置中断或阻止。确保位于开放网络上，防火墙关闭，并将睡眠设置设置为在开机时保持清醒状态。
某些 Windows 系统可能缺少所需的库。可以通过在此处安装 Microsoft 的 64 位 VC++ 重新发行版来解决此问题 https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170
有报告称 Huggingface 版本错误。这是由于第三方组件更改了版本。此问题已在 11 月中旬发布的 v1.22b 中得到纠正。

项目开发

查看源代码

git clone -b dev https://github.com/intel/AI-Playground.git
cd AI-Playground

开发环境设置（后端，python）

conda create -n aipg_xpu python=3.11 -y
conda activate aipg_xpu
conda install libuv -y

cd service

@ REM for Desktop-dGPU (e.g. A770)
pip install -r requirements-arc.txt

@ REM for Intel Core Ultra-H (MTL)
pip install -r requirements-ultra.txt

检查XPU环境是否正确

python -c " import torch; import intel_extension_for_pytorch as ipex; print(torch.__version__); print(ipex.__version__); [print(f'[{i}]: {torch.xpu.get_device_properties(i)}') for i in range(torch.xpu.device_count())]; "

输出示例：

2.1.0.post3+cxx11.abi
2.1.40+xpu
[0]: _DeviceProperties(name='Intel(R) Arc(TM) Graphics', platform_name='Intel(R) Level-Zero', dev_type='gpu', driver_version='1.3.29283', has_fp64=1, total_memory=14765MB, max_compute_units=112, gpu_eu_count=112)

将开发环境链接到项目环境

切换到项目的根目录。（AI-游乐场）
执行以下命令查看conda虚拟环境的路径

在窗户上

 conda env list|findstr aipg_xpu

根据获取到的环境路径，运行以下命令，在windows上创建env文件链接

 mklink /J "./env" "{aipg_xpu_env_path}"

WebUI（nodejs + 电子）

安装Nodejs开发环境，可以从https://nodejs.org/en/download获取。
切换到WebUI目录并安装所有Nodejs依赖项。

 npm install

 npm run dev

型号支持

AI Playground 支持 PyTorch LLM、SD1.5 和 SDXL 模型。 AI Playground 不附带任何模型，但确实可以直接从界面或通过用户从 HuggingFace.co 或 CivitAI.com 下载模型并将其放置在适当的模型文件夹中来间接使模型可用于所有功能。

当前从应用程序链接的模型

模型	执照	背景信息/模型卡
梦想塑造者 8 模型	执照	地点
Dreamshaper 8 修复模型	执照	地点
JuggernautXL v9 模型	执照	地点
Phi3-mini-4k-指令	执照	地点
bge-large-en-v1.5	执照	地点
潜在一致性模型 (LCM) LoRA：SD1.5	执照	地点
潜在一致性模型 (LCM) LoRA:SDXL	执照	地点