Open-source AI podcast clipper. Generate vertical clips with face tracking and burned-in captions. CLI, MCP server, web app.
Python ai-toolsauto-captionscaptionscliffmpegmcpmcp-serveropusclip-alternativepodcast-clipspodcastsshortform-videovertical-videowhisper
Add `setup --speakers` to install diarization, with actionable messages (#23)
Nika Siradze35bbc8de03cc
diff --git a/backend/cli.py b/backend/cli.pyindex 56142dc..bc3710d 100644--- a/backend/cli.py+++ b/backend/cli.py@@ -2947,11 +2947,11 @@ def cmd_info(args):except (ImportError, ValueError):diarization_available = Falseif not diarization_available:- speakers_status = f"{yellow}✗ not available in this install (source install only)"+ speakers_status = f"{yellow}✗ not installed — run: podcli setup --speakers (pyannote + torch, ~2GB)"elif hf_token:speakers_status = f"{green}✓ configured"else:- speakers_status = f"{yellow}✗ set HF_TOKEN in .env"+ speakers_status = f"{yellow}✗ set a token — run: podcli env set HF_TOKEN <token>"print(f" AI CLI: {green}{('Claude' if ai_engine == 'claude' else 'Codex') + ' (' + ai_path + ')' if ai_path else f'{yellow}not found — install Claude Code or Codex'}{reset}")print(f" Speakers: {speakers_status}{reset}")@@ -3081,7 +3081,10 @@ def print_banner():print()if not speakers_ok:- print(f" {yellow}⚠ Speaker detection not set up — run: podcli info{reset}")+ if not _diarization_ok:+ print(f" {yellow}⚠ Speaker detection not installed — run: podcli setup --speakers{reset}")+ else:+ print(f" {yellow}⚠ Speaker detection needs a token — run: podcli env set HF_TOKEN <token>{reset}")print()diff --git a/backend/services/speaker_detection.py b/backend/services/speaker_detection.pyindex b7106e9..d610bba 100644--- a/backend/services/speaker_detection.py+++ b/backend/services/speaker_detection.py@@ -73,7 +73,7 @@ def run_diarization(try:from pyannote.audio import Pipelineexcept ImportError:- msg = "pyannote.audio not installed — run: pip install pyannote.audio"+ msg = "Speaker detection not installed — run: podcli setup --speakers"if progress_callback:progress_callback(0, msg)raise ImportError(msg)diff --git a/cli/internal/provision/provision.go b/cli/internal/provision/provision.goindex 1f238c3..b5628f6 100644--- a/cli/internal/provision/provision.go+++ b/cli/internal/provision/provision.go@@ -709,6 +709,21 @@ func pipInstall(pybin, requirements string) error {return cmd.Run()}+// EnsureSpeakerDeps installs the speaker-diarization stack (pyannote.audio pulls+// torch) into the hermetic Python. Opt-in because it's a large download (~2GB)+// most users don't need.+func EnsureSpeakerDeps() error {+ bin := PythonBin()+ if !have(bin) {+ return fmt.Errorf("python not provisioned — run `podcli setup` first")+ }+ fmt.Fprintln(os.Stderr, " installing speaker deps (pyannote.audio + torch) — large download (~2GB), several minutes")+ cmd := exec.Command(bin, "-m", "pip", "install", "--disable-pip-version-check", "--progress-bar=on", "pyannote.audio>=3.1.0", "speechbrain")+ cmd.Stdout, cmd.Stderr = os.Stderr, os.Stderr+ cmd.Env = append(os.Environ(), "PYTHONUNBUFFERED=1")+ return cmd.Run()+}+func extractTarGz(archive, dest string) error {f, err := os.Open(archive)if err != nil {diff --git a/cli/main.go b/cli/main.goindex 6d24257..1308444 100644--- a/cli/main.go+++ b/cli/main.go@@ -171,6 +171,7 @@ func transcribeEngine(args []string) string {func setup(args []string) int {size := "base"vad := false+ speakers := falsefor i := 0; i < len(args); i++ {switch args[i] {case "--model":@@ -180,6 +181,8 @@ func setup(args []string) int {}case "--vad":vad = true+ case "--speakers":+ speakers = true}}fmt.Printf("Provisioning into %s\n", paths.Home())@@ -217,6 +220,13 @@ func setup(args []string) int {fmt.Printf(" python: %s\n", pb)}}+ if speakers {+ if err := provision.EnsureSpeakerDeps(); err != nil {+ fmt.Fprintf(os.Stderr, " speakers: failed (%v)\n", err)+ return 1+ }+ fmt.Printf(" speakers: pyannote.audio installed (set HF_TOKEN to use)\n")+ }if wc, err := provision.EnsureWhisperCpp(); err != nil {fmt.Fprintf(os.Stderr, " whisper: skipped (%v) — backend will use PATH whisper-cli\n", err)} else {@@ -403,8 +413,8 @@ Launcher commands:doctor Show resolved paths, interpreter, backend, ffmpeg, modelsversion Print versionupdate Check for and apply a newer release- setup [--model base] [--vad]- Provision runtimes + models into the managed dir+ setup [--model base] [--vad] [--speakers]+ Provision runtimes + models (--speakers adds pyannote+torch, ~2GB)mcp Run the MCP server (stdio) for Claude/Codexmcp install Register the MCP server with Claude Codeconfig set update.auto off Disable auto-update (also: PODCLI_NO_UPDATE=1)