vocal_helper.cli_click module
Vocal Helper — click-based command-line interface.
Twin of vocal_helper.cli_argparse: same public surface (identical
subcommand names, identical flag semantics), but implemented with
click so users who already have a click-native shell setup
(bash / zsh completion via click.shell_completion, colored --help,
nested command groups) can plug it in without friction. Installed as
the vocal-helper-click entry point in pyproject.toml.
Design notes
Subcommands mirror
vocal-helper(the argparse twin) so both CLIs expose the same operations under symmetric, predictable names.Flags reuse the argparse names (
--whisper-model,--language,--diar-backend, …) rather than the more idiomatic click positional style — consistency across the two CLIs beats micro-idiomaticity.Async work is wrapped in
asyncio.run()inside each command; click itself stays sync.
Usage Example
>>> # vocal-helper-click mic --llm --jsonl
>>> # vocal-helper-click file meeting.wav --offline --language en
>>> # vocal-helper-click url "https://youtu.be/…" --language fr
>>> # vocal-helper-click transcribe clip.wav --language en