Skip to main content

Updating Chainlit

Begin the migration by updating Chainlit to the latest version:
pip install --upgrade chainlit

What changes?

Chainlit 2.9.4 introduces Modes — a multi-picker system that lets users configure categories like model, reasoning effort, or persona per message. The selected modes are persisted alongside each message in a new modes column in the steps table. Full changelog available here.

How to migrate?

1. Update the database schema

A new modes column must be added to the steps table so that selected modes can be persisted with each message.
The Official data layer Prisma schema has not been updated to include this column. Run the following migration manually against your database:
ALTER TABLE "Step" ADD COLUMN IF NOT EXISTS "modes" JSONB;
DynamoDB users do not need to run any migration — the schema is dynamic.