Riff ChatGPT Plugin

Riff music tooling packaged for ChatGPT, downstream of the native Riff project. This repository is downstream of Riff; it does not maintain a fork of the generation engine or studio.

Source and dependency

Extracted from Riff PR #32, source commit cd98f3f4191c2b1356d6048bfe44b3848d31cb2d. Its full Git ancestry is preserved so original authorship and the original integration remain inspectable. The extraction commit removes upstream implementation files from this repository's working tree.

Riff is a Git submodule at riff/, locked in upstream.lock.json to b7ab93cf22ffd9e95a7718aca2e0d451578411b1, the merge of standalone LoRA PR #28. This plugin owns MCP tools, the ChatGPT bridge and UI integration, shared drafts/settings, plugin metadata, packaging and host acceptance tests. Upstream Riff owns generation, LoRAs, recordings, the studio and native/control/media source pins.

git clone --recurse-submodules https://github.com/Flip-Engineering/Riff-ChatGPT-Plugin.git
cd Riff-ChatGPT-Plugin
npm ci
npx playwright install chromium
./scripts/validate.sh

Validation needs Python 3.10+, Node.js, Chromium and FFmpeg/FFprobe. Development validation runs on the homelab with TMPDIR and the checkout on NVMe. Python runtime packaging remains separately pinned for user distributions.

Related MCP server: AI Sound MCP Server

ChatGPT Chat target

ChatGPT Chat is the required user surface. The cloud distribution bundles the native engine for execution in the user's Chat environment, with no homelab or local-computer backend. Private installation, native CPU generation, exact WAV export and inline player display have passed in Chat. Version 0.3.3 displays recordings with the original custom visualizer; larger recordings use a labeled preview and receipt-verified local full-WAV playback. See the measured results and limits. The complete studio's live library, LoRA and score controls still need a connected MCP Apps transport (issue #2). The original local stdio distribution remains available.

Run and package

See plugin usage and runtime packaging. Build the UI with npm run build:ui. For development, start plugins/riff-chatgpt/server/main.py --riff-root "$PWD/riff" --workspace /absolute/private/workspace --ui-file "$PWD/plugins/riff-chatgpt/dist/studio.html".

Builders under plugins/riff-chatgpt/packaging/ consume the verified Riff submodule. scripts/package_chatgpt_plugin.py assembles the plugin-owned integration plus the curated pinned upstream runtime. Package receipts identify both the plugin commit and Riff commit. The complete studio and LoRA workflow are retained.

Update Riff by checking out a reviewed upstream revision inside riff/, updating upstream.lock.json, running validation and committing both pins together. Builders reject mismatched revisions and tracked changes. The UI adapter checks exact integration points and refuses incompatible upstream UI changes.

Delivery status

The cloud package is privately installed and tested; it has not been published to the public directory. Historical validation records pre-extraction evidence; downstream results are tracked in extraction validation and Chat acceptance. Platform package builds, real model inference, Apple Silicon behavior and actual ChatGPT host installation are reported independently. Music weights are downloaded separately under their own terms.