Naidan
ガイド一覧

Hosted版ZIPを自分のHTTPサーバーで使う

Hosted版ZIPを使うと、Naidanの画面を自分のHTTPサーバーから配信できます。まずはこの端末でPythonを使って開き、必要なら同じファイルを好みの静的サーバーで配信します。

最新のリリースを開く(外部サイト)

展開したZIPからNaidanを開く

  1. Hosted版ZIPを取得して展開する

    リリースページでHosted版のファイルを選びます。例えばv0.24.1のリリースなら naidan-hosted-v0.24.1.zip です。スタンドアロン版のZIPと取り違えず、ZIP全体を展開します。

    この例では、中にあるバージョン付きフォルダは naidan-hosted-0.24.1/ です。index.htmlとassetsなどの補助ファイルを一緒に保ちます。

  2. index.htmlがあるフォルダを配信する

    展開したフォルダのうち、index.htmlがある場所で端末のターミナルを開き、次を実行します。

    python3 -m http.server 8000 --bind 127.0.0.1

    この手順ではPython 3が使える必要があります。Windowsでpython3コマンドが見つからない場合は、代わりに py -m http.server 8000 --bind 127.0.0.1 を実行します。

    Naidanを使う間はターミナルを開いたままにします。配信を終えるときは、そのターミナルでCtrl+Cを押します。

  3. ブラウザでローカルのアドレスを開く

    ブラウザで http://127.0.0.1:8000/ を開きます。Naidanの画面が表示されれば、ファイルを配信できています。

ほかの静的サーバーを使う

Nginx、npx serveなどの静的HTTPサーバーでも、index.htmlと補助ファイルを含むディレクトリを希望のURLやパスで公開し、そのURLをブラウザで開きます。親ディレクトリを公開した場合はサブパスでも配信でき、バージョン付きフォルダのパスを開きます。ループバック以外のHTTPアドレスでは、安全なコンテキストを要するブラウザ機能が使えない場合があります。必要な機能があるときはHTTPSを使ってください。

画面が開いたらモデルを選ぶ

静的サーバーが返すのはアプリのファイルです。推論は実行しません。応答を得るには、対応するブラウザ内モデルを準備するか、別に動いているOllamaなどのエンジンへ接続します。Naidanでモデルを選び、短いメッセージを送って確認してください。

HTTPサーバーは画面のファイルを配信します。Naidanはブラウザで動き、応答はブラウザ内モデルまたは別の推論エンジンが生成します。

次の手順はブラウザ内モデルのガイド、GGUFの設定ガイド、またはローカルエンジンのガイドを参照してください。

Hosted版ZIPを選ぶ理由

HTTPのURLで開くと、ページには通常のWebオリジンが付きます。file://で直接開いたページのOriginはnullとなり、推論サーバーのCORS設定によって拒否される場合があります。HTTPオリジンがあっても、すべての接続が自動で許可されるわけではありません。ブラウザと接続先の通信条件を確認します。

同じアドレスでファイルを更新する

新しいHosted版ZIPを別フォルダに展開します。PythonのサーバーをCtrl+Cで止め、新しいindex.htmlがあるフォルダから同じアドレスとポートで起動し、同じURLを開き直します。ほかの静的サーバーでも、公開ファイルを切り替え、アプリのURLとベースパスを保ちます。

ブラウザ内の保存データは展開先フォルダではなく、サイトのオリジン(スキーム・ホスト名・ポート)に結び付きます。保存した会話を継続するには同じオリジンを使います。ただし一時保存の会話や設定は再読み込みで失われます。オリジンを変える場合は必要な会話データを先にバックアップします。そのZIPにダウンロード済みのモデル本体やキャッシュは含まれません。

Naidanに更新の案内が表示されたら、その案内に従ってください。PWAの準備とオフラインでの確認は、NaidanをPWAとしてオフラインで使うを参照してください。ガイドは公開Hosted版のアドレスを例にしています。自己配信版で試すときは、配信した同じURLとブラウザで確認します。ZIPが手元にあるだけでは、オフライン動作を確認できません。