voice_audio_multi/tests/owsm/convert_gguf.py
Fabio c36510c21e
Some checks failed
Linux Build / Linux cpu (push) Has been cancelled
Linux Build / Linux cpu-clang (push) Has been cancelled
Linux Build / Linux vulkan (push) Has been cancelled
mac-build / macOS CPU (push) Has been cancelled
Nix Build / Nix (cpu) (push) Has been cancelled
Nix Build / Nix (vulkan) (push) Has been cancelled
windows-build / Windows CPU (push) Has been cancelled
Initial import: audio.cpp with Orange Pi documentation
2026-11-04 19:05:22 +01:00

97 lines
3.8 KiB
Python

#!/usr/bin/env python3
"""Convert an official ESPnet OWSM v4 checkpoint to a self-contained GGUF."""
import argparse
import json
import shutil
import subprocess
from pathlib import Path
import torch
import yaml
from safetensors.torch import save_file
VARIANTS = {
(384, 6, 6): "base",
(768, 9, 9): "small",
(1024, 18, 18): "medium",
}
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("source", type=Path, help="Official Hugging Face snapshot root")
parser.add_argument("output", type=Path)
parser.add_argument("--staging-dir", required=True, type=Path)
parser.add_argument("--converter", type=Path, default=Path("build/debug/bin/audiocpp_gguf"))
parser.add_argument("--spec", type=Path, default=Path("model_specs/owsm.json"))
parser.add_argument("--type", choices=("orig", "q8_0", "q4_k"), default="orig")
parser.add_argument("--overwrite", action="store_true")
args = parser.parse_args()
configs = list(args.source.glob("exp/s2t_train_*/config.yaml"))
checkpoints = list(args.source.glob("exp/s2t_train_*/valid.total_count.ave_5best.pth"))
if len(configs) != 1 or len(checkpoints) != 1:
raise ValueError("Expected one official OWSM v4 config and one ave-5 checkpoint")
config = yaml.safe_load(configs[0].read_text())
encoder = config["encoder_conf"]
decoder = config["decoder_conf"]
key = (encoder["output_size"], encoder["num_blocks"], decoder["num_blocks"])
if key not in VARIANTS:
raise ValueError(f"Unsupported OWSM v4 architecture: {key}")
variant = VARIANTS[key]
if encoder["attention_heads"] != decoder["attention_heads"]:
raise ValueError("OWSM v4 encoder and decoder head counts differ")
if encoder["linear_units"] != encoder["output_size"] * 4:
raise ValueError("OWSM v4 requires a 4x feed-forward width")
state = torch.load(checkpoints[0], map_location="cpu", weights_only=True)
tensors = {
name: tensor.detach().cpu().contiguous()
for name, tensor in state.items()
if not name.startswith("ctc.") and name != "frontend.logmel.melmat"
}
args.staging_dir.mkdir(parents=True, exist_ok=True)
save_file(tensors, args.staging_dir / "model.safetensors")
tokenizer = args.source / config["bpemodel"]
shutil.copyfile(tokenizer, args.staging_dir / "bpe.model")
runtime_config = {
"variant": variant,
"hidden_size": encoder["output_size"],
"num_heads": encoder["attention_heads"],
"encoder_layers": encoder["num_blocks"],
"decoder_layers": decoder["num_blocks"],
"intermediate_size": encoder["linear_units"],
"vocabulary_size": len(config["token_list"]),
"max_audio_samples": 480000,
"frontend_frames": 3001,
"encoder_frames": 374,
"max_decode_tokens": 374,
}
(args.staging_dir / "config.json").write_text(json.dumps(runtime_config, indent=2) + "\n")
command = [
str(args.converter.resolve()),
"--input", str((args.staging_dir / "model.safetensors").resolve()),
"--root", str(args.staging_dir.resolve()),
"--output", str(args.output.resolve()),
"--type", args.type,
"--family", "owsm",
"--model-spec", str(args.spec.resolve()),
"--sidecar", f"{(args.staging_dir / 'config.json').resolve()}=config.json",
"--sidecar", f"{(args.staging_dir / 'bpe.model').resolve()}=bpe.model",
]
if args.type != "orig":
for name, tensor in tensors.items():
if tensor.ndim != 2:
command.extend(("--keep-type", f"{name}=f32"))
if args.overwrite:
command.append("--overwrite")
args.output.parent.mkdir(parents=True, exist_ok=True)
subprocess.run(command, check=True)
print(f"Converted OWSM v4 {variant}: {len(tensors)} tensors, storage={args.type}")
if __name__ == "__main__":
main()