{"id":27926,"library":"livekit-plugins-hume","title":"LiveKit Plugins Hume","description":"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.","status":"active","version":"1.5.8","language":"python","source_language":"en","source_url":"https://github.com/livekit/agents","tags":["livekit","hume","tts","voice","agents"],"install":[{"cmd":"pip install livekit-plugins-hume","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core LiveKit Agents SDK required for interaction","package":"livekit-agents","optional":false},{"reason":"Often used together for STT/LLM in voice pipelines","package":"livekit-plugins-openai","optional":true}],"imports":[{"note":"No common wrong import pattern","symbol":"TTS","correct":"from livekit.plugins.hume import TTS"}],"quickstart":{"code":"import os\nfrom livekit import agents\nfrom livekit.plugins.hume import TTS\n\nasync def main():\n    tts = TTS(\n        api_key=os.environ.get('HUME_API_KEY', ''),\n    )\n    # Use with AgentSession or VoicePipelineAgent\n    session = agents.VoicePipelineAgent(\n        stt=None,\n        llm=None,\n        tts=tts,\n    )\n    await session.start()","lang":"python","description":"Initialize Hume TTS with API key and use with AgentSession."},"warnings":[{"fix":"Migrate to `PreemptiveGenerationOptions` (see LiveKit agents v1.5 changelog).","message":"Deprecation notice: LiveKit Agents v1.5 removed `preemptive_generation: bool` from TTS classes. Use `agent/voice_pipeline_agent.PreemptiveGenerationOptions` instead.","severity":"gotcha","affected_versions":">=1.5.0"},{"fix":"Set `api_key=os.environ.get('HUME_API_KEY')` when constructing TTS.","message":"The `api_key` parameter is no longer read from `HUME_API_KEY` environment variable automatically. You must pass it explicitly.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use `from livekit.plugins.hume import TTS`.","message":"Old import path `livekit.plugins.hume.tts` (lowercase) is deprecated. Use `livekit.plugins.hume.TTS` (uppercase).","severity":"deprecated","affected_versions":"<1.0.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run `pip install livekit-plugins-hume`","cause":"Package not installed or installed incorrectly.","error":"ModuleNotFoundError: No module named 'livekit.plugins.hume'"},{"fix":"Remove argument; use agent PreemptiveGenerationOptions.","cause":"`preemptive_generation` removed in v1.5.0.","error":"TypeError: TTS() got an unexpected keyword argument 'preemptive_generation'"},{"fix":"Set HUME_API_KEY environment variable or pass `api_key` parameter.","cause":"API key not provided and not set in environment.","error":"livekit.plugins.hume.TTS requires 'HUME_API_KEY' environment variable"},{"fix":"Use `from livekit.plugins.hume import TTS` (uppercase).","cause":"Old import path lowercase 'tts' no longer exists.","error":"AttributeError: module 'livekit.plugins.hume' has no attribute 'tts'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}