Add CLI model management commands by Copilot · Pull Request #9 · MuoDoo/Vox.cpp

Copilot · 2026-06-24T03:22:51Z

Model setup and recovery were only discoverable through scripts and README instructions. This adds first-class vox model commands for listing, downloading, verifying, repairing, and removing local models.

CLI model lifecycle
- Adds vox model list [--installed]
- Adds vox model download <model-name>
- Adds vox model verify <model-name>
- Adds vox model repair <model-name>
- Adds vox model remove <model-name>
Model manifest and validation
- Tracks supported local model sets for Qwen3-ASR, Whisper base, HY-MT translation, and CosyVoice3 TTS.
- Reports model path, version, source, checksum availability, file size, and status.
- Detects missing, empty, and partial .part downloads.
Discoverability
- Exposes model management from vox --help.
- Updates missing-model errors to point at vox model download ....
- Documents the new workflow in the README.

Example:

vox model list
vox model download qwen3-asr-1.7b
vox model verify qwen3-asr-1.7b
vox model repair qwen3-asr-1.7b

Copilot

Pull request overview

This PR introduces first-class vox model subcommands to manage local model lifecycle (list/download/verify/repair/remove), centralizing model manifest metadata and status inspection, and updating documentation and tests to cover the new workflow.

Changes:

Added a vox_model_manager library implementing model manifest + status inspection and CLI subcommands.
Wired vox model ... routing into the main vox CLI and updated missing-model guidance to point at vox model download ....
Added README documentation and a new test covering verify/list/remove behavior.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
`apps/model_manager.h`	Declares model manifest/status types and the `run_model_command` entrypoint.
`apps/model_manager.cpp`	Implements supported model manifest, status inspection, and `vox model` command handling.
`apps/CMakeLists.txt`	Adds `vox_model_manager` static library and links it into the `vox` executable.
`apps/vox.cpp`	Routes `vox model ...` to the model manager; updates missing-model download hints.
`CMakeLists.txt`	Ensures the apps subdirectory is included so the model manager target exists for tests.
`README.md`	Documents the new model management CLI workflow and verification behavior.
`tests/model_manager_test.cpp`	Adds a focused test for model inspection and `vox model` subcommands.
`tests/CMakeLists.txt`	Builds and registers the new `vox_model_manager_test`.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

 add_subdirectory(llama_runtime)
 add_subdirectory(asr)
 add_subdirectory(translate)
 add_subdirectory(tts)
 add_subdirectory(pipeline)
-if(VOX_BUILD_APPS)
- add_subdirectory(apps)
-endif()
+add_subdirectory(apps)



+ for (const ManagedModel & model : supported_models()) {
+ const ManagedModelStatus status = inspect_model(model, project_root);
+ if (installed_only && !status.complete) {
+ continue;
+ }
+ out << model.name << "\t" << status_name(status) << "\t" << model.version << "\t";


+ const int result = std::system(model.download_command.c_str());
+ std::filesystem::current_path(previous, ec);
+ if (result != 0) {
+ err << "Download command failed for " << model.name << ".\n";
+ return 1;
+ }
+ return 0;
+}


+#include "model_manager.h"
+
+#include <filesystem>
+#include <fstream>
+#include <iostream>
+#include <sstream>
+
+namespace {
+
+bool expect(bool condition, const std::string & message) {
+ if (!condition) {
+ std::cerr << message << "\n";
+ return false;
+ }
+ return true;
+}
+
+} // namespace
+
+int main() {
+ namespace fs = std::filesystem;
+
+ bool ok = true;
+ const fs::path root = fs::temp_directory_path() / "vox_model_manager_test";


Copilot

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Copilot · 2026-06-24T08:36:20Z

+ out << "Downloading " << model->name << " using: " << model->download_command << "\n";
+ return run_download_command(*model, project_root, err);


After a successful download, the model is now re-inspected and a non-zero exit is returned with a clear message when it's still incomplete (410a13e).

Copilot

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

+ if (command == "repair") {
+ std::error_code ec;
+ const ManagedModelStatus status = inspect_model(*model, project_root);
+ for (size_t i = 0; i < model->files.size(); ++i) {
+ const std::filesystem::path path = status.files[i].path;
+ if (status.files[i].exists && !status.files[i].complete) {
+ std::filesystem::remove(path, ec);
+ if (ec) {
+ err << "Could not remove incomplete file " << path << ": " << ec.message() << "\n";
+ return 1;
+ }
+ out << "Removed incomplete file: " << path.string() << "\n";
+ }
+ std::filesystem::remove(path.string() + ".part", ec);
+ }
+ }


Copilot

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated no new comments.

CopilotAI assigned Copilot and MuoDoo Jun 24, 2026

Copilotstarted work on behalf of MuoDoo June 24, 2026 03:23 View session

CopilotAI changed the title ~~[WIP] Add model management commands for CLI~~Add CLI model management commandsJun 24, 2026

Copilotfinished work on behalf of MuoDoo June 24, 2026 03:40

CopilotAI requested a review from MuoDoo June 24, 2026 03:40

MuoDoo requested a review from Copilot June 24, 2026 06:59

Copilotstarted reviewing on behalf of MuoDoo June 24, 2026 06:59 View session

CopilotAI reviewed Jun 24, 2026
View reviewed changes

Copilotstarted work on behalf of MuoDoo June 24, 2026 07:37 View session

Copilotfinished work on behalf of MuoDoo June 24, 2026 07:44

MuoDoo requested a review from Copilot June 24, 2026 07:45

Copilotstarted reviewing on behalf of MuoDoo June 24, 2026 07:45 View session

CopilotAI reviewed Jun 24, 2026
View reviewed changes

Copilotstarted work on behalf of MuoDoo June 24, 2026 08:30 View session

Copilotfinished work on behalf of MuoDoo June 24, 2026 08:36

MuoDoo requested a review from Copilot June 24, 2026 09:00

Copilotstarted reviewing on behalf of MuoDoo June 24, 2026 09:00 View session

CopilotAI reviewed Jun 24, 2026
View reviewed changes

Copilotstarted work on behalf of MuoDoo June 24, 2026 10:47 View session

Copilotfinished work on behalf of MuoDoo June 24, 2026 10:49

MuoDoo requested a review from Copilot June 24, 2026 10:56

Copilotstarted reviewing on behalf of MuoDoo June 24, 2026 10:56 View session

CopilotAI reviewed Jun 24, 2026
View reviewed changes

CopilotAI added 6 commits July 3, 2026 22:53

Initial plan
8918f99

Add CLI model management commands
bf4caf3

Point missing model errors to CLI
675078e

Address model manager review feedback
8d39d86

Re-inspect model after download and drop unused include
6c32b25

Add repair command test coverage in model_manager_test
11f3bf6

Extend model manager for new TTS models
8afcc29

MuoDoo force-pushed the copilot/cli-model-management-commands branch from acc1aa6 to 8afcc29Compare July 3, 2026 15:01

MuoDoo marked this pull request as ready for review July 3, 2026 15:48

MuoDoo merged commit 43cdf7c into mainJul 3, 2026
4 checks passed

Navigation Menu

Add CLI model management commands - #9

Add CLI model management commands#9
MuoDoo merged 7 commits into
mainfrom
copilot/cli-model-management-commands

CopilotAI commented Jun 24, 2026•
edited
Loading

Uh oh!

CopilotAI left a comment

Uh oh!

Uh oh!

CopilotAI left a comment

Uh oh!

Uh oh!

CopilotAIJun 24, 2026

Uh oh!

CopilotAI left a comment

Uh oh!

CopilotAI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		out << "Downloading " << model->name << " using: " << model->download_command << "\n";
		return run_download_command(*model, project_root, err);

Conversation

CopilotAI commented Jun 24, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

CopilotAI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

CopilotAI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

CopilotAIJun 24, 2026

Choose a reason for hiding this comment

Uh oh!

CopilotAI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

CopilotAI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

CopilotAI commented Jun 24, 2026•
edited
Loading