Change8
Error1 reports

Fix ChainlitContextException

in Chainlit

Solution

The "ChainlitContextException: Chainlit context not found" error usually occurs when trying to access Chainlit-specific functionalities (like `cl.user_session` or `cl.context`) outside of a Chainlit decorated function (e.g., `cl.on_message`, `cl.on_chat_start`). Ensure that all code accessing Chainlit's context is executed within a function decorated with a Chainlit event handler like `@cl.on_message` or `@cl.on_chat_start` to properly initialize the context. Otherwise you will get the error.

Related Issues

Real GitHub issues where developers encountered this error:

Timeline

First reported:Aug 20, 2025
Last reported:Aug 20, 2025

Need More Help?

View the full changelog and migration guides for Chainlit

View Chainlit Changelog