Downloads · 30 days
0
JoyBoyuuu/Temporal-Coupled-Flow-Matching-for-Speech-Continuation
Temporal-Coupled-Flow-Matching-for-Speech-Continuation is a audio-to-audio model from JoyBoyuuu. Use it for the audio-to-audio task on the model card, and read the license before you ship it in a product. It is set up for pytorch.
This repository contains the three formally evaluated Temporal-Coupled Flow Matching (TCFM) FlowHead adapters for speech continuation. TCFM preserves the Flow-SLM sampler, Mimi codec, Transformer, and semantic pathway…
Downloads · 30 days
0
Access
Public
Updated Aug 24, 2026
Repo size
5.9 MB
Likes
0
Public
Click a slice to open those files.
.pt5.9 MB · 100%
From the Hugging Face model README
This repository contains the three formally evaluated Temporal-Coupled Flow Matching (TCFM) FlowHead adapters for speech continuation. TCFM preserves the Flow-SLM sampler, Mimi codec, Transformer, and semantic pathway. It fine-tunes only 488,448 LoRA parameters in the FlowHead by adding speech-time endpoint-trajectory supervision to conditional flow matching.
Code and complete reproduction instructions: https://github.com/JoyBoyuuu/TCFM
These files are adapters, not standalone 1.3B-parameter models. Inference requires the Flow-SLM 1B-extended base checkpoint distributed by the Flow-SLM authors. Download it with:
git clone https://github.com/JoyBoyuuu/TCFM.git
cd TCFM
conda env create -f environment.yml
conda activate tcfm
python scripts/download_assets.py --checkpoint-dir checkpoints \
--cache-dir cache/huggingface
| File | Training seed | Best validation step |
|---|---|---|
tcfm_adapter_seed_42.pt | 42 | 2,000 |
tcfm_adapter_seed_1234.pt | 1,234 | 1,800 |
tcfm_adapter_seed_2026.pt | 2,026 | 1,900 |
The three training runs all completed 2,000 optimizer steps. The released
checkpoint for each seed is the one with the lowest validation objective.
The files are path-free, inference-only exports: optimizer state, random
number generator state, absolute cluster paths, and duplicated LoRA state
are excluded. manifest.json records SHA-256 hashes and adapter settings.
train-clean-100.dev-clean.5e-5, weight decay 1e-4.TCFM reconstructs the clean endpoint implied by the predicted FlowHead velocity and regularizes endpoint displacement, curvature, movement direction, and prefix-continuation boundary behavior along speech time. See the code repository for the complete mathematical objective.
Download one adapter:
from huggingface_hub import hf_hub_download
adapter = hf_hub_download(
repo_id="JoyBoyuuu/Temporal-Coupled-Flow-Matching-for-Speech-Continuation",
filename="tcfm_adapter_seed_42.pt",
)
print(adapter)
Then run a smoke evaluation on a GPU/Slurm compute node:
export AUDIO_ROOT=/path/to/LibriSpeech
sbatch --account=<account> --partition=<gpu-partition> \
--export=ALL,PROJECT_DIR="$PWD",AUDIO_ROOT="$AUDIO_ROOT",\
METHOD=tcfm_adapter,TRAINING_SEED=42,LIMIT=10,\
ADAPTATION_CKPT=/path/to/tcfm_adapter_seed_42.pt,PROTOCOL=open_ended \
scripts/slurm/infer_1gpu.sbatch
The reported decoder uses 32 Euler flow steps, 16 Mimi RVQ stages, acoustic and semantic temperatures 0.8, top-p 0.95, and CFG scale 0.3.
The formal campaign evaluates all three training seeds on LibriSpeech test-clean and test-other with three matched inference seeds. Selected adapter-level results relative to Base Flow-SLM are:
0.909415 -> 0.912781, paired effect
+0.003367 with 95% CI [+0.002298, +0.004455];8.5462 -> 8.4945, effect -0.05175 with 95% CI
[-0.07862, -0.02511];3.653 -> 2.919, about 20% lower;0.65553 -> 0.66977, effect
+0.01424 with 95% CI [+0.01265, +0.01576];0.590 -> 0.533, about 9.8% lower.These results support improved continuation stability, speaker persistence, and distributional acoustic match. They do not establish universal boundary improvement, human preference, or broad lexical/syntactic improvement. Only three training seeds were evaluated.
The adapters are research artifacts for English speech continuation and for reproducing the TCFM experiments. They should not be treated as a speech recognizer, a semantic dialogue model, or a production voice-cloning system. Generated speech may contain incorrect, unstable, or biased content. Obtain consent before processing or imitating a person's voice.
TCFM is derived from Flow-SLM. The upstream Flow-SLM revision used for this
work did not include a license file, so this release does not assert a new
license over inherited architecture or base-model assets. The Flow-SLM base
checkpoint and third-party datasets are not redistributed here and remain
subject to their original terms. See the repository NOTICE.md for details.