Registry / llm-agents / livekit-plugins-hume

livekit-plugins-hume

library1.5.8pypypi✓ verified 84d ago

Hume AI TTS plugin for LiveKit Agents, enabling text-to-speech synthesis using Hume's emotional intelligence models. Current version 1.5.8, requires Python >=3.10. Part of the LiveKit Agents ecosystem with monthly releases.

llm-agents ai-ml communication

pip install livekit-plugins-hume

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · LIVEKIT-PLUGINS-HU

livekit-plugins-hume

llm-agentspythonv1.5.8

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TTS

✓ from livekit.plugins.hume import TTS

No common wrong import pattern

Initialize Hume TTS with API key and use with AgentSession.

import os from livekit import agents from livekit.plugins.hume import TTS async def main(): tts = TTS( api_key=os.environ.get('HUME_API_KEY', ''), ) # Use with AgentSession or VoicePipelineAgent session = agents.VoicePipelineAgent( stt=None, llm=None, tts=tts, ) await session.start()

Debug

Known issues

gotchaDeprecation notice: LiveKit Agents v1.5 removed `preemptive_generation: bool` from TTS classes. Use `agent/voice_pipeline_agent.PreemptiveGenerationOptions` instead.

fix

Migrate to `PreemptiveGenerationOptions` (see LiveKit agents v1.5 changelog).

affects: >=1.5.0

gotchaThe `api_key` parameter is no longer read from `HUME_API_KEY` environment variable automatically. You must pass it explicitly.

fix

Set `api_key=os.environ.get('HUME_API_KEY')` when constructing TTS.

affects: >=1.0.0

deprecatedOld import path `livekit.plugins.hume.tts` (lowercase) is deprecated. Use `livekit.plugins.hume.TTS` (uppercase).

fix

Use `from livekit.plugins.hume import TTS`.

affects: <1.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'livekit.plugins.hume'

Package not installed or installed incorrectly.

fix

Run `pip install livekit-plugins-hume`

TypeError: TTS() got an unexpected keyword argument 'preemptive_generation'

`preemptive_generation` removed in v1.5.0.

fix

Remove argument; use agent PreemptiveGenerationOptions.

livekit.plugins.hume.TTS requires 'HUME_API_KEY' environment variable

API key not provided and not set in environment.

fix

Set HUME_API_KEY environment variable or pass `api_key` parameter.

AttributeError: module 'livekit.plugins.hume' has no attribute 'tts'

Old import path lowercase 'tts' no longer exists.

fix

Use `from livekit.plugins.hume import TTS` (uppercase).

Upgrade

Version history

1.5.8latest on PyPI · released May 5, 2026

Audit

Dependencies

livekit-agentsrequiredCore LiveKit Agents SDK required for interaction

livekit-plugins-openaioptionalOften used together for STT/LLM in voice pipelines

Agent activity

26 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/livekit/agents ↗

packagehttps://pypi.org/project/livekit-plugins-hume/ ↗

homepagehttps://livekit.io/ ↗

docshttps://docs.livekit.io ↗