Chainlit
AI & LLMsBuild Conversational AI in minutes ⚡️
Release History
2.9.63 featuresThis release introduces several new UI features, including a Date Picker widget and controls for chat settings, alongside an option to skip chat confirmation.
2.9.51 fix2 featuresThis release introduces the ability to save favorite messages (prompt templates) and fetch steps from the data layer. It also includes a fix for how starters handle the selected mode.
2.9.4Breaking2 fixes3 featuresThis release introduces new features like thread sharing icons and auto-scroll disabling, alongside a critical database migration step for users utilizing persistence and a security fix.
2.9.36 fixes4 featuresThis release introduces native video support, language configuration options, and optimizes chat message rendering. It also includes several bug fixes, notably addressing page blinking after login and updating LangChain imports for v1.x compatibility.
2.9.21 fixThis release primarily focuses on adding new tests across various components like cache, translations, OAuth providers, chat context, and sockets. It also includes a fix for a copilot breaking change.
2.9.14 featuresThis release introduces several new features, including query param prefill for chat and markdown support in the watermark, alongside extensive additions of unit tests across various components.
2.9.01 featureThis release focuses on improving the Multi Agent Support within Chainlit.
2.8.51 fix3 featuresThis release introduces new features like raw OAuth responses and Slack event handling, alongside a minor security fix and removal of the FastAPI version constraint.
2.8.48 fixes2 featuresThis release introduces GitHub Enterprise support and an explicit disable option for the input widget, alongside numerous bug fixes addressing UI, data persistence, and translation issues.
2.8.31 featureThis release introduces support for the target attribute in header links and includes updates to the CI/CD publishing workflow. The @chainlit/react-client package has also been updated to version 0.3.0.
2.8.23 fixes1 featureThis release focuses on minor bug fixes, including ensuring on_chat_start fires reliably and fixing a Copilot hotkey conflict, alongside a UX improvement to disable autoFocus on mobile MessageComposer.
2.8.11 fix4 featuresThis patch release introduces new language translations (German and Korean) and adds support for custom meta URLs, alongside a fix for signed URL generation in the SQLAlchemy datalayer.
2.8.06 fixes5 featuresThis release introduces significant new input widget types (MultiSelect, RadioGroup, Checkbox) and adds Thread Sharing functionality. It also includes numerous bug fixes related to data persistence, configuration reloading, and internationalization.
2.7.22 fixes3 featuresThis release introduces dynamic configuration improvements, adds Traditional Chinese translations, and makes user environment persistence configurable. It also deprecates LiteralAI and optimizes optional dependency loading.
2.7.1.11 fixThis patch release primarily fixes an issue where frontend assets were not being included as artifacts.
2.7.1Breaking4 fixes5 featuresThis release introduces Slack Socket Mode, dynamic configuration for ChatProfiles, and rewrites the chat input for better command handling. It also reverts a breaking change related to custom authentication, requiring users to update their environment variables.
2.7.0Breaking3 fixes5 featuresThis release introduces Slack Socket Mode, dynamic configuration for ChatProfiles, and modernizes the chat input interface. It also updates the authentication secret environment variable used for custom login requirements.
2.6.93 fixes3 featuresThis release introduces new features like threadId for Slack feedback and a blinking cursor, alongside several bug fixes including resolving a gzip issue with Safari websockets.
2.6.81 fixThis release reverts a previous fix concerning the preservation of line breaks in received messages.
2.6.71 fixThis release primarily fixes an issue related to formatting when pasting HTML code and newlines in received messages. It also removes the unused `font_family` configuration setting.
2.6.6Breaking3 fixes4 featuresThis release introduces support for Slack emoji reactions, adds a language parameter to the Copilot widget, and fixes an issue where user-provided HTML was incorrectly rendered.
2.6.51 fix1 featureThis release introduces frontend gzip compression and fixes an issue with HTML escaping during pasting. Dependencies were also upgraded to address security vulnerabilities.
2.6.43 fixes4 featuresThis release introduces thread persistence for Copilot, a streamable HTTP client, and configuration options for expanded Copilot mode. It also includes several bug fixes related to serialization and UI indicators.
2.6.39 fixes4 featuresThis release introduces the ability to send empty commands and updates cookie path handling via environment variables. Several bug fixes address issues related to localization standards, markdown rendering, database interactions, and UI elements in Copilot.
2.6.21 fixThis is a technical patch release (2.6.2) correcting an issue where the previous wheel release was missing the 'copilot' and 'frontend' folders.
2.6.15 fixes2 featuresThis patch release introduces a new `on_feedback` callback and relaxes starter display limits. It also fixes several bugs related to command persistence, external API imports, and data layer stability, while removing telemetry.
2.6.012 fixes10 featuresThis release introduces several new configuration options for avatars, logos, and environment variables, alongside numerous UI and persistence bug fixes. It also includes updates to dependency management and CI configurations, such as adding Python 3.13 support.
2.5.51 fix10 featuresThis release introduces several new features including avatar/tooltip support, typed session accessors, and enhanced Copilot configuration. It also includes a fix for Google Cloud Storage private key formatting.
2.4.4004 fixes4 featuresThis release introduces several new customization features, including UI element IDs and sidebar state configuration, alongside fixes for UI flickering and pasting issues.
2.4.3021 featureThis release bumps the internal literalai version and introduces thinking token support for LangChain integrations. It also includes a minor localization file rename.
2.4.3011 fixThis release includes a minor bug fix addressing the mcp enable check. For detailed changes, refer to the full changelog.
2.4.32 fixes2 featuresThis release introduces a significant rework of the sidebar to enable canvas support and adds configuration options for the MCP server command allow list. Several bugs related to Plotly rendering and image persistence with Azure Blob Storage were also resolved.
2.4.2011 featureThis release introduces tags tracing support for the LangChain tracer and includes a new starter command implementation.
2.4.24 fixes4 featuresThis release introduces the Semantic Kernel Filter and adds new metadata support for customizing step avatars. Several bugs related to UI padding, chat history deletion, and database compatibility have also been resolved.
2.4.12 fixes2 featuresThis patch release introduces a new feature flag for auto-scrolling user messages and fixes several bugs related to scroll button visibility and FastAPI submounting.
2.4.03 fixes2 featuresThis release introduces support for MCP (Multi-Container Process) and includes several bug fixes related to copilot pasting, OAuth redirection, and ask display.
2.4.0rc01 featureThis release introduces MCP support, enhancing Chainlit's connectivity capabilities.
2.3.013 fixes3 featuresThis release introduces new features like command buttons and improved message placement, alongside numerous bug fixes addressing Docker paths, file uploads, data layer queries, and cookie handling.
2.2.15 fixes1 featureThis patch release introduces a new configuration option for steps and resolves several UI and data integrity bugs, including issues with input sanitization and component sizing.
2.2.02 fixes1 featureThis release introduces the ability to add custom links to the navigation header and includes fixes for step display using accordions and streaming auto-scrolling.
2.1.24 fixes1 featureThis release focuses on minor bug fixes, accessibility improvements, and enhances command filtering logic. The submit button behavior is improved when the input is empty.
2.1.13 fixesThis patch release focuses on bug fixes, including restoring URL location visibility after a UI refactor and correcting SAS token time settings. It also includes minor UI cleanup.
2.1.02 fixes4 featuresThis release introduces several new features including toast notifications, Markdown Alert support, theme selection, and custom CSS styling for copilot. Several bugs related to pasting and endpoint defaulting have also been resolved.
2.0.6031 fix1 featureThis release introduces refresh token support for the Azure AD OAuth provider and includes a fix for the CONTRIBUTING link.
2.0.6021 fixThis release primarily addresses a bug by implementing auto-focus for the chat input field.
2.0.6011 fixThis minor release primarily addresses a bug fix related to the sidebar's flex growth behavior.
2.0.63 fixes3 featuresThis release introduces source maps support and a generic OAuth provider, alongside several bug fixes including improvements to text handling and element creation. It also includes dependency updates and CI configuration changes.
2.0.55 fixes1 featureThis release focuses on bug fixes, including updates to file upload MIME types and JSX compatibility, alongside the addition of new translations for thread menu options.
2.0.49 fixes3 featuresThis release focuses on internationalization improvements, adding translation support for feedback and chat components, alongside numerous frontend and backend bug fixes, including UI scrolling and element rendering optimizations.
2.0.34 fixes1 featureThis release introduces translation support for the copy button and resolves several bugs related to thread initialization, element updates, and data layer operations. A critical dependency constraint for poetry-core was also updated.
2.0.26 fixes2 featuresThis release introduces HTML support for the Welcome Screen description and adds HTTP cookie tracking to session management. Several bug fixes address scrolling issues, thread resumption errors, and file message handling.
Common Errors
FileNotFoundError4 reportsFileNotFoundError in Chainlit often arises because the frontend build files are missing from the installed package or source code. To fix it, ensure you've run `chainlit build` in your project directory (if developing from source) or reinstall Chainlit with `pip install chainlit --upgrade` to obtain a complete package with the necessary frontend assets. If using a development install, make sure the frontend is built (`cd frontend && npm install && npm run build`) and linked in the main directory (`chainlit link`).
ModuleNotFoundError3 reportsA "ModuleNotFoundError" in Chainlit usually means a required Python package is missing from your environment. To fix this, identify the missing module from the error message (e.g., "google-cloud-storage") and install it using pip: `pip install <missing_module>`. If you are using Langchain, ensure all necessary integration packages (like `langchain-openai`) are installed, and that they are compatible versions with Chainlit.
ChainlitContextException1 reportThe "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.
ConnectionRefusedError1 reportConnectionRefusedError in Chainlit usually means the frontend can't connect to the backend server, often due to the server not running or being blocked by a firewall. Ensure your Chainlit server is started correctly (e.g., using `chainlit run your_app.py`) and that no firewall rules are preventing connections to the server's port (typically 8000). Check the console output for any errors during server startup to diagnose further issues.
ParametersValidationException1 reportParametersValidationException in Chainlit often arises when the data types defined in your chainlit.ToolMessage parameters or cl.user_session are incompatible with the actual data being passed during runtime, or are missing required fields. Ensure that all data being passed to these functions adheres to the specified data types and that all required fields are present according to your Python type hints or Pydantic models. Validate incoming data and consider using try-except blocks to gracefully handle potential type mismatches, providing informative error messages when validation fails.
InvalidRequestError1 reportInvalidRequestError in Chainlit often arises from conflicts or inconsistencies during database operations, especially when using SQLAlchemy. This can happen when metadata definitions in your SQLAlchemy declarative base clash with existing database structures or Chainlit's internal schema. Resolve this by carefully reviewing and aligning your SQLAlchemy model definitions, ensuring they don't redefine or conflict with existing tables/metadata managed by Chainlit, and consider using a separate schema for your application's models if necessary.
Related AI & LLMs Packages
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.
Get up and running with OpenAI gpt-oss, DeepSeek-R1, Gemma 3 and other models.
🦜🔗 The platform for reliable agents.
The most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.
LLM inference in C/C++
GPT4All: Run Local LLMs on Any Device. Open-source and available for commercial use.
Subscribe to Updates
Get notified when new versions are released