ImportError with 'livekit-plugins-aws[realtime]' on livekit cloud

[matt-maurer]

Hi,

I have worked for days on trying to fix this and didnt find anything related, so I hope you can help me here.

I want to use Amazon Nova Sonic in a Livekit Agent that I deploy to Livekit Cloud.

I always get:
ERROR:agent:UNHANDLED EXCEPTION: ImportError: The 'realtime' module requires optional dependencies. Please install them with: pip install 'livekit-plugins-aws[realtime]'

I have tried:

Included livekit-plugins-aws[realtime] in requirements.txt and from livekit.plugins import aws in my agent.py

Switched to using pyproject.toml to include livekit-plugins-aws[realtime]

How can I include the livekit-plugins-aws[realtime] plugin for an Agent deployed to Livekit Cloud?

Thank you in advance!

[davidzhao]

hey @matt-maurer, you'd want to include livekit-plugins-aws[realtime] in your pyproject.toml file if using uv, or requirements.txt file if using pip.

[matt-maurer]

Hi @davidzhao thank you, I did exactly that and it is not loaded by the agent in livekit cloud. openai and google work fine though.
Do you use aws realtime in agents hosted on livekit cloud and does it work for you?
Any idea what might block it?

[davidzhao]

nothing should block it afaik.

could you are the relevant files here so we can take a look?

[matt-maurer]

Sure, thank you David! here Livekit-project-files.zip are:
agent.py
pyproject.toml
requirements.txt

do you need more info?

[davidzhao]

do you have your Dockerfile as well?

[matt-maurer]

Yes:
Livekit-project-incl-Docker.zip

Also, if I run this after committing dependencies, as dev locally with the livekit playground, it works.
Only on livekit cloud where I want to use it productive, it doesnt.

[davidzhao]

I see the problem, the extra dependencies from AWS bedrock requires Python 3.12+. By default our dockerfile is building with Python 3.11. You can update the initial line in Docker file to:

ARG PYTHON_VERSION=3.13

[matt-maurer]

This resolved the issue, Thank you!