Windowsインストールガイド

インストーラー(手順がもっとも少ない方法)またはソースから、WindowsのPCにMarinara Engineをインストールします。インストール後、Marinaraは自分のPCで動きます。

始める前に

Windows 10またはWindows 11(64ビット)、数ギガバイトのディスクの空き容量、インストール中のインターネット接続が必要です。インストーラーは約2.5 GBの空き容量を推奨しています。

次の2つのツールも必要です。

Node.jsのバージョン24、25、26のいずれか。Node.jsがアプリを動かします。推奨はLTS(Long Term Support)版のバージョン24です。
Git。Gitはコードをダウンロードし、Marinaraが自分自身をアップデートできるようにします。

インストーラーを使う場合は、これらをインストールする必要はありません。インストーラーが両方を取得します。ソースからインストールする場合は、自分でインストールします。pnpm(アプリの構成部品をインストールするツール)をインストールする必要はありません。インストーラーとstart.batが用意します。

Windowsインストーラーでインストールする

Marinara Engineのリリースページを開きます。
最新のWindowsインストーラーをダウンロードします。ファイル名はMarinara-Engine-Installer-のあとにバージョンが続く形です。
インストーラーを実行します。Windowsに「Windows protected your PC」と表示された場合は、More info(詳細情報)、続いてRun anyway(実行)を選びます。ただし、これはリリースページから入手したファイルの場合に限ります。
画面の指示に従って進めます。Node.jsやGitが見つからない場合は、インストーラーにインストールさせます。
インストール先のフォルダーを選ぶか、デフォルト(%LOCALAPPDATA%\Marinara-Engine)のまま進めます。
インストーラーがアプリをダウンロードしてビルドするのを待ちます。進行状況の一覧に各手順が表示されます。数分かかります。
インストールの完了が表示されたら、デスクトップのMarinara Engineショートカットをダブルクリックします。

コンソールウィンドウ(黒い文字表示のウィンドウ)が開き、進行状況を表示します。その後、ブラウザーでMarinaraが開きます。開かない場合は、http://127.0.0.1:7860にアクセスします。

インストーラーは、最新の安定版リリースをGitのコピーとして用意します。そのため、Marinaraは起動のたびに自分自身をアップデートできます。

Tip: インストーラーがNode.jsとGitをダウンロードするため、ウイルス対策ソフトによってはインストーラーを警告の対象にします。インストーラーは、上のリリースページから入手した場合にだけ実行してください。

Marinaraの起動と停止

起動: デスクトップのショートカットかスタートメニューの項目をダブルクリックします。ソースからインストールした場合は、Marinaraのフォルダーでstart.batを実行します。
停止: ショートカットはコンソールウィンドウを開きます。そのウィンドウで<kbd>Ctrl</kbd>+<kbd>C</kbd>を押します。

Marinaraがすでに動いている場合、ショートカットはブラウザーでMarinaraを開き直します。

ソースからインストールする

コマンドを自分で実行したい場合や、staging(テスター向け)版を使いたい場合は、この方法を使います。

Node.jsとGit for Windowsをインストールします。
新しいコマンドプロンプトのウィンドウ(コマンドを入力する文字表示のウィンドウ)を開きます。
両方のツールを確認します。node -vでは、バージョン24、25、26のいずれかが表示される必要があります。

   node -v
   git --version

コマンドが見つからない場合は、コマンドプロンプトを閉じて開き直すか、足りないツールをインストールし直してください。

コードをダウンロードします。

   git clone https://github.com/Pasta-Devs/Marinara-Engine.git

そのフォルダーに移動します。

   cd Marinara-Engine

任意: 最初の起動の前にstaging版に切り替えます。安定版を使う場合は、この手順を飛ばしてください。stagingを使う前には、データをバックアップしてください。

   git checkout staging

以後のアップデートでも、ランチャーはstagingのまま維持します。

ランチャー(Marinaraをセットアップして起動するスクリプト)を実行します。

   start.bat

最初の起動では、すべてをインストールしてビルドするため数分かかります。コンソールウィンドウに進行状況が表示されます。準備ができると、ブラウザーでMarinaraが開きます。あとでもう一度起動するときは、同じフォルダーでstart.batを実行します。

うまくいかなかった場合: [ERROR] Node.js 24 LTS or newer is requiredは、Node.jsが古すぎることを意味します。nodejs.orgからNode.js 24以降をインストールしてから、もう一度start.batを実行します。

ランチャーを使わない手動セットアップ

この方法にはpnpmコマンドが必要です。次のコマンドはMarinara-Engineフォルダーの中で実行します。

pnpmを一度だけインストールします。

   npm install -g pnpm

依存関係(アプリが必要とする部品)をインストールし、アプリをビルドして、サーバーを起動します。

   pnpm install --force
   pnpm build
   pnpm start

http://127.0.0.1:7860を開きます。

pnpm startでは、このPCからしかMarinaraに接続できません。ほかのデバイスから接続できるようにするには、Marinara-Engineフォルダーに.envという名前のファイルを作り、次の行を追加してサーバーを再起動します。

HOST=0.0.0.0

別のデバイスからMarinaraを開く

インストーラー、そのショートカット、start.batでは、ネットワーク上のほかのデバイスからMarinaraに届くようになります。ただし、ログインを設定するまで、Marinaraはそれらのデバイスからの接続をブロックします。手順はリモートアクセスとFAQを参照してください。

Marinaraをアップデートする

ショートカットかstart.batからMarinaraを起動するたびに、ランチャーはアップデートを確認してインストールし、ビルドし直してから起動します。チャット、キャラクター、設定はそのまま残ります。自分でコードを変更していた場合、ランチャーはその変更をいったん退避し、アップデート後に元に戻します。退避できない場合は、今のバージョンのままにして、その旨を表示します。アプリ内のApply Update(アップデートの適用)ボタン、アップデートを飛ばす方法、手動のコマンドについては、Marinara Engineのアップデートを参照してください。

データの場所とアンインストール

データは、Marinaraのフォルダーの中のpackages\server\dataフォルダーにあります。アンインストールするには、スタートメニューのUninstall Marinara Engine(Marinara Engineのアンインストール)を開きます。アンインストーラーは、データも削除するかどうかを尋ねます。あとで再インストールするためにデータを残すには、No(いいえ)を選びます。Marinaraのバックアップと復元を参照してください。

任意: AIによるスプライトの背景除去

Marinaraは、生成するスプライトに透過した背景を要求し、単色の背景は自分で取り除きます。細かい風景の背景に対する予備の手段として、任意のbackgroundremoverツールをインストールできます。大きな機械学習ファイルをダウンロードするため、デフォルトではオフです。

python.orgからPython 3.11をインストールします。Python 3.9から3.11までが動作します。
Marinara-Engineフォルダーで次のコマンドを実行します。

   pnpm backgroundremover:install

これで、データフォルダーの下に専用のPythonフォルダー(venv)が作られます。Marinaraはこれを自動的に使います。

次回の起動時にstart.batにインストールさせるには、.envファイルに次の行を追加します。

BACKGROUNDREMOVER_AUTO_INSTALL=true

うまくいかないときは

Node.jsがバージョン24、25、26のいずれかであることと、Gitがインストールされていることを確認してください。ほかの対処法は、Marinara Engineのトラブルシューティングを参照してください。