176
stars
12
commits
4
repos using this model
2
linked in READMEs
Aug 13, 2026
updated
We're excited to introduce Nemotron-Labs-Audex-30B-A3B, a unified audio-text LLM built on Nemotron-Cascade-2-30B-A3B, a strong text-only MoE LLM with 30B MoE model with 3B activated parameters. Audex-30B-A3B extends the vocabulary for discrete audio tokens used for speech and general audio outputs, as well as an audio encoder for speech and general audio inputs. Audex-30B-A3B delivers strong abilities on audio tasks (audio understanding, speech recognition and translation, text-to-speech, audio generation, and speech-to-speech generation) while preserving very compelling reasoning, alignment, knowledge, long-context, and agentic capabilities of its text-only LLM backbone with marginal or no regression. Audex-30B-A3B operates in both thinking and instruct (non-thinking) modes.
Audex-30B-A3B follows the ChatML template and supports both thinking and instruct (non-thinking) modes. Reasoning content is enclosed within <think> and </think> tags. The instruct-mode prefix is task-specific. Prepend one of the following to the assistant's response, i.e. right after the assistant ChatML header:
| Task | Mode | Prefix | Note |
|---|---|---|---|
| Text | thinking | <think>\n | The model closes the trace with </think> and then answers. |
| Text | instruct (non-thinking) | </think>\n | |
| Audio | instruct (non-thinking) | <think></think> | No newline between </think> and the answer. |
Audex-30B-A3B supports up to a 1M-token context length.
Audex-30B-A3B follows Nemotron-Cascade-2 on text evaluation.
Audex-30B-A3B has different recommended inference setups per audio-related task as described below.
We use vLLM 0.20.0 container image: vllm/vllm-openai:v0.20.0-cu129
mamba-ssm and causal-conv1d. Build against your CUDA toolchain:python3 -m pip install transformers==5.14.0 safetensors==0.8.0
python3 -m pip install --no-build-isolation causal-conv1d==1.6.2.post1 mamba-ssm==2.3.1
Audio extras: vllm/vllm-openai:v0.20.0 image does not include audio codecs. This command installs audio-related packages: python3 -m pip install "vllm[audio]".
Audio QA includes audio understanding, speech recognition, and speech translation (see templates in Introduction).
LLM.generate and an OpenAI-compatible audio_url server.To prepare inputs, create a JSON file in the following format with the <sound>\n placeholder:
[
{
"id": "sample_0",
"sound": "/path/to/audio_0.wav",
"conversations": [
{"from": "human", "value": "<sound>\nDescribe the audio in detail."},
{"from": "gpt", "value": "N/A"}
]
},
{
"id": "sample_1",
"sound": "/path/to/audio_1.wav",
"conversations": [
{"from": "human", "value": "<sound>\n{prompt}"},
{"from": "gpt", "value": "N/A"}
]
},
...
]
To install environments:
python3 -m pip install "vllm[audio]" # audio input decoding; skip if your image already bundles it (see Environment)
pip install -e inference_scripts_vllm/audioqa_scripts --no-deps --no-build-isolation
python inference_scripts_vllm/audioqa_scripts/run_audioqa_vllm.py \
--model-path "$(pwd)/checkpoint_folder_full" \
--input-json ./inputs.json \
--output-jsonl ./audioqa_outputs/results.jsonl \
--tensor-parallel-size 8
bash inference_scripts_vllm/audioqa_scripts/serve_audioqa_vllm.sh "$(pwd)/checkpoint_folder_full" 8000
python inference_scripts_vllm/audioqa_scripts/client_audioqa.py --audio /path/to/audio.wav --prompt "Describe this audio."
bash inference_scripts_hf/inference_example.sh.Transcribe the speech in the input audio.\n<sound>; speech translation — a translation instruction such as Translate the speech in the input audio into English.\n<sound>.Audio generation includes text-to-speech and text-to-audio generation.
First, prepare vLLM inference using bash model_conversion_scripts/prepare_audiogen_vllm_checkpoint.sh (which only creates symlinks of safetensors under checkpoint_folder_audiogen).
Download XCodec1 (hf-audio/xcodec-hubert-general-balanced) via
hf download hf-audio/xcodec-hubert-general-balanced --local-dir /path/to/xcodec1
Prepare a folder /path/to/caption_txt_dir/ with all .txt files where each contains one caption. Run cd inference_scripts_vllm/audiogen_scripts/ and
set --tensor-parallel-size to the number of GPUs. Run
XCODEC1_PATH=/path/to/xcodec1 python3 run_audio_gen_vllm_rvq_logit_mask.py \
--task tta \
--model-path $(pwd)/../../checkpoint_folder_audiogen/ \
--dataset-path /path/to/caption_txt_dir/ \
--output-dir ../../tta_outputs/dataset_name/ \
--tensor-parallel-size 8 \
--temperature 1.0 \
--top-k 80 \
--max-tokens 2048 \
--cfg-scale 3.0 \
--cfg-pairs-per-batch 2
Finally (optional), apply the 48 kHz enhancement VAE to the generated waveforms; see enhancement_VAE/README.md.
we recommend using the standalone Audex causal speech decoder in audex_causal_speech_decoder (default).
./run_tts_vllm.sh --transcription "The weather is so good, and I want to enjoy the beautiful morning in the park." \
--output-dir ./tts_outputs --utt-id the_weather_is_so_good
Alternatively, users can download the original XCodec2 via this repo and decode the tokens after full generation; this has better quality but is not streaming.
The text reasoning follows Nemotron-Cascade-2-30B-A3B.
<think>\n prefix. Text instruct (non-thinking) mode uses </think>\n. See run_text_vllm_example.py which implements both (--disable-thinking selects instruct mode).chat_template.jinja uses <think></think> when enable_thinking=false which is used for audio tasks. To reproduce the reported text instruct-mode results, construct the prompt directly with </think>\n instead of relying on apply_chat_template.python model_conversion_scripts/convert_full_HF_to_textonly_HF.py to remove the audio-related vocabularies.cd inference_scripts_vllm/textonly_scripts/; python run_text_vllm_example.py --model-path $(pwd)/../../checkpoint_folder_textonly.sampling_params = SamplingParams(allowed_token_ids=list(range(131072))) in vLLM inference to mask the audio tokens, although we did not thoroughly test this approach.See inference_scripts_vllm/unified_s2s_scripts/README.md.
The benchmark numbers below use the following setups:
June 8, 2026
Your use of this model is governed by the NVIDIA Oneway Noncommercial License
@article{Nemotron-Labs-Audex,
title={Unified Audio Intelligence Without Regressing on Text Intelligence},
author={Kong, Zhifeng and Lee, Sang-gil and Kim, Jaehyeon and Wang, Boxin and Liu, Zihan and Kim, Sungwon and Chen, Yang and Goel, Arushi and Roy, Rajarshi and Dai, Wenliang and Yang, Zhuolin and Chen, Yangyi and Jiang, Dongfu and Ghosh, Sreyan and Rintamaki, Tuomas and Tao, Andrew and Raiman, Jonathan and Shoeybi, Mohammad and Catanzaro, Bryan and Ping, Wei},
year={2026}
}
12 commits
176
stars
12
commits
4
repos using this model
2
linked in READMEs
Aug 13, 2026
updated
We're excited to introduce Nemotron-Labs-Audex-30B-A3B, a unified audio-text LLM built on Nemotron-Cascade-2-30B-A3B, a strong text-only MoE LLM with 30B MoE model with 3B activated parameters. Audex-30B-A3B extends the vocabulary for discrete audio tokens used for speech and general audio outputs, as well as an audio encoder for speech and general audio inputs. Audex-30B-A3B delivers strong abilities on audio tasks (audio understanding, speech recognition and translation, text-to-speech, audio generation, and speech-to-speech generation) while preserving very compelling reasoning, alignment, knowledge, long-context, and agentic capabilities of its text-only LLM backbone with marginal or no regression. Audex-30B-A3B operates in both thinking and instruct (non-thinking) modes.
Audex-30B-A3B follows the ChatML template and supports both thinking and instruct (non-thinking) modes. Reasoning content is enclosed within <think> and </think> tags. The instruct-mode prefix is task-specific. Prepend one of the following to the assistant's response, i.e. right after the assistant ChatML header:
| Task | Mode | Prefix | Note |
|---|---|---|---|
| Text | thinking | <think>\n | The model closes the trace with </think> and then answers. |
| Text | instruct (non-thinking) | </think>\n | |
| Audio | instruct (non-thinking) | <think></think> | No newline between </think> and the answer. |
Audex-30B-A3B supports up to a 1M-token context length.
Audex-30B-A3B follows Nemotron-Cascade-2 on text evaluation.
Audex-30B-A3B has different recommended inference setups per audio-related task as described below.
We use vLLM 0.20.0 container image: vllm/vllm-openai:v0.20.0-cu129
mamba-ssm and causal-conv1d. Build against your CUDA toolchain:python3 -m pip install transformers==5.14.0 safetensors==0.8.0
python3 -m pip install --no-build-isolation causal-conv1d==1.6.2.post1 mamba-ssm==2.3.1
Audio extras: vllm/vllm-openai:v0.20.0 image does not include audio codecs. This command installs audio-related packages: python3 -m pip install "vllm[audio]".
Audio QA includes audio understanding, speech recognition, and speech translation (see templates in Introduction).
LLM.generate and an OpenAI-compatible audio_url server.To prepare inputs, create a JSON file in the following format with the <sound>\n placeholder:
[
{
"id": "sample_0",
"sound": "/path/to/audio_0.wav",
"conversations": [
{"from": "human", "value": "<sound>\nDescribe the audio in detail."},
{"from": "gpt", "value": "N/A"}
]
},
{
"id": "sample_1",
"sound": "/path/to/audio_1.wav",
"conversations": [
{"from": "human", "value": "<sound>\n{prompt}"},
{"from": "gpt", "value": "N/A"}
]
},
...
]
To install environments:
python3 -m pip install "vllm[audio]" # audio input decoding; skip if your image already bundles it (see Environment)
pip install -e inference_scripts_vllm/audioqa_scripts --no-deps --no-build-isolation
python inference_scripts_vllm/audioqa_scripts/run_audioqa_vllm.py \
--model-path "$(pwd)/checkpoint_folder_full" \
--input-json ./inputs.json \
--output-jsonl ./audioqa_outputs/results.jsonl \
--tensor-parallel-size 8
bash inference_scripts_vllm/audioqa_scripts/serve_audioqa_vllm.sh "$(pwd)/checkpoint_folder_full" 8000
python inference_scripts_vllm/audioqa_scripts/client_audioqa.py --audio /path/to/audio.wav --prompt "Describe this audio."
bash inference_scripts_hf/inference_example.sh.Transcribe the speech in the input audio.\n<sound>; speech translation — a translation instruction such as Translate the speech in the input audio into English.\n<sound>.Audio generation includes text-to-speech and text-to-audio generation.
First, prepare vLLM inference using bash model_conversion_scripts/prepare_audiogen_vllm_checkpoint.sh (which only creates symlinks of safetensors under checkpoint_folder_audiogen).
Download XCodec1 (hf-audio/xcodec-hubert-general-balanced) via
hf download hf-audio/xcodec-hubert-general-balanced --local-dir /path/to/xcodec1
Prepare a folder /path/to/caption_txt_dir/ with all .txt files where each contains one caption. Run cd inference_scripts_vllm/audiogen_scripts/ and
set --tensor-parallel-size to the number of GPUs. Run
XCODEC1_PATH=/path/to/xcodec1 python3 run_audio_gen_vllm_rvq_logit_mask.py \
--task tta \
--model-path $(pwd)/../../checkpoint_folder_audiogen/ \
--dataset-path /path/to/caption_txt_dir/ \
--output-dir ../../tta_outputs/dataset_name/ \
--tensor-parallel-size 8 \
--temperature 1.0 \
--top-k 80 \
--max-tokens 2048 \
--cfg-scale 3.0 \
--cfg-pairs-per-batch 2
Finally (optional), apply the 48 kHz enhancement VAE to the generated waveforms; see enhancement_VAE/README.md.
we recommend using the standalone Audex causal speech decoder in audex_causal_speech_decoder (default).
./run_tts_vllm.sh --transcription "The weather is so good, and I want to enjoy the beautiful morning in the park." \
--output-dir ./tts_outputs --utt-id the_weather_is_so_good
Alternatively, users can download the original XCodec2 via this repo and decode the tokens after full generation; this has better quality but is not streaming.
The text reasoning follows Nemotron-Cascade-2-30B-A3B.
<think>\n prefix. Text instruct (non-thinking) mode uses </think>\n. See run_text_vllm_example.py which implements both (--disable-thinking selects instruct mode).chat_template.jinja uses <think></think> when enable_thinking=false which is used for audio tasks. To reproduce the reported text instruct-mode results, construct the prompt directly with </think>\n instead of relying on apply_chat_template.python model_conversion_scripts/convert_full_HF_to_textonly_HF.py to remove the audio-related vocabularies.cd inference_scripts_vllm/textonly_scripts/; python run_text_vllm_example.py --model-path $(pwd)/../../checkpoint_folder_textonly.sampling_params = SamplingParams(allowed_token_ids=list(range(131072))) in vLLM inference to mask the audio tokens, although we did not thoroughly test this approach.See inference_scripts_vllm/unified_s2s_scripts/README.md.
The benchmark numbers below use the following setups:
June 8, 2026
Your use of this model is governed by the NVIDIA Oneway Noncommercial License
@article{Nemotron-Labs-Audex,
title={Unified Audio Intelligence Without Regressing on Text Intelligence},
author={Kong, Zhifeng and Lee, Sang-gil and Kim, Jaehyeon and Wang, Boxin and Liu, Zihan and Kim, Sungwon and Chen, Yang and Goel, Arushi and Roy, Rajarshi and Dai, Wenliang and Yang, Zhuolin and Chen, Yangyi and Jiang, Dongfu and Ghosh, Sreyan and Rintamaki, Tuomas and Tao, Andrew and Raiman, Jonathan and Shoeybi, Mohammad and Catanzaro, Bryan and Ping, Wei},
year={2026}
}
12 commits