CoolFace
Modelpublic

griffing52/orpheus-swiss-german-lora

sourceHugging Faceupdated 3mo agoView on Hugging Face
2likes62downloads
Model Card

Orpheus Swiss German LoRA

This model is a fine-tuned LoRA adapter designed to adapt the Orpheus base model for Text-to-Speech (TTS) synthesis in Swiss German. It processes text conditioning prompts and generates speech tokens encoded via a 24kHz SNAC codec interleaving layout.

Model Details

Model Description

  • Developed by: griffing52
  • Shared by: griffing52
  • Model type: PEFT Adapter (LoRA) for Causal Language Modeling (Speech/Text generation)
  • Language(s) (NLP): Swiss German (gsw), German (de)
  • License: [More Information Needed]
  • Finetuned from model: canopylabs/3b-de-ft-research_release

Model Sources

Uses

Direct Use

This adapter is intended for Text-to-Speech generation in Swiss German dialects. Speech synthesis is triggered using a formatted prefix prompt layout: voice: transcript.

Out-of-Scope Use

This model is not built for standard text-based conversational modeling, nor will it perform well generating languages or accents far outside German/Swiss German linguistic structures.

Bias, Risks, and Limitations

  • Dialect Consistency: Swiss German features massive lexical and phonetic variance across regions. Dialect spelling inconsistencies in training transcripts heavily influence the resulting prosody and pronunciation quality.
  • Overtraining Risk: Training beyond 1–2 epochs on small datasets risks degrading prosody and speech naturalness.

How to Get Started with the Model

You can load this adapter on top of the base model using the code below:

python
import torch
from peft import PeftModel
from transformers import AutoModelForCausalLM, AutoTokenizer

BASE_MODEL = "canopylabs/3b-de-ft-research_release"
ADAPTER_ID = "griffing52/orpheus-swiss-german-lora"

dtype = torch.float16 if torch.cuda.is_available() else torch.float32

# Load base model and tokenizer
tokenizer = AutoTokenizer.from_pretrained(BASE_MODEL)
base_model = AutoModelForCausalLM.from_pretrained(BASE_MODEL, torch_dtype=dtype)

if torch.cuda.is_available():
    base_model = base_model.to("cuda")

# Load fine-tuned adapter
model = PeftModel.from_pretrained(base_model, ADAPTER_ID)
model.eval()

Training Details

Training Data

<!-- This should link to a Dataset Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->

The model was fine-tuned using paired Swiss German audio and transcripts structured in a SpeechT5-style metadata format.

  • Audio Format: 24kHz mono (WAV/FLAC/MP3) encoded into SNAC tokens.
  • Target Layout: Tokens packed into the native 7-token interleaved Orpheus speech architecture.

Training Procedure

<!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->

Preprocessing

Transcripts and voice tags were converted into text-conditioning prompts bounded by specialized system tokens (SOHTOKEN, EOTTOKEN, EOHTOKEN). Audio files were resampled to 24,000 Hz, passed through a hubertsiuzdak/snac24khz codec model to extract 3 layers of acoustic features, and flattened into speech sequences.

Training Hyperparameters
  • Training regime: [More Information Needed] <!--fp32, fp16 mixed precision, bf16 mixed precision, bf16 non-mixed precision, fp16 non-mixed precision, fp8 mixed precision --> -Training regime: QLoRA 4-bit (nf4 quantization with double quantization enabled)
  • Compute Precision: fp16 mixed precision
  • LoRA Configuration:
  • r: 32
  • alpha: 64
  • dropout: 0.05
  • Target Modules: qproj, kproj, vproj, oproj, gateproj, upproj, down_proj
  • Optimization Strategy:
  • Learning Rate: 2e-4
  • LR Scheduler: Cosine
  • Warmup Ratio: 0.03
  • Epochs: 2
  • Per Device Train Batch Size: 1
  • Gradient Accumulation Steps: 24
  • Gradient Checkpointing: Enabled
Speeds, Sizes, Times

<!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->

Total Training Steps: Concluded at checkpoint-216.

Evaluation

<!-- This section describes the evaluation protocols and provides the results. -->

<!-- ### Testing Data, Factors & Metrics -->

<!-- #### Testing Data -->

<!-- This should link to a Dataset Card if possible. -->

<!-- [More Information Needed] -->

<!-- #### Factors -->

<!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. -->

<!-- [More Information Needed] -->

<!-- #### Metrics -->

<!-- These are the evaluation metrics being used, ideally with a description of why. -->

<!-- [More Information Needed] -->

<!-- ### Results -->

<!-- [More Information Needed] -->

<!-- #### Summary -->

<!-- ## Model Examination [optional] -->

<!-- Relevant interpretability work for the model goes here -->

<!-- [More Information Needed] -->

Environmental Impact

<!-- Total emissions (in grams of CO2eq) and additional considerations, such as electricity usage, go here. Edit the suggested text below accordingly -->

Carbon emissions can be estimated using the Machine Learning Impact calculator presented in Lacoste et al. (2019).

  • Hardware Type: GPU (Google Colab Environment)
  • Cloud Provider: Google Cloud

Technical Specifications [optional]

<!-- ### Model Architecture and Objective -->

<!-- [More Information Needed] -->

<!-- ### Compute Infrastructure -->

<!-- [More Information Needed] -->

<!-- #### Hardware -->

<!-- [More Information Needed] -->

<!-- #### Software -->

<!-- [More Information Needed] -->

<!-- ## Citation [optional] -->

<!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->

<!-- BibTeX: -->

<!-- [More Information Needed] -->

<!-- APA: -->

<!-- [More Information Needed] -->

<!-- ## Glossary [optional] -->

<!-- If relevant, include terms and calculations in this section that can help readers understand the model or model card. -->

<!-- [More Information Needed] -->

<!-- ## More Information [optional] -->

<!-- [More Information Needed] -->

<!-- ## Model Card Authors [optional] -->

<!-- [More Information Needed] -->

<!-- ## Model Card Contact -->

<!-- [More Information Needed] -->

Framework versions

  • PEFT 0.18.1
  • Transformers 5.0.0+
  • PyTorch 2.10.0+cu128
  • SNAC 1.2.1