voice/__init__.py at master · autonet-code/voice · GitHub

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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
"""
Voice Module - Unified Text-to-Speech Interface

Supports both local (Piper) and cloud (ElevenLabs) TTS backends.

Quick Start:
    from voice import speak, speak_async

    # Speak with current backend (local by default)
    speak("Hello world")

    # Speak asynchronously
    speak_async("This won't block")

    # Use ElevenLabs
    speak("Natural voice", backend="elevenlabs")

    # Switch default backend
    from voice import set_backend
    set_backend("elevenlabs")

Configuration:
    # Via environment variables:
    ELEVENLABS_API_KEY=your-key
    ELEVENLABS_VOICE_ID=voice-id

    # Or programmatically:
    from voice import configure_elevenlabs
    configure_elevenlabs(api_key="your-key")
"""

from .voice import (
    # Main API
    speak,
    speak_async,
    say,
    say_async,
    announce,

    # Backend management
    get_backend,
    set_backend,
    is_backend_available,

    # Mute control
    is_muted,
    set_muted,
    mute,
    unmute,
    toggle_mute,

    # Sound effects
    play_beep,
    play_startup_chime,

    # Local TTS
    is_local_tts_available,

    # ElevenLabs
    elevenlabs_generate_to_file,
    configure_elevenlabs,

    # Status
    get_status,
)

from .config import (
    VOICES,
    MODELS,
    VOICE_PRESETS,
    PIPER_VOICES,
)

__version__ = "1.0.0"
__all__ = [
    # Main API
    "speak",
    "speak_async",
    "say",
    "say_async",
    "announce",

    # Backend management
    "get_backend",
    "set_backend",
    "is_backend_available",

    # Mute control
    "is_muted",
    "set_muted",
    "mute",
    "unmute",
    "toggle_mute",

    # Sound effects
    "play_beep",
    "play_startup_chime",

    # Local TTS
    "is_local_tts_available",

    # ElevenLabs
    "elevenlabs_generate_to_file",
    "configure_elevenlabs",

    # Status
    "get_status",

    # Config
    "VOICES",
    "MODELS",
    "VOICE_PRESETS",
    "PIPER_VOICES",
]