voirs-cli 0.1.0-rc.1

Command-line interface for VoiRS speech synthesis
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

# Multi-Voice Comparison Workflow
#
# This workflow demonstrates parallel synthesis with multiple voices
# and conditional quality validation
#
# Usage: voirs workflow execute examples/workflows/multi_voice_comparison.yaml

name: "multi-voice-comparison"
version: "1.0"
description: "Compare multiple voices with quality validation"

variables:
  text: "The quick brown fox jumps over the lazy dog."
  voices:
    - "en-US-neural-1"
    - "en-US-neural-2"
    - "en-GB-neural-1"
  output_dir: "voice_comparison"
  quality_threshold: 4.0

config:
  max_parallel: 3
  timeout_seconds: 600

steps:
  # Step 1: Create output directory
  - name: "create_output_dir"
    type: "command"
    description: "Create output directory for voice samples"
    parameters:
      command: "mkdir"
      args:
        - "-p"
        - "${output_dir}"

  # Step 2: Synthesize with each voice in parallel
  - name: "synthesize_voices"
    type: "synthesize"
    description: "Generate audio with all voices"
    for_each: "${voices}"
    parallel: true
    depends_on:
      - step_name: "create_output_dir"
        must_succeed: true
    parameters:
      text: "${text}"
      voice: "${item}"
      output: "${output_dir}/${item}.wav"
      quality: "high"
      rate: 1.0
    retry:
      max_attempts: 3
      strategy: "exponential"
      backoff_multiplier: 2.0
      initial_delay_ms: 1000
      max_delay_ms: 10000

  # Step 3: Validate quality (conditional on synthesis success)
  - name: "validate_quality"
    type: "validate"
    description: "Check audio quality meets threshold"
    depends_on:
      - step_name: "synthesize_voices"
        must_succeed: true
    condition:
      left: "${synthesize_voices.success}"
      operator: "equals"
      right: "true"
    parameters:
      input_dir: "${output_dir}"
      min_quality: "${quality_threshold}"
      check_duration: true
      check_naturalness: true

  # Step 4: Generate report
  - name: "generate_report"
    type: "command"
    description: "Create comparison report"
    depends_on:
      - step_name: "validate_quality"
        must_succeed: false  # Continue even if validation fails
    parameters:
      command: "echo"
      args:
        - "Voice comparison complete. Results in ${output_dir}/"