riffusion-app-hobby

环境要求

• Node.js v18 或更高版本（用 node --version 确认）
• npm 或 yarn 包管理器
• 如需真正生成音乐，需要一台能 5 秒内跑完 stable diffusion 的大显存 GPU 机器，并部署 riffusion-inference 推理服务
• 可访问 GitHub 与 npm 源（首次安装依赖需要联网）

安装与启动步骤

1. 1检查 Node 版本

   打开终端执行命令，确认输出为 v18 或更高。版本过低会导致 Next.js 启动失败，需先升级 Node。

   node --version

   复制

2. 2安装项目依赖

   在仓库根目录执行 npm install 安装 Next.js、React、three.js、Tailwind 等依赖，首次安装耗时较长。

   npm install

   复制

3. 3启动开发服务器

   运行开发模式，Next.js 会启动本地服务并支持热更新。也可用 yarn dev 代替 npm run dev。

   npm run dev
   yarn dev

   复制

4. 4浏览器打开应用

   在浏览器访问 http://localhost:3000 即可看到应用首页，页面源码在 pages/index.js，关于页在 pages/about.tsx。

5. 5接入推理服务

   仅启动前端无法生成模型输出。需先按 riffusion-inference 仓库说明用 GPU 跑 Flask 推理服务，再在根目录新建 .env.local 指定其 URL。

如何确认成功

终端出现开发服务器就绪提示且无报错，浏览器打开 http://localhost:3000 能看到 Riffusion 应用首页。

常见问题

注意事项

• 项目已停止积极维护，仅适合学习或实验用途。
• README 中 .env.local 的具体配置项名称被截断，请以原仓库 Inference Server 一节为准，不要凭猜测填写键名。
• 推理服务对 GPU 要求较高（需在 5 秒内完成一次 stable diffusion 推理），普通笔记本难以满足。
• 页面自动热更新，修改 pages/index.js 后无需重启即可看到变化。