OpenBMB/VoxCPM
59.9
Adequate · 15 November 2026
9.3k
lines of production code
Python
primary language
4
measurements over time
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.