TypeError when running livekit.agents with release candidate 1.0.0rc5

[niqodea]

I am encountering a TypeError when trying to use version 1.0.0rc5 of livekit-agents. These are the steps to reproduce:

1. Create a Python virtual environment
2. Install the livekit-agents release candidate package with pip
3. Run python -m livekit.agents.__init__

The following error occurs:

TypeError: typing.Optional requires a single type. Got <google.protobuf.internal.enum_type_wrapper.EnumTypeWrapper object at 0x7f98526007f0>.

Environment:

• Python version: 3.10.16
• OS: Debian GNU/Linux 11 (bullseye)

[tscdl]

I am new to Python. Experiencing something similar with 1.0.0rc4 as linked from the webpages docs.

TypeError: typing.Optional requires a single type. Got <google.protobuf.internal.enum_type_wrapper.EnumTypeWrapper object at 0x106acc2e0>.

They say:
"LiveKit Agents requires Python 3.9 or later."
https://docs.livekit.io/agents/v1/start/voice-ai/

Is that part of the problem?
It did not seem to be for me, at least I tried a fresh install with Python 3.9.4 in the venv.

[longcw]

Do you have a full error log?

[tscdl]

I did stumble upon a thread in Slack, that seemed related. Again Python newbie here.

https://livekit-users.slack.com/archives/C07FY8WHGPM/p1743697910579179?thread_ts=1743628708.330239&cid=C07FY8WHGPM

CWilson helped and it turns out, the Python version is critical. 3.9.4 did not work for me. Even though I might have made different mistakes.

livekit==1.0.1
livekit-agents==1.0.0rc5
livekit-api==1.0.1
livekit-plugins-cartesia==1.0.0rc5
livekit-plugins-deepgram==1.0.0rc5
livekit-plugins-noise-cancellation==0.2.1
livekit-plugins-openai==1.0.0rc5
livekit-plugins-silero==1.0.0rc5
livekit-plugins-turn-detector==1.0.0rc5
livekit-protocol==1.0.1
pydantic==2.11.2
pydantic_core==2.33.1
torch==2.6.0
torchaudio==2.6.0
torchvision==0.21.0

Python 3.13.2 currently does work for me. Problem disappeared.

[niqodea]

I tried upgrading to Python 3.12 like @tscdl suggested and it seems to fix the issue. Initially, I got an error about pydantic missing, but after installing it, I was able to run python -m livekit.agents.__init__ without any problems. Would be nice to have a fix for Python 3.10 as well!

@longcw here is the entire stacktrace:

Traceback (most recent call last):
  File "/home/niqodea/.venv/lib/python3.10/runpy.py", line 187, in _run_module_as_main
    mod_name, mod_spec, code = _get_module_details(mod_name, _Error)
  File "/home/niqodea/.venv/lib/python3.10/runpy.py", line 146, in _get_module_details
    return _get_module_details(pkg_main_name, error)
  File "/home/niqodea/.venv/lib/python3.10/runpy.py", line 110, in _get_module_details
    __import__(pkg_name)
  File "/home/niqodea/.venv/lib/python3.10/site-packages/livekit/agents/__init__.py", line 15, in <module>
    from . import cli, ipc, llm, metrics, stt, tokenize, tts, utils, vad  # noqa: F401
  File "/home/niqodea/.venv/lib/python3.10/site-packages/livekit/agents/cli/__init__.py", line 1, in <module>
    from .cli import run_app
  File "/home/niqodea/.venv/lib/python3.10/site-packages/livekit/agents/cli/cli.py", line 15, in <module>
    from ..worker import JobExecutorType, Worker, WorkerOptions
  File "/home/niqodea/.venv/lib/python3.10/site-packages/livekit/agents/worker.py", line 39, in <module>
    from livekit import api, rtc
  File "/home/niqodea/.venv/lib/python3.10/site-packages/livekit/api/__init__.py", line 38, in <module>
    from .livekit_api import LiveKitAPI
  File "/home/niqodea/.venv/lib/python3.10/site-packages/livekit/api/livekit_api.py", line 6, in <module>
    from .sip_service import SipService
  File "/home/niqodea/.venv/lib/python3.10/site-packages/livekit/api/sip_service.py", line 40, in <module>
    class SipService(Service):
  File "/home/niqodea/.venv/lib/python3.10/site-packages/livekit/api/sip_service.py", line 188, in SipService
    transport: Optional[SIPTransport] = None,
  File "/home/niqodea/.venv/lib/python3.10/typing.py", line 312, in inner
    return func(*args, **kwds)
  File "/home/niqodea/.venv/lib/python3.10/typing.py", line 403, in __getitem__
    return self._getitem(self, parameters)
  File "/home/niqodea/.venv/lib/python3.10/typing.py", line 529, in Optional
    arg = _type_check(parameters, f"{self} requires a single type.")
  File "/home/niqodea/.venv/lib/python3.10/typing.py", line 176, in _type_check
    raise TypeError(f"{msg} Got {arg!r:.100}.")
TypeError: typing.Optional requires a single type. Got <google.protobuf.internal.enum_type_wrapper.EnumTypeWrapper object at 0x7f98526007f0>.

If it can help, I am using miniconda to manage this environment.

[niqodea]

Seems to me like the Optional typing class is being used by livekit.api in a way that is not compatible with Python 3.10.

If that's the case, to help prevent similar issues in the future, would it make sense to specify a minimum supported Python version and ensure development happens in an environment matching that version?

[theomonnom]

Hey, I just pushed a fix here

It is already released, pip3 install livekit==1.0.2

Thanks for reporting this!

[tscdl]

Hi, @theomonnom, thanks a lot. Python newbie – does it mean it will work with the latest Python version now? 3.9.4?

[theomonnom]

Yes, all python>=3.9 versions are supported