{"id":28445,"library":"voxcpm","title":"VoxCPM","description":"VoxCPM is a tokenizer-free text-to-speech (TTS) model for context-aware speech generation and voice cloning. Version 2.0.2 requires Python >=3.10. It leverages a causal transformer trained on continuous speech representations, enabling expressive and cloned voice outputs without discrete tokens. The library is under active development by OpenBMB.","status":"active","version":"2.0.2","language":"python","source_language":"en","source_url":"https://github.com/OpenBMB/VoxCPM.git","tags":["text-to-speech","voice-cloning","deep-learning","tokenizer-free"],"install":[{"cmd":"pip install voxcpm","lang":"bash","label":"Install from PyPI"},{"cmd":"pip install git+https://github.com/OpenBMB/VoxCPM.git","lang":"bash","label":"Install from GitHub"}],"dependencies":[{"reason":"Required for model inference","package":"torch","optional":false},{"reason":"Audio file I/O","package":"soundfile","optional":false},{"reason":"Audio processing","package":"librosa","optional":false},{"reason":"For model architecture (optional if using custom pipeline)","package":"transformers","optional":true}],"imports":[{"note":"Importing the module directly does not expose the class; use the correct submodule import.","wrong":"import voxcpm","symbol":"VoxCPM","correct":"from voxcpm import VoxCPM"}],"quickstart":{"code":"from voxcpm import VoxCPM\nimport soundfile as sf\n\nmodel = VoxCPM()\nwaveform, sr = model.synthesize(\"Hello, this is a test of voice cloning.\", voice_clone=\"path/to/ref_audio.wav\")\nsf.write(\"output.wav\", waveform, sr)","lang":"python","description":"Load the VoxCPM model, generate speech with optional voice cloning from a reference audio file, and save the output."},"warnings":[{"fix":"Ensure you provide a file path string to `voice_clone`.","message":"The `voice_clone` parameter expects a file path to a WAV file. Passing a numpy array or audio buffer will raise a TypeError.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Reduce batch size or use smaller model variants if available.","message":"The model requires significant GPU memory. On a 16GB GPU, batch inference may cause OOM errors.","severity":"gotcha","affected_versions":"all"},{"fix":"Specify `model_path='default'` or a custom path to future-proof your code.","message":"The `voxcpm.VoxCPM` initialization without explicit `model_path` argument downloads the default model, which is deprecated in favor of explicit model selection.","severity":"deprecated","affected_versions":">=2.0.0"}],"env_vars":null,"search_vec":"'2.0.2':24 '3.10':27 'activ':51 'awar':17 'causal':31 'clone':22,41,61 'context':16 'context-awar':15 'continu':35 'deep':63 'deep-learn':62 'develop':52 'discret':45 'enabl':38 'express':39 'free':7,67 'generat':19 'learn':64 'leverag':29 'librari':48 'model':13 'openbmb':54 'output':43 'python':26 'represent':37 'requir':25 'speech':11,18,36,58 'text':9,56 'text-to-speech':8,55 'token':6,46,66 'tokenizer-fre':5,65 'train':33 'transform':32 'tts':12 'version':23 'voic':21,42,60 'voice-clon':59 'voxcpm':1,2 'without':44","created_at":"2026-05-09T05:55:33.313902+00:00","updated_at":"2026-05-09T05:55:33.313902+00:00","problems":[{"fix":"Reinstall the package and ensure a stable internet connection. Clear the cache: `rm -rf ~/.cache/voxcpm` and retry.","cause":"The underlying model download failed or was interrupted, leaving the model object as None.","error":"TypeError: 'NoneType' object is not callable"},{"fix":"Reduce batch size, use a smaller model (if available), or run on CPU by setting `device='cpu'`.","cause":"Insufficient GPU memory for the model or batch.","error":"RuntimeError: CUDA out of memory. Tried to allocate ... MiB"},{"fix":"Verify the file path and ensure it points to a valid WAV file.","cause":"The voice cloning reference file path is incorrect or the file does not exist.","error":"FileNotFoundError: [Errno 2] No such file or directory: 'path/to/ref_audio.wav'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/OpenBMB/VoxCPM","docs":"https://github.com/OpenBMB/VoxCPM#readme","changelog":null,"pypi":"https://pypi.org/project/voxcpm/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml","llm-agents"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}