Riffusion 应用

:no_entry: 该项目已不再积极维护。

Riffusion 是一款基于稳定扩散模型的实时音乐生成应用。

本仓库包含驱动该网站的交互式 Web 应用程序。它使用 Next.js、React、TypeScript、three.js、Tailwind 和 Vercel 构建而成。

运行

这是一个基于 Next.js 的项目，通过 create-next-app 引脚启动。

首先，请确保已安装 Node v18 或更高版本，可通过运行 node --version 来检查。

安装依赖：

npm install

启动开发服务器：

npm run dev
# 或者
yarn dev

在浏览器中打开 http://localhost:3000，即可看到应用。

应用的首页位于 pages/index.js。编辑该文件时，页面会自动更新。关于页面位于 pages/about.tsx。

pages/api 目录会被映射到 /api/*。此目录下的文件被视为 API 路由，而非 React 页面。

推理服务器

要真正生成模型输出，我们需要一个能够通过 API 响应推理请求的模型后端。如果您拥有一块能够在五秒内运行稳定扩散的大显存 GPU，请克隆并按照 推理服务器 中的说明运行 Flask 应用程序。

您还需要在本仓库的根目录下创建一个 .env.local 文件，并指定推理服务器的 URL：

RIFFUSION_FLASK_URL=http://127.0.0.1:3013/run_inference/

引用

如果您在此基础上进行开发，请按以下方式引用：

@article{Forsgren_Martiros_2022,
  author = {Forsgren, Seth* and Martiros, Hayk*},
  title = {{Riffusion - 基于稳定扩散的实时音乐生成}},
  url = {https://riffusion.com/about},
  year = {2022}
}

Riffusion App 快速上手指南

注意：本项目目前已不再积极维护，仅供学习和参考。

Riffusion 是一个基于 Stable Diffusion 的实时音乐生成应用。本指南将帮助你快速在本地运行其交互式 Web 前端。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：Windows / macOS / Linux
• Node.js：版本需为 v18 或更高。
  • 检查版本命令：node --version
  • 若未安装或版本过低，请访问 Node.js 官网 下载，或使用国内镜像源（如 cnpm）进行安装。
• 包管理器：npm 或 yarn（推荐 npm）。

安装步骤

1. 克隆项目代码

   git clone https://github.com/hmartiro/riffusion-app-hobby.git
   cd riffusion-app-hobby
   

2. 安装依赖 建议使用国内镜像源加速安装过程：

   npm install --registry=https://registry.npmmirror.com
   # 或者使用默认源
   # npm install
   

3. 配置推理服务器地址（可选） 若你已部署后端推理服务（需要高性能 GPU），请在项目根目录创建 .env.local 文件并填入后端地址：

   RIFFUSION_FLASK_URL=http://127.0.0.1:3013/run_inference/
   

   注：若无后端服务，前端仍可运行，但无法生成实际的音乐模型输出。后端部署请参考 riffusion-inference 仓库。

基本使用

1. 启动开发服务器 在项目根目录执行以下命令：

   npm run dev
   # 或者
   yarn dev
   

2. 访问应用 打开浏览器访问： http://localhost:3000

3. 开发说明

   • 首页入口文件位于 pages/index.js。
   • 关于页面位于 pages/about.tsx。
   • 修改代码后页面会自动热更新。
   • API 接口逻辑位于 pages/api 目录下，遵循 Next.js API Routes 规范。