macOS / Linuxインストールガイド

MacまたはLinuxのコンピューターにMarinara Engineをインストールし、start.shランチャーで起動します。インストール後、Marinaraは自分のコンピューターで動きます。

始める前に

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

Node.jsのバージョン24、25、26のいずれか。Node.jsがMarinaraを動かします。推奨はLTS(Long Term Support)版のバージョン24です。
Git。GitはMarinaraをダウンロードし、アップデートを取得します。

pnpm(アプリの構成部品をインストールするツール)をインストールする必要はありません。ランチャーが適切なバージョンを用意します。

macOSでNode.jsとGitをインストールする

Homebrewを使う場合は、1つのコマンドで両方をインストールできます。

brew install node git

Homebrewを使わない場合は、nodejs.orgからNode.jsのインストーラーをダウンロードします。そのあと、Xcodeのコマンドラインツールを使ってGitをインストールします。

xcode-select --install

LinuxでNode.jsとGitをインストールする

パッケージマネージャーを使います。UbuntuやDebianでは、標準のNode.jsがバージョン24より古いことが多いため、先にNodeSourceのリリースを追加します。

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -
sudo apt install -y nodejs git

Fedoraでは次のとおりです。

sudo dnf install -y nodejs git

Archでは次のとおりです。

sudo pacman -S nodejs npm git

ツールを確認する

node -v
git --version

node -vでは、v24以上が表示される必要があります。どちらかのコマンドで「command not found」と表示された場合は、そのツールが正しくインストールされていません。

Marinaraをインストールして起動する

ターミナル(コマンドを入力するウィンドウ)を開きます。Macでは、<kbd>Cmd</kbd>+<kbd>Space</kbd>を押してTerminalと入力し、Enterキーを押します。Linuxでは、ターミナルのアプリを開きます。
Marinaraをダウンロードします。

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

できたフォルダーに移動します。

   cd Marinara-Engine

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

   ./start.sh

初回は、すべてをダウンロードしてビルドするため数分かかります。ターミナルに進行状況が表示され、そのあとPress Ctrl+C to stopと表示されます。ブラウザーでhttp://127.0.0.1:7860のMarinaraが開きます。ブラウザーが開かない場合は、自分でそのアドレスにアクセスします。

うまくいかなかった場合:

permission denied: chmod +x start.shを実行してから、もう一度./start.shを実行します。
[ERROR] Node.js 24 LTS or newer is required: Node.jsが古すぎます。新しいバージョンをインストールしてから、もう一度./start.shを実行します。

Marinaraの起動と停止

もう一度起動する: Marinaraのフォルダーで./start.shを実行します。Marinaraがすでに動いている場合は、ブラウザーでMarinaraを開き直します。
停止: ターミナルで<kbd>Ctrl</kbd>+<kbd>C</kbd>を押します。

Gitでダウンロードしたコピーで./start.shを実行するたびに、ランチャーは次の処理を行います。

新しいバージョンがないか確認し、見つかればアップデートします。
Node.jsと適切なバージョンのpnpmを確認します。
足りない部品をインストールし、コードが変わっていればアプリをビルドし直します。
サーバーを起動し、ブラウザーを開きます。

ランチャーの設定を変える

ランチャーの設定は、Marinaraのフォルダーにある.envファイルに書きます。.envファイルは、1行に1つの設定を書くテキストファイルです。ランチャーがブラウザーを開かないようにするには、次の行を追加します。

AUTO_OPEN_BROWSER=false

PORTはポート(アドレスのコロンのあとの番号。デフォルトは7860)を設定します。ランチャーでは、ローカルネットワーク上のほかのデバイスからMarinaraに届くようになります。ただし、ログインを設定するまで、Marinaraはそれらのデバイスからの接続をブロックします。リモートアクセスを参照してください。

Marinaraをアップデートする

./start.shを実行すると、最初にMarinaraがアップデートされます。チャット、キャラクター、設定はそのまま残ります。自分でコードを変更していた場合、ランチャーはその変更をいったん退避し、アップデート後に元に戻します。アップデートを飛ばす方法、アプリ内のApply Update(アップデートの適用)ボタン、手動のコマンドについては、Marinara Engineのアップデートを参照してください。

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

ほとんどの場合はランチャーを使ってください。各手順を自分で実行するには、pnpmが必要です。Node.js 24には、pnpmを有効にするツールであるCorepackが含まれています。Node.js 25には含まれていません。

Node.js 24では、pnpmを有効にします。

   corepack enable pnpm

Node.js 25または26では、先にCorepackをインストールします。

   npm install --global corepack
   corepack enable pnpm

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

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

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

   cd Marinara-Engine

部品をインストールし、アプリをビルドして、サーバーを起動します。

   pnpm install --force
   pnpm build
   pnpm start

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

pnpm startでは、サーバーは自分のコンピューターからの接続だけを待ち受けます。ほかのデバイスから接続できるようにするには、.envにHOST=0.0.0.0を追加して再起動します。

任意: 背景除去ツール

Marinaraは、生成するスプライト(キャラクターの画像)に透過した背景を要求し、単色の背景は自分で取り除きます。細かい風景や影のある背景に対する予備の手段として、任意のAI背景除去ツールをインストールできます。このツールはPythonのvenv(Pythonのパッケージを入れる専用のフォルダー)を作り、PyTorch(機械学習ライブラリー)とU2Netモデル(画像の被写体を見つけるためのファイル)という大きなファイルをダウンロードします。

macOSでは、Python 3.11がもっとも安定して動きます。先にインストールしてください。Python 3.9から3.11までが動作します。

   brew install python@3.11

Marinaraのフォルダーで次のコマンドを実行します。

   pnpm backgroundremover:install

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

BACKGROUNDREMOVER_AUTO_INSTALL=true

うまくいかないときは

一部のLinux環境では、ERR_PNPM_ENAMETOOLONG(ファイルパスが長すぎる)を含むエラーでインストールに失敗します。途中まで作られたフォルダーを削除し、もう一度ランチャーを実行します。

rm -rf node_modules .pnpm .pnpm-store
./start.sh

ほかの対処法は、Marinara Engineのトラブルシューティングを参照してください。