Chainlit を採用する前に読む、コミュニティ維持フェーズに入った Python チャット UI フレームワーク

Chainlit が埋めるのは「LLM のロジックは書けたが UI がない」という穴

Python で LLM アプリを書くとき、最初に詰まるのはモデル呼び出しではなく画面だ。FastAPI でエンドポイントを立て、WebSocket を張り、トークンを逐次描画し、ツール実行中の状態を表示する。この配線だけで数日が消える。Chainlit はこの層を引き受ける。README の説明は「Build python production-ready conversational AI applications in minutes, not weeks」であり、対象は Python で会話型アプリを作る開発者、とくに LangChain や LlamaIndex の上に何かを載せたい人だ。リポジトリの topics にも langchain、openai、llm が並んでおり、想定利用者が明確である。逆に、UI のデザインをゼロから作り込みたい人や、React 側で状態管理を完結させたい人には向かない。Chainlit が提供するのは完成品の画面ではなく、Python 側の関数を画面に接続する規約だからだ。

デコレータが画面イベントになる仕組み

README の demo.py がアーキテクチャのほぼ全体を示している。cl.on_message で修飾した async 関数は、ユーザーが UI に入力するたびに呼ばれる。引数は cl.Message で、戻り値は使わない。応答は cl.Message(content=...).send() を明示的に呼んで送る。この非対称性が重要で、フレームワークは戻り値を待たず、開発者が送信のタイミングを制御する。中間経過を先に流し、最終回答を後から送ることもできる。demo.py では cl.step(type="tool") で修飾した tool() を await し、その戻り値をそのまま cl.Message に詰めて送っている。つまりツール呼び出しの実行単位が UI 上のステップとして表現される。cl.sleep(2) はその待ち時間を再現するためのものだ。データの流れは、ブラウザの入力、Python のハンドラ、明示的な send、ブラウザの描画という一方向で、サーバ側に会話状態を保持する仕組みが前提になっている点は、ステートレスな HTTP API に慣れた人ほど戸惑う。

起動は2コマンド、開発版は Node と pnpm を要求する

導入は pip install chainlit の後に chainlit hello を実行する。README はこれでブラウザに hello app が開けば準備完了としている。自分のアプリは chainlit run demo.py -w で起動する。-w はファイル変更を監視して再読み込みするフラグで、開発中の反復に向く。設定ファイルのキーについて README は何も述べていないので、ここでは触れない。開発版を使いたい場合は pip install git+https://github.com/Chainlit/chainlit.git#subdirectory=backend/ を使う。このコマンドが backend/ サブディレクトリを指定している事実は、リポジトリがフロントエンドとバックエンドに分かれた構成であることを示す。README はこの方法に Node と pnpm が必要だと明記している。CI や Docker イメージに組み込むなら、Python の依存だけでは足りない。pip だけで完結する安定版と、Node ツールチェーンを要求する開発版は別物として扱うべきだ。

コミュニティ維持への移行が採用判断に与える影響

README 冒頭の Notice がこのプロジェクトの現在地を最も強く規定している。2025年5月1日付でオリジナルの Chainlit チームが活発な開発から撤退し、@Chainlit/chainlit-maintainers が Maintainer Agreement の下で維持している。メンテナの責務はコードレビュー、リリース、セキュリティと列挙され、Chainlit SAS は将来の更新について保証しないと明記されている。ここから読み取れるのは、機能追加の速度よりも既存機能の安定とセキュリティ修正に重心が移るという設計判断だ。リリース履歴もこれと整合する。2.11.0 が 2026-04-07、2.11.1 が 2026-04-22、2.12.0 が 2026-08-25 で、パッチとマイナーが中心である。ただし注意すべきは、この日付群が将来のリリース予定を示すものではないことだ。README はメンテナへの参加を Google フォームで募集しており、担い手が増えなければこのペースが維持される保証はない。採用検討時に見るべきは、機能のロードマップではなく、自分が踏むバグに誰が応答するかである。

Gradio や Streamlit との設計の違い

比較対象として自然なのは Gradio と Streamlit だ。どちらも Python だけで UI を作れるが、発想が違う。Streamlit はスクリプトを上から実行し直して画面を再構成するモデルで、ウィジェットの状態が再実行のたびに評価される。Chainlit はイベント駆動で、cl.on_message のようなハンドラが呼ばれたときにだけ処理が走り、開発者が send を呼んだ分だけ画面が更新される。会話の途中経過を段階的に見せたい用途ではこの差が効く。ツール実行中であることを示しながら最終回答を待たせる、といった表現は Chainlit の方が素直に書ける。一方で、フォーム入力と表形式の結果表示が中心のアプリなら Streamlit の再実行モデルの方が短く書ける。Gradio は入出力コンポーネントの組み合わせでインターフェースを定義する発想で、ChatInterface のような会話向けの抽象も持つ。Chainlit との差は、会話そのものを第一級の構造として扱うか、コンポーネントの一種として扱うかにある。

向かない場面と、確認できない部分

最も明確な限界は、README が将来の更新を保証していない点だ。数年単位の運用を前提とする基幹システムに、無保証のコミュニティ維持プロジェクトを組み込むのは筋が悪い。加えて README からは、認証、永続化、水平スケール時のセッション共有といった本番運用に必要な要素が読み取れない。ドキュメントサイト（docs.chainlit.io）へのリンクはあるが、その中身は与えられた材料に含まれていないため、ここで具体的な設定を断定はできない。もう一点、demo.py の例は単一プロセスの会話を前提にしている。複数ワーカーで動かしたときに会話状態がどう扱われるかは README からは分からない。本番導入を検討するなら、この点は自分でソースを読むか、backend/ の構成を確認する必要がある。UI の見た目を細かく制御したい場合も、フロントエンドが別ディレクトリに分かれている以上、Python 側のコードだけでは完結しない。

Apache-2.0 であることの実務的な意味

ライセンスは Apache-2.0 で、README もそのように記載している。permissive なライセンスなので、社内ツールに組み込む場合も、改変して配布する場合も、ソース公開の義務は課されない。特許条項が含まれる点は MIT との違いで、貢献者からの特許ライセンスが明示される。ただし Apache-2.0 は著作権表示とライセンス全文の同梱、変更を加えたファイルへの変更表示を求める。自社でフォークして backend/ を改変するなら、その旨を残す運用が必要になる。ここで注意したいのは、ライセンスが保証するのは法的な利用許諾であって、動作の保証ではないことだ。README の「Chainlit SAS provides no warranties on future updates」という一文は、ライセンス条項とは別に、プロジェクトとしての姿勢を明示している。法務判断はこの記事の範囲外であり、実際の適用は自組織の法務に確認してほしい。

導入を決める前に確認する3つのこと

第一に、直近リリース以降のコミット状況を自分の目で見る。2.12.0 が 2026-08-25、その前が 2.11.1 で 2026-04-22 であり、約4か月空いている。これがメンテナ体制の実力なのか一時的な間隔なのかは、リポジトリの履歴を見なければ判断できない。第二に、開発版を使う予定があるなら Node と pnpm が入ったビルド環境を用意できるか確認する。pip install chainlit だけで済むならこの問題は発生しない。第三に、会話状態の扱いを確認する。demo.py の例は単一プロセス前提であり、複数ワーカー構成での挙動は README に記述がない。社内ツールとして数か月動かす程度なら、chainlit run demo.py -w の延長で十分に足りる。逆に、認証や監査ログを要件に含むなら、Chainlit の上に自前で積む前提で見積もるべきだ。

編集部の結論

向いているのは、Python のロジックをほぼそのまま残したまま会話 UI を被せたい個人開発者と小規模チーム、そして社内ツールやデモとして数か月単位で使う用途だ。向かないのは、数年単位のサポート契約や SLA を前提にした業務システム、UI の細部を完全に制御したい製品だ。採用前に確認すべきは、README が明示するコミュニティ維持体制の下で直近リリース 2.12.0（2026-08-25）以降の更新頻度がどうなっているか、backend/ からの開発版インストールが Node と pnpm を要求する構成のままで自分の CI に乗るか、そして Apache-2.0 の下で自社改変分の扱いをどうするかの3点である。

公式情報源

1. Chainlit/chainlit on GitHub
2. License: Apache-2.0
3. Project website
4. README
5. Releases