chat-demo — バックエンド不要で動くDeepSeek API公式チャットUI
deepseek-ai/chat-demo
★ 1,757 ・ TypeScript ・ MIT
概要
deepseek-ai/chat-demo は、DeepSeek API を直接ブラウザから利用するために公開された静的チャットクライアントです。一般的なチャット Web アプリケーションとは異なり、専用のバックエンドサーバーを用意する必要がありません。静的ファイル(HTML、JavaScript、CSS)として動作し、ブラウザから指定された API サービスへと直接 HTTPS/SSE で通信を行います。
公式のオンラインデモページにアクセスするか、ビルド済みの HTML ファイルをローカルで開いて API キーを入力するだけで、すぐにチャット環境を立ち上げることができます。独自サーバーの構築や運用の手間をかけずに DeepSeek API を試したい開発者や、フロントエンド完結型のチャット UI 実装を参考にしたいエンジニアに適しています。
主な特徴
README で紹介されている主な機能は以下の通りです。
- 柔軟な会話・履歴管理: 複数の会話セッションを作成でき、会話タイトルの自動生成、手動リネーム、削除が可能です。過去の送信プロンプトの編集や返答の再生成に対応するほか、メッセージの分岐を切り替える機能も備えています。
- 高度な出力機能と推論表示: ストリーミング返答、Deep Thinking(思考プロセス)の表示、スマート検索、Web リンクの読み込み、および情報ソースの引用に対応しています。生成の中断や、条件を満たす返答に対する続きの出力要求も行えます。
- 多彩な入力方式と音声機能: テキスト入力に加え、ファイルのアップロード、ペースト、ドラッグ&ドロップによる添付が可能です。さらに音声入力(ASR)や返答の読み上げ(TTS)に対応しており、モバイル環境での録音時には入力エリア上部にリアルタイムの音声スペクトラムが表示されます。
- リッチテキストと図表の描画: 通常の Markdown 記述に加えて、コードのシンタックスハイライト、KaTeX による数式表示、Mermaid によるダイアグラム表示をサポートしています。
- ローカルデータ管理とカスタマイズ: 簡体字中国語と英語の切り替え、ライトモードとダークモードの切り替え、モバイル向けレスポンシブ表示に対応しています。また、会話履歴全体の ZIP 形式によるエクスポートおよびインポート機能が提供されています。
使い方
すぐに試す場合
最も手軽な方法は、GitHub Pages でホストされている オンラインデモ をブラウザで開くことです。また、GitHub の Releases からアーカイブをダウンロードして展開し、同梱の index.html をダブルクリックしてローカルで開くだけでも利用可能です。どちらの場合も、チャットを開始する前に設定(Settings)画面で自身の API キーを入力します。
ソースコードからビルド・開発する場合
ローカルでソースコードを動かすには、Node.js 22.12 以上と pnpm が必要です。リポジトリをクローンして依存関係をインストールし、開発サーバーを起動します。
git clone https://github.com/deepseek-ai/chat-demo.git
cd chat-demo
pnpm install
pnpm dev
起動後、ブラウザで http://localhost:8090 にアクセスします。
本番向けの静的ファイルを生成する場合は、ビルドコマンドを実行します。
pnpm build
ビルド生成物は dist/ ディレクトリに出力されます。このディレクトリの内容を任意の静的ウェブサーバーにデプロイするか、dist/index.html を直接ブラウザで開いて利用できます。
技術的なポイント
クライアントサイド完結のデータ保持
本リポジトリではアプリケーションバックエンドを持たないため、データの永続化はブラウザ側のストレージに委ねられています。
- localStorage: ユーザーが入力した API キーや各種設定項目が保存されます。
- IndexedDB: 会話のやり取りや添付された元ファイルが保存されます。
データはブラウザのプロファイルやオリジンごとに分離して管理されます。また、設定画面のデータ管理から ZIP ファイル形式で会話履歴をエクスポート・インポートすることが可能です。インポートを行うと既存のローカル会話や添付ファイルがすべて置き換わる検証処理が含まれています。エクスポートデータには会話内容とローカルの元画像が含まれますが、API キーや各種設定、画像以外の添付ファイル原本は除外される仕様です。
API 連携と通信プロトコル
API の通信先はデフォルトで https://api.deepseek.com に設定されています。モデルとしては標準で deepseek-flash が指定されており、Anthropic 互換の Messages / Files API を介してやり取りを行います。音声入力や読み上げについては、ASR および TTS エンドポイントにリクエストが送信されます。さらに、検索、リンク読み取り、自動タイトル生成、latest_reminder などの拡張リクエストが含まれているため、接続先のサービス側がこれらに対応している必要があります。
開発環境におけるプロキシ設定や接続先オリジンの変更は、rspack.config.ts 内の createConfig({ apiOrigin, devServer }) でカスタマイズ可能です。
ツールチェーンとコード構成
ビルドツールには Rspack(rspack.config.ts)が採用されています。また、静的解析には oxc プロジェクトのエコシステムである oxlint(リント)および oxfmt(フォーマット)が使われています。
リポジトリの src/ ディレクトリは役割ごとに以下のように整理されています。
src/app/: アプリケーション全体のレイアウト、テーマ設定、グローバルスタイルsrc/components/: チャット画面、設定モーダル、Markdown レンダラーなどの UI コンポーネントsrc/i18n/: 英語および簡体字中国語の多言語リソースsrc/services/api/: API リクエスト処理、Server-Sent Events(SSE)のハンドリング、プロトコル型定義src/services/chat/: 会話状態の管理、メッセージ分岐の制御、ストレージ読み書き、履歴のインポート/エクスポートsrc/services/markdown/: Markdown パース処理、構文ハイライト、ダイアグラム描画src/services/speech/: 音声録音(ASR)および音声読み上げ再生(TTS)src/utils/: 共通ユーティリティ関数群
注意点
- API キーの取り扱い: バックエンドが存在せずブラウザから直接 API を呼び出すため、API キーはブラウザ(localStorage)に保存されます。共有端末や公共の PC で利用する場合は、利用後にデータ削除を行うなど、キーの露出や残留に注意する必要があります。
- ローカルファイル(file://)実行時のブラウザ制約: ビルド後の
dist/index.htmlや Releases の HTML を直接ファイルプロトコル(file://)で開く場合、ブラウザ側がfile://上でのストレージ利用を許可していること、および接続先の API サービス側がクロスオリジン(CORS)リクエストを許容している必要があります。 - バックエンド API の要件: チャット機能は Anthropic 互換の API 形式を前提としており、検索拡張や ASR/TTS エンドポイントなど複数の付加機能への対応が求められます。独自の互換プロキシやサードパーティ製サービスに繋ぎ替える場合は、これらすべての機能がサポートされているか確認が必要です。
- ライセンス: 本プロジェクトは MIT ライセンスで公開されています。ビルド時には
dist/LICENSEにライセンスファイルがコピーされるため、再配布時にはこれを含める必要があります。また、依存するサードパーティ製ライブラリにはそれぞれのライセンスが適用されます。
まとめ
deepseek-ai/chat-demo は、Rspack や TypeScript、oxlint などのモダンなツールで構築された、バックエンド不要の DeepSeek 公式チャット UI です。ストリーミング表示や思考プロセスの可視化、音声入出力、数式やダイアグラムの描画など、現在の対話型 AI クライアントに求められる機能が網羅されており、手軽な利用からクライアント実装の参考まで幅広く活用できるリポジトリです。





