Quickstart

npm install -g @humeai-clihume login# Use the browser to login to platform.hume.ai to retrieve your# API keyshume tts"Are you serious?" --description"whispered, hushed"hume voices create --name whisperer --lasthume tts"I said, are you serious?" --voice-name whispererhume voices list# View your saved voiceshume voices list --provider HUME_AI# View Hume's voice libraryhume voices delete --name whisperer# Delete a voice when no longer needed

Installation

npm install -g @humeai/cli

Usage

Text to speech━━━ Usage ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$ hume tts <text>━━━ Options ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━-d,--description #0 Description of the desired voice-c,--continue,--context-generation-id #0 Previous generation ID for continuation-l,--last,--continue-from-last Use a generation from a previous synthesis as context. If the last synthesis was created with --num-generations > 1, you must also provide --last-index--last-index #0 Index of the generation to use from the previous synthesis.-o,--output-dir #0 Output directory for generated audio files-n,--num-generations #0 Number of variations to generate-p,--prefix #0 Filename prefix for generated audio--play #0 Play audio after generation: all variations, just the first, or none--play-command #0 Command to play audio files (uses $AUDIO_FILE as placeholder for file path)--api-key #0 Override the default API key--format #0 Output audio format-v,--voice-name #0 Name of a previously saved voice--voice-id #0 Direct voice ID to use--json Output in JSON format--pretty Output in human-readable format--base-url #0 Override the default API base URL (for testing purposes)--provider #0 Voice provider type (CUSTOM_VOICE or HUME_AI)--speed #0 Speaking speed multiplier (0.25-3.0, default is 1.0)--trailing-silence #0 Seconds of silence to add at the end (0.0-5.0, default is 0.35)--streaming Use streaming mode for TTS generation (default: true)--instant-mode Enable ultra-low latency mode for significantly faster generation (requires streaming=true, a voice, and incurs 10% higher cost)--curl Generate curl command instead of making the API request━━━ Details ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━This command converts text to speech using Hume AI's advanced AI voicesynthesis. You can specify voice characteristics through descriptions or usesaved voices.━━━ Examples ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━Basic usage$ hume tts "Make sure to like and subscribe!" --description "The speaker is a charismatic, enthusiastic, male YouTuber in his 20s with a American accent, a slightly breathy voice, and a fast speaking rate."Saving a voice you like (see `hume voices create --help`)$ hume voices create --name influencer_1 --lastUsing a previously-saved voice$ hume tts "Thanks for the 100,000,000,000 likes guys!" -v influencer_1Using a voice from the Hume Voice Library$ hume tts "Hello there" -v narrator --provider HUME_AIReading from stdin$ echo "I wouldn't be here without you" | hume tts - -v influencer_1Continuing previous text$ hume tts "Take some arrows from the quiver" -v influencer_1$ hume tts "Take a bow, too" -v influencer_1 --last # should rhyme with 'toe' not 'cow'Using custom audio player (macOS/Linux)$ hume tts "Hello world" -v narrator --play-command "mpv $AUDIO_FILE --no-video"Using custom audio player (Windows)$ hume tts "Hello world" -v narrator --play-command "powershell -c \"[System.Media.SoundPlayer]::new('$AUDIO_FILE').PlaySync()\""Setting a custom audio player for the session$ hume session set tts.playCommand "vlc $AUDIO_FILE --play-and-exit"Adjusting speech speed$ hume tts "I am speaking very slowly" -v narrator --speed 0.75Adding trailing silence$ hume tts "Wait for it..." -v narrator --trailing-silence 3.5Using instant mode for ultra-low latency$ hume tts "Hello world" -v narrator --instant-modeSetting instant mode in your config (always enable)$ hume config set tts.instantMode trueGenerating curl command instead of making API request$ hume tts "Hello world" -v narrator --curl## Voice ManagementSave a voice from a previous generation$ hume voices create --name my-narrator --lastCreate a voice from a specific generation ID$ hume voices create --name my-narrator --generation-id abc123### Listing VoicesList your custom voices$ hume voices listList voices from the Hume Voice Library$ hume voices list --provider HUME_AI### Deleting VoicesDelete a voice by name$ hume voices delete --name my-narrator━━━ See also ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━- `hume voices create --help` - Save a voice for later use- `hume voices list --help` - List available voices- `hume voices delete --help` - Delete a saved voice- `hume session --help` - Save settings temporarily so you don't have to repeat yourself- `hume config --help` - Save settings more permanently