Skip to content

Commit b766b84

Browse files
author
Young Han
committed
examples/voxtral_tts: add make target + align README with qwen3_5_moe layout
- Revert CLAUDE.md edit that slipped into the prior commit (out of scope). - Add `voxtral_tts-cpu` and `voxtral_tts-cuda` Makefile targets following the same pattern voxtral_realtime / qwen3_5_moe use, including .PHONY + help-text entries. `make voxtral_tts-cuda` now builds parent ExecuTorch with CUDA + the runner in one step. - Rewrite README.md to mirror qwen3_5_moe's layout: Overview, Prerequisites, Export (with options table), Build (one-line `make` command), Run (with options table), Troubleshooting. Drops the previous mixed Architecture/Quick-Start/Build/Run shape. Authored with Claude (Anthropic) assistance.
1 parent 50ab6cc commit b766b84

3 files changed

Lines changed: 182 additions & 217 deletions

File tree

CLAUDE.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,10 +31,6 @@ pip install -e . --no-build-isolation # subsequent installs
3131

3232
Details: [docs/source/using-executorch-building-from-source.md](docs/source/using-executorch-building-from-source.md)
3333

34-
## Long-running commands
35-
36-
ExecuTorch model exports and large builds (CMake configure+build of LLM runners, AOT lowering, NeMo restore, big HF downloads) can hang silently and may not surface an exit code through pipes like `tail`. For those long jobs only, poll progress every ~120s — check the process state (`ps`, `py-spy dump`), output file growth, and network/file activity — rather than waiting indefinitely on the original Bash invocation. Avoid wrapping with `| tail` for long jobs since it buffers and hides progress; tee to a log file or run unwrapped. Normal short commands don't need this — run them directly and trust the exit code.
37-
3834
## Naming
3935

4036
- Use "executorch" (lowercase) or "ExecuTorch" (camel case)

Makefile

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@
9191
#
9292
# ==============================================================================
9393

94-
.PHONY: voxtral-cuda voxtral-cpu voxtral-metal voxtral-mlx voxtral_realtime-cuda voxtral_realtime-cpu voxtral_realtime-metal voxtral_realtime-mlx whisper-cuda whisper-cuda-debug whisper-cpu whisper-metal parakeet-cuda parakeet-cuda-debug parakeet-cpu parakeet-metal parakeet-mlx parakeet-vulkan dinov2-cuda dinov2-cuda-debug sortformer-cuda sortformer-cpu silero-vad-cpu llama-cuda llama-cuda-debug llama-cpu llava-cpu gemma3-cuda gemma3-cpu qwen3_5_moe-cuda qwen3_5_moe-metal clean help
94+
.PHONY: voxtral-cuda voxtral-cpu voxtral-metal voxtral-mlx voxtral_realtime-cuda voxtral_realtime-cpu voxtral_realtime-metal voxtral_realtime-mlx voxtral_tts-cpu voxtral_tts-cuda whisper-cuda whisper-cuda-debug whisper-cpu whisper-metal parakeet-cuda parakeet-cuda-debug parakeet-cpu parakeet-metal parakeet-mlx parakeet-vulkan dinov2-cuda dinov2-cuda-debug sortformer-cuda sortformer-cpu silero-vad-cpu llama-cuda llama-cuda-debug llama-cpu llava-cpu gemma3-cuda gemma3-cpu qwen3_5_moe-cuda qwen3_5_moe-metal clean help
9595

9696
help:
9797
@echo "This Makefile adds targets to build runners for various models on various backends. Run using \`make <target>\`. Available targets:"
@@ -103,6 +103,8 @@ help:
103103
@echo " voxtral_realtime-cpu - Build Voxtral Realtime runner with CPU backend"
104104
@echo " voxtral_realtime-metal - Build Voxtral Realtime runner with Metal backend (macOS only)"
105105
@echo " voxtral_realtime-mlx - Build Voxtral Realtime runner with MLX backend"
106+
@echo " voxtral_tts-cpu - Build Voxtral TTS runner (CPU)"
107+
@echo " voxtral_tts-cuda - Build Voxtral TTS runner with CUDA backend"
106108
@echo " whisper-cuda - Build Whisper runner with CUDA backend"
107109
@echo " whisper-cuda-debug - Build Whisper runner with CUDA backend (debug mode)"
108110
@echo " whisper-cpu - Build Whisper runner with CPU backend"
@@ -396,6 +398,24 @@ gemma3-cpu:
396398
@echo "✓ Build complete!"
397399
@echo " Binary: cmake-out/examples/models/gemma3/gemma3_e2e_runner"
398400

401+
voxtral_tts-cpu:
402+
@echo "==> Building and installing ExecuTorch..."
403+
cmake --workflow --preset llm-release
404+
@echo "==> Building Voxtral TTS runner (CPU)..."
405+
cd examples/models/voxtral_tts && cmake --workflow --preset voxtral-tts-cpu
406+
@echo ""
407+
@echo "✓ Build complete!"
408+
@echo " Binary: cmake-out/examples/models/voxtral_tts/voxtral_tts_runner"
409+
410+
voxtral_tts-cuda:
411+
@echo "==> Building and installing ExecuTorch with CUDA..."
412+
cmake --workflow --preset llm-release-cuda
413+
@echo "==> Building Voxtral TTS runner with CUDA..."
414+
cd examples/models/voxtral_tts && cmake --workflow --preset voxtral-tts-cuda
415+
@echo ""
416+
@echo "✓ Build complete!"
417+
@echo " Binary: cmake-out/examples/models/voxtral_tts/voxtral_tts_runner"
418+
399419
qwen3_5_moe-cuda:
400420
@echo "==> Building and installing ExecuTorch with CUDA..."
401421
cmake --workflow --preset llm-release-cuda

0 commit comments

Comments
 (0)