Skip to content

WhisperKitPro: match whisperkitpro-cli 3.x flags and expose Sortformer model options - #103

Merged
EduardoPach merged 2 commits into
mainfrom
eduardo/wkp-cli-3x-sortformer-options
Sep 22, 2026
Merged

EduardoPach merged 2 commits into
mainfrom
eduardo/wkp-cli-3x-sortformer-options

Conversation

@EduardoPach

@EduardoPach EduardoPach commented Sep 21, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

whisperkitpro-cli 3.x selects the diarizer with --diarizer and has no --engine or --fast-load flags, so orchestration runs with diarization failed with "Unknown option" on released CLI builds.

  • Emit --diarizer instead of --engine; stop emitting --fast-load (fast_load kept as a no-op for config compatibility)
  • Expose released Sortformer options: sortformer_model_version, sortformer_model_variant, speaker_models_path
  • Add unit tests for the generated CLI arguments

…r model options

whisperkitpro-cli 3.x selects the diarization backend with --diarizer and has
no --engine or --fast-load flags, so orchestration runs with diarization
enabled failed on released CLI builds with "Unknown option". Emit --diarizer
and stop emitting --fast-load (the `fast_load` field is kept as a documented
no-op so existing configs keep loading).

Expose the Sortformer options the CLI already supports:
`sortformer_model_version` and `sortformer_model_variant` on the engine and
orchestration configs, and `speaker_models_path` on the orchestration config.
All are optional and only emitted when set.

Also add unit tests for the generated CLI arguments.
@EduardoPach
EduardoPach force-pushed the eduardo/wkp-cli-3x-sortformer-options branch from 61e3a9a to 255fe8c Compare September 21, 2026 20:35
)
sortformer_model_version: str | None = Field(
None,
description="Sortformer model version (e.g. `v2-1` or `v3-preview`). Only applicable when `engine` is `sortformer`.",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We selected nemotron-3-diarization for the model version

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done in 510d48d: renamed to nemotron-3-diarization (and the variant to the published 684_74MB). Verified with a one-sample CallHome run through openbench-cli using the published model.

@arda-argmax arda-argmax left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We just need to rename the model version to nemotron-3-diarization. The published model is available here: https://huggingface.co/argmaxinc/speakerkit-pro/tree/main/sortformer/nemotron-3-diarization

Aside from that, LGTM!

)
sortformer_model_version: str | None = Field(
None,
description="Sortformer model version (e.g. `v2-1` or `v3-preview`). Only applicable when `engine` is `sortformer`.",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ditto: model name

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done in 510d48d: renamed to nemotron-3-diarization (and the variant to the published 684_74MB). Verified with a one-sample CallHome run through openbench-cli using the published model.

@arda-argmax
arda-argmax self-requested a review September 22, 2026 03:07
The Sortformer v3 model was published as `nemotron-3-diarization` with the
`684_74MB` variant, so use those names in the field descriptions and tests
instead of the local preview names.
@EduardoPach
EduardoPach merged commit 1067757 into main Sep 22, 2026
2 checks passed
@EduardoPach
EduardoPach deleted the eduardo/wkp-cli-3x-sortformer-options branch September 22, 2026 17:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants