💬 Streamlit チャットUI ― 数行で組むチャット画面

対象バージョン v1.66 | 最終更新 2026-11-01 | 更新確認の目安:毎月

最新の実バージョンはプレイグラウンド(st.__version__ を表示)で常に確認できます。

このページでわかること

  • Streamlit ではチャットUI(吹き出し・入力欄・逐次表示)が数行で組めること
  • v1.59 で入った、生成中の停止ボタン(submit_mode)と画像の貼り付けの使い方
  • 各ウィジェットがどのバージョンから使えるか(Tierバッジで明記)
  • 同じチャットUIを React で組む場合との使い分け
  • 実際に触れるプレイグラウンドと、ui-memo の対応ページへの導線

ウィジェット一覧

チャットUIは st.chat_message(吹き出し)・st.chat_input(入力欄)・st.write_stream(逐次表示)の3つの組み合わせ。LLMアプリのフロントを、状態管理込みで十数行で作れるのが Streamlit の代表的な強み。導入バージョンの新しい順に紹介します。

返答の生成中に、st.chat_input の送信ボタンが停止ボタンに変わった状態

st.chat_input(submit_mode)

Tier A導入 v1.59〜新しめ

submit_mode="stop" にすると、送信後にスクリプトが動いているあいだは送信ボタンが停止ボタンに変わり、押すとその場で実行を止められる(入力欄はそのあいだ無効)。"disable" は実行中に入力欄を無効にするだけ、既定の "submit" は実行中も送信できる。LLM の長い返答を途中で止めたいときに。v1.59 で追加。

python
prompt = st.chat_input("メッセージを入力", submit_mode="stop")
if prompt:
    with st.chat_message("assistant"):
        st.write_stream(generate(prompt))  # 生成中は送信ボタンが停止ボタンに

Reactとの比較:React では AbortController でリクエストを中断し、送信/停止ボタンの表示を状態で切り替える実装が要る。Streamlit は引数1つで、停止までが標準の挙動になる。

チャットUIの実装比較を見る →
st.chat_input に画像を貼り付けて添付した状態

st.chat_input(ファイルの貼り付け)

Tier A導入 v1.59〜新しめ

accept_file(v1.43〜)を付けた入力欄に、画像などのファイルを貼り付けて添付できるようになった(v1.59)。左の+ボタンからの添付と同じく、戻り値は text と files を持つオブジェクトになる。file_type で受け付ける種類を絞れる。

python
msg = st.chat_input(
    "メッセージを入力",
    accept_file=True,          # v1.43〜。v1.59 から貼り付けでも添付できる
    file_type=["png", "jpg"],
)
if msg:
    st.write(msg.text)         # 入力した文字
    for f in msg.files:        # 添付したファイル
        st.image(f)

Reactとの比較:React では paste イベントの clipboardData からファイルを取り出し、プレビューと送信を自前で組む。Streamlit は accept_file を付けるだけで、ボタンからの添付と貼り付けの両方に対応する。

チャットUIの実装比較を見る →
st.write_stream で逐次表示されたアシスタントの返答

st.write_stream

Tier B導入 v1.31〜

ジェネレータやストリームを1文字ずつ/1チャンクずつ逐次表示する。LLMのトークンストリーミングをそのまま流し込める。表示後は通常のテキストとして残る。v1.31 で追加。

python
with st.chat_message("assistant"):
    st.write_stream(stream)   # generator / iterator を渡す

Reactとの比較:React では SSE/ストリームを受けて state を更新しながら描画する実装が要る。Streamlit はジェネレータを渡すだけで逐次表示になる。

チャットUIの実装比較を見る →
st.chat_message のユーザー/アシスタントの吹き出し

st.chat_message

Tier B導入 v1.24〜

ロール("user" / "assistant")ごとにアイコン付きの吹き出しを描くコンテキストマネージャ。中に st.write や表・グラフも入れられる。会話履歴をループで描けば対話画面になる。

python
for msg in st.session_state.history:
    with st.chat_message(msg["role"]):
        st.write(msg["content"])

Reactとの比較:React では吹き出しコンポーネント・ロール別スタイル・スクロール管理を自前で組む。Streamlit は with ブロックで完結する。

チャットUIの実装比較を見る →
st.chat_input の入力欄

st.chat_input

Tier B導入 v1.24〜

チャット用の入力欄。トップレベルに置くと画面下部に固定され、送信すると入力文字列が返る。:=(ウォルラス演算子)で受けて処理するのが定番。

python
if prompt := st.chat_input("メッセージを入力"):
    st.session_state.history.append({"role": "user", "content": prompt})

Reactとの比較:React では input/フォーム・送信制御・下部固定レイアウトを自前で。Streamlit は1行で送信付き入力欄になる。

チャットUIの実装比較を見る →

Reactでやるなら(使い分けまとめ)

チャットUIは、Streamlit の手軽さが効く代表例。吹き出し・入力欄・逐次表示が標準で揃い、LLMアプリの試作やデモ、社内向けのチャットツールを十数行で立ち上げられる。

一方、エンドユーザー向けの本番チャット製品で、デザイン・モバイル最適化・認証・履歴の永続化・大量同時接続まで作り込むなら、React/Next.js 側の自由度とスケールが要る。

目安は、試作・社内・デモなら Streamlit、公開する本番チャット製品なら React(公開Webが求めるSEO・デザイン制御・大量アクセスに Streamlit は構造的に弱く、逆に開発の速さで強いため)。Streamlit と React/Next.js の違いは Streamlit UI ガイド(総括) で詳しく解説。

この分野の深掘りは ui-memo のチャットUI比較ページへ。

※トレードオフ(参考):Streamlit のチャットは組むのが速い反面、吹き出しの細かな見た目・モバイルの作り込み・大規模運用は限定的。React は自由度と本番適性が高い反面、同じ画面を出すまでの実装量は多い。

AIプロンプトテンプレ

Streamlit でチャットUIを作るときの、AIへの指示テンプレ。

最小のチャットUI

text
Streamlit で、st.chat_message と st.chat_input を使った最小のチャットUIを書いて。
会話履歴は st.session_state に持たせて、送信ごとに履歴を表示して。

ストリーミング返答

text
Streamlit のチャットで、アシスタントの返答を st.write_stream で1文字ずつ逐次表示して。
返答はジェネレータで返す形にして。

履歴のクリア

text
Streamlit のチャットに「会話をクリア」ボタンを付けて、
押すと st.session_state の履歴を空にして再描画する実装にして。

生成中の停止ボタン

text
Streamlit のチャットで、st.chat_input に submit_mode="stop" を付けて、
アシスタントの返答(st.write_stream)の生成中に停止ボタンで止められるようにして。
止めた時点までの返答は会話履歴に残して。

▶ 実際に触ってみる ― チャット(プレイグラウンド)

本物の Streamlit がブラウザで動く。入力すると逐次表示で返答が出る。

よくある質問

Streamlit だけで LLM チャットアプリは作れますか?

UI部分(吹き出し・入力・逐次表示)は標準ウィジェットだけで作れます。LLMのAPI呼び出しを足せば、チャットアプリのフロントが十数行で完成します。

会話履歴はどう保持しますか?

st.session_state にリストで持たせ、再実行のたびにループで描画します。永続化したい場合は別途データベース等に保存します。

st.write_stream には何を渡せますか?

ジェネレータやイテレータ(文字列を順に yield するもの)を渡します。LLM SDK のストリーミング応答をそのまま渡すと、トークンが届くたびに表示されます。

chat_input が画面下部に固定されるのを変えられますか?

トップレベルに置くと下部固定になります。st.container などレイアウトコンテナの中に置くとインライン表示になります。