README.md

metadata

title: SoftChart
emoji: 🥁
colorFrom: red
colorTo: yellow
sdk: gradio
sdk_version: 6.20.0
python_version: '3.11'
app_file: app.py
pinned: false
license: mit
models:
  - JacobLinCool/softchart-v18
  - JacobLinCool/softchart-v17
  - JacobLinCool/softchart-v17-small
  - JacobLinCool/softchart-v17-tiny
  - JacobLinCool/softchart-v16
  - JacobLinCool/softchart-v16-small
  - JacobLinCool/softchart-v16-tiny
  - JacobLinCool/softchart-v15
  - JacobLinCool/softchart-planner
datasets:
  - JacobLinCool/taiko-1000-parsed-clean

🥁 SoftChart

Generate a Taiko no Tatsujin-style chart from an uploaded song with the scratch-trained SoftChart V1.8 hierarchical model. The 8,985,091-parameter model combines whole-song hierarchical context, a local rhythmic-skeleton auxiliary head, chart generation, and beat/downbeat estimation. It uses no external pretrained model and no external song planner.

V1.8 is the default recommendation, not the only option. Users can select V1.5, V1.6, or V1.7—including the small and tiny scaling variants—from the interface for direct comparison. Those releases run through their frozen generation runtime and original legacy planner; this does not change V1.8's self-contained, scratch-only architecture.

The Space always uses each selected model's full-song time generation path for arbitrary uploads. The beat head can estimate BPM and a downbeat grid for TJA quantization, but that estimated grid is not treated as the trusted rational meter required by exact slot generation. This distinction prevents an estimated beat grid from being presented as authored-meter exact timing.

Audio preprocessing follows the released model contract: FFmpeg decodes stereo float32 at 22,050 Hz, channels are averaged arithmetically, and a periodic-Hann STFT is projected to 128 log-mel bins. Upload a song, choose a difficulty, and receive:

• a playable .tja for TJAPlayer3 / OpenTaiko;
• a rendered chart image;
• the full-song mel structure view used by the hierarchy;
• a synchronized WAV audition with synthesized Taiko hits.

The audition is rendered from the exported TJA, including its OFFSET, so the preview and downloadable chart use the same timing. Taiko voices are original modal-resonator syntheses included under the project's MIT license.

The model and Space code are MIT-licensed. Evaluation scope, metrics, and known limitations are documented on the V1.8 model card.