Skip to content
CAI
Software that uses CAICheck a score

OpenBMB/VoxCPM

59.9

Adequate · 15 November 2026

9.3k

lines of production code

Python

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add Docker support and complete i18n for LoRA WebUI

The application now includes Docker support with a \.dockerignore\ file to optimize image builds and \.gitignore\ updates to exclude large model and data directories. The LoRA fine-tuning WebUI (\lora\_ft\_webui.py\) has been fully internationalized with a new \i18n.py\ module providing Chinese and English translations for all UI strings, and the UI now respects the \VOXCPM\_LANG\ environment variable. Additionally, the WebUI defaults to loading the VoxCPM2 model if available, and includes logic to detect the correct sample rate from the model's configuration.

(repo-wide) · high confidence

Add Docker support for GPU-accelerated training with nginx reverse proxy

Users can now run the VoxCPM LoRA Training WebUI in a containerized environment using the provided Dockerfile, docker-compose.yml, and nginx configuration. The setup includes a PyTorch base image with CUDA support for GPU-accelerated fine-tuning, volume mounts for models, data, and training outputs, and an nginx reverse proxy that handles WebSocket connections and forwards HTTPS headers correctly for load balancer compatibility.

docker · high confidence

Added training data example file

A new example file (examples/train\_data\_example.jsonl) has been added to demonstrate the expected format for training data. It shows how to structure JSON lines with audio paths (relative or absolute) and text transcripts, and illustrates optional fields like duration and dataset\_id for advanced training configurations.

examples · high confidence

AudioVAE v2 introduction and config-driven initialization

The AudioVAE module now includes a new v2 implementation (audio\_vae\v2.py) featuring causal convolution blocks, Snake activation functions, and noise injection for improved audio generation. Additionally, the original AudioVAE class has been refactored to accept an AudioVAEConfig object instead of individual parameters, allowing for easier configuration management and serialization. Both versions are now exported from the module's \\init\\_.py.

src/voxcpm/modules/audiovae · high confidence

Introduce VoxCPM2 model and enhance v1 with LoRA, seed control, and MPS stability

This change adds a new VoxCPM2 model variant (VoxCPM2Model) alongside significant upgrades to the existing VoxCPM1 model. For users, this means access to a new model architecture and the ability to fine-tune both v1 and v2 using LoRA (Low-Rank Adaptation) via the new LoRAConfig. Generation is now reproducible through explicit seed support, and Apple Silicon (MPS) users benefit from automatic float32 fallback to prevent quality loss, with an environment variable override available. Additionally, streaming generation and runtime device/dtype resolution have been improved for better stability and performance across platforms.

src/voxcpm/model · high confidence

Introduce dedicated training utilities for VoxCPM fine-tuning

The \src/voxcpm/training\ package now provides a complete set of utilities for fine-tuning VoxCPM models, mirroring the mechanics of the minicpm-audio tooling. This includes an \Accelerator\ for handling distributed training (DDP) and mixed precision, a \TrainingTracker\ for logging metrics to TensorBoard and stderr, and a \TrainingState\ container for managing model and optimizer state. Data handling is supported by \load\_audio\_text\_datasets\ for loading JSONL manifests via the HuggingFace \datasets\ library, \AudioFeatureProcessingPacker\ for converting raw audio/text into packed multimodal representations, and a \validate\_manifest\ function for pre-flight checks of training data integrity.

src/voxcpm/training · high confidence

VoxCPM v2 model and enhanced CFM training/inference capabilities

This update introduces the VoxCPMLocDiT v2 architecture (local\_dit\_v2.py), a diffusion model with a Transformer backbone that integrates MiniCPM4, sinusoidal positional embeddings, and timestep embeddings for audio generation. Alongside the new model, the UnifiedCFM module has been expanded to support classifier-free guidance (CFG) with configurable training and inference rates, adaptive loss weighting, and refined time-sampling strategies (log-normal/uniform) to improve training stability and generation quality.

src/voxcpm/modules/locdit · high confidence

VoxCPM2 support, LoRA fine-tuning, timestamp alignment, and audio denoising enhancements

The library now supports the VoxCPM2 architecture alongside the original VoxCPM, automatically detecting the model type via config.json. It introduces LoRA (Low-Rank Adaptation) support, allowing users to fine-tune models and load pre-trained LoRA weights with automatic configuration resolution. A new timestamp alignment module (using stable-ts) enables word- or character-level audio-text synchronization. Audio processing is enhanced with a new ZipEnhancer denoiser and loudness normalization. The CLI has been refactored into subcommands (design, clone, batch) with improved argument validation, prompt-file support, and lazy imports for faster startup.

src/voxcpm · high confidence

Behavioural changes

Add no\_rope option and fix MPS/SDPA stability issues

The MiniCPM4 module now supports a \no\_rope\ configuration option that disables rotary position embeddings when set to true, allowing for alternative positional encoding strategies. Additionally, the module addresses stability issues on MPS devices by ensuring query, key, and value tensors are contiguous before attention computation, and fixes a CPU-side dimension bug in scaled dot-product attention by explicitly broadcasting the attention mask to a 4D shape.

src/voxcpm/modules/minicpm4 · high confidence

Replace text normalization library with wetext

The text normalization logic in \src/voxcpm/utils/text\_normalize.py\ has been refactored to use the \wetext\ library instead of the previous \tn\ package. This change updates the \TextNormalizer\ class to instantiate \wetext.Normalizer\ for both Chinese and English processing, replacing the old \ZhNormalizer\ and \EnNormalizer\ imports. Additionally, several internal helper functions for sentence cutting and paragraph splitting that were previously defined in this file have been removed, as the normalization workflow now relies on the new library's capabilities.

src/voxcpm/utils · high confidence

Test coverage

Added comprehensive test coverage for CLI, model utilities, and security hardening; New finetuning and inference test scripts with LoRA support and MPS dtype fixes.

Dependencies

Migrate to pyproject.toml and update Python/dependency requirements

The project has moved its dependency management from requirements.txt to pyproject.toml, raising the minimum supported Python version to 3.10. Key library updates include upgrading Gradio to version 6, datasets to version 3, and torch/transformers to more flexible version ranges. The text normalization library has been replaced with 'wetext', and new dependencies such as torchcodec, pydantic, matplotlib, argbind, and safetensors have been added. An optional 'timestamps' dependency group featuring stable-ts has also been introduced.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 60 → 60 (+0.1)
  • Rubric changed (rubric-2026.11.1 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 61 → 56 (-5.6)
  • Architecture 84 → 98 (+13.8)
  • Maturity 64 → 68 (+3.7)
  • Readiness 52 → 52 (+0.0)
  • Security 79 → 84 (+5.1)

Resolved (14)

  • Duplicated block (14 lines × 2) (src/voxcpm/model/voxcpm.py)
  • FileTooLong: scripts/train_voxcpm_finetune.py (scripts/train_voxcpm_finetune.py)
  • Hotspot: lora_ft_webui.py (lora_ft_webui.py)
  • Near-duplicate member pair (59 shared lines) (src/voxcpm/model/voxcpm.py)
  • No ADRs found
  • Projects may be oversized for their cohesion
  • train_voxcpm_finetune.generate_sample_audio (cognitive 34) (scripts/train_voxcpm_finetune.py)
  • train_voxcpm_finetune.generate_sample_audio (cyclomatic 20) (scripts/train_voxcpm_finetune.py)
  • train_voxcpm_finetune.load_checkpoint (cognitive 40) (scripts/train_voxcpm_finetune.py)
  • train_voxcpm_finetune.load_checkpoint (cyclomatic 22) (scripts/train_voxcpm_finetune.py)
  • train_voxcpm_finetune.save_checkpoint (cognitive 30) (scripts/train_voxcpm_finetune.py)
  • train_voxcpm_finetune.train (cognitive 64) (scripts/train_voxcpm_finetune.py)
  • train_voxcpm_finetune.train (cyclomatic 46) (scripts/train_voxcpm_finetune.py)
  • train_voxcpm_finetune.validate (cognitive 25) (scripts/train_voxcpm_finetune.py)

New (11)

  • Edited copy of a member (15 corresponding lines) (src/voxcpm/modules/audiovae/audio_vae.py)
  • Edited copy of a member (22 corresponding lines) (src/voxcpm/modules/audiovae/audio_vae.py)
  • Edited copy of a member (25 corresponding lines) (src/voxcpm/modules/locdit/local_dit.py)
  • Edited copy of a member (26 corresponding lines) (src/voxcpm/modules/minicpm4/model.py)
  • Edited copy of a member (34 corresponding lines) (src/voxcpm/modules/minicpm4/model.py)
  • Edited copy of a member (4 corresponding lines) (src/voxcpm/modules/audiovae/audio_vae.py)
  • Edited copy of a member (43 corresponding lines) (src/voxcpm/modules/audiovae/audio_vae.py)
  • Edited copy of a member (9 corresponding lines) (app.py)
  • Near-duplicate member pair (63 shared lines) (src/voxcpm/model/voxcpm.py)
  • No ADRs found (pyproject.toml)
  • Orphaned file (src/voxcpm/training/validate.py)

Changes since last survey

  • 3 commits — 3 feature/other, 0 fixes

By area

  • (root) — 2 commits
  • (repo) — 1 commit

Notable commits

  • change: Merge pull request #458 from OpenBMB/docs/rename-voxadub-in-ecosystem
  • change: docs: rename Video Dubbing Translator to VoxaDub in ecosystem listing
  • change: docs: update docs link to openbmb.cn/docs

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

OpenBMB/VoxCPM was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 300e4260b509066151d623dc9c0aa922cf82232b — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.73+preprod-52de90b74216.