PreviewAgent framework · JUCE

SampleForge Agent

Turn a folder of sampled notes into a playable, validated instrument: SFZ, DecentSampler and the MultiSampleEngine plugin, all driven by one manifest. A six-phase agent workflow runs the pipeline step by step.

Join the preview See features

Exports SFZ and DecentSampler. SF2 and Ableton .adv export are still being finalised: use SFZ or DecentSampler for now.

Flowchart: raw WAV files go through sampleforge.py to a manifest, which produces SFZ, DecentSampler and the MultiSampleEngine plugin, checked by a validator. — How it works

What it does

One manifest

Single source of truth

sampleforge.py scans filenames for note, velocity layer and round-robin, and writes a manifest everything else reads.

Two sampler formats

SFZ and DecentSampler

Both exports include round-robin, and can copy the samples next to them so the instrument is self-contained.

MultiSampleEngine

A JUCE sampler plugin

Zones, velocity layers, round-robin, pitch, loops, ADSR, sustain and bend. VST3 on Windows, macOS and Linux, AU on macOS, plus Standalone.

Validator

Check every export

validate_exports.py checks parity, round-robin, coverage, sample paths and loops against the manifest.

Agent workflow

Six phases

/ingest, /map, /export, /engine, /validate and /ship for Claude Code, Cursor and Kilo, with rules and known issues.

Re-export

Keep your edits

Hand-corrected the manifest? Re-export from it without losing the edits.

How it works

Six phases, one manifest

/ingestBring in the recordings.
/mapNote, velocity and round-robin mapping.
/exportSFZ and DecentSampler.
/engineMultiSampleEngine reads the same manifest.
/validateCheck everything, then /ship.

Where it stands

Done

Exports and validator

SFZ and DecentSampler exports with round-robin, re-export from an edited manifest, and the export validator.