离线 AI 图片生成器入门:Node.js 一步步安装与运行
从零开始,教你安装 Node.js、配置环境、运行 QVAC 本地 AI 图片生成,无需联网和 API 密钥。
几年前,使用 AI 图片生成器还得排队等 Discord 的额度。如今,我们可以在自己的电脑上免费、离线运行 Stable Diffusion(一种将文字描述变成图片的 AI 模型)。本教程带你一步步搭建本地 AI 图片生成器,无需任何 API 密钥,也不用联网。
准备环境:装好 Node.js
首先,确保你的电脑安装了 Node.js(一个让 JavaScript 在电脑上运行的环境)。访问 nodejs.org,下载 LTS 版本并安装。安装完成后,打开终端(Windows 用命令提示符或 PowerShell,Mac 用终端),输入以下命令验证是否成功:
- 输入
node -v,如果显示版本号(如 v18.12.0),说明安装成功。 - 输入
npm -v,如果显示版本号,说明包管理器可用。
常见坑:安装时务必勾选“Add to PATH”,否则终端无法识别 node 命令。
安装步骤:下载项目与依赖
我们将使用 QVAC SDK(一个在本地运行 AI 模型的工具包)和 Socket.io(用于实时通信的库)。
- 创建一个新文件夹,例如
ai-image-generator,并在终端中进入该文件夹。 - 运行
npm init -y初始化项目,生成package.json文件。 - 安装依赖:
npm install express socket.io @qvac/sdk。等待安装完成。 - 下载预训练模型:QVAC 使用 量化版 Stable Diffusion 2.1(一个压缩后的 AI 模型,体积更小,适合普通电脑)。运行
npx @qvac/sdk pull sd-v2-1-1b-q8_0,模型会自动下载到本地。
常见坑:如果下载速度慢,可以换用国内镜像源:npm config set registry https://registry.npmmirror.com。
验证是否成功:运行你的第一个生成任务
在项目文件夹中创建 server.js,写入以下代码:
const express = require('express');
const http = require('http');
const { Server } = require('socket.io');
const { QVAC } = require('@qvac/sdk');
const app = express();
const server = http.createServer(app);
const io = new Server(server);
app.use(express.static('public'));
const qvac = new QVAC();
io.on('connection', (socket) => {
socket.on('generate', async (prompt) => {
const image = await qvac.generate('sd-v2-1-1b-q8_0', prompt);
socket.emit('result', image);
});
});
server.listen(3000, () => console.log('Server running on http://localhost:3000'));
创建 public/index.html,包含一个输入框和按钮,用 Socket.io 发送提示词并显示返回的图片。然后运行 node server.js,在浏览器打开 http://localhost:3000。输入“a cat sitting on a chair”,点击生成,等待几秒,你就能看到 AI 画的猫了!
常见坑:如果生成失败,检查模型是否下载完整,或终端是否有报错。确保电脑有至少 4GB 可用内存。
下一步可以做什么
你已经成功在本地运行了 AI 图片生成器!接下来可以:
- 修改提示词,生成不同风格的图片。
- 添加更多前端功能,如历史记录、图片下载。
- 尝试其他量化模型,如
sd-v2-1-3b-q4_0(更小但质量稍低)。
从此,你拥有了一个完全离线、免费的 AI 图片生成工具,尽情发挥创意吧!
内容来源
freeCodeCamp
发布时间
2026-06-20 01:30