Przewodnik instalacji na macOS i Linux

Zainstaluj aplikację Marinara Engine na komputerze Mac lub z systemem Linux i uruchom ją programem uruchamiającym start.sh. Marinara działa potem na twoim własnym komputerze.

Zanim zaczniesz

Potrzebne są dwa narzędzia:

Nie musisz instalować pnpm (narzędzia, które instaluje części aplikacji). Program uruchamiający przygotowuje właściwą wersję.

Instalacja Node.js i Git w systemie macOS

Jeśli masz Homebrew, jedno polecenie instaluje oba narzędzia:

brew install node git

Bez Homebrew pobierz instalator Node.js ze strony nodejs.org. Następnie zainstaluj Git razem z narzędziami wiersza poleceń Xcode:

xcode-select --install

Instalacja Node.js i Git w systemie Linux

Użyj menedżera pakietów. W systemach Ubuntu i Debian domyślny Node.js bywa starszy niż wersja 24, więc najpierw dodaj wydanie z NodeSource:

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

W systemie Fedora:

sudo dnf install -y nodejs git

W systemie Arch:

sudo pacman -S nodejs npm git

Sprawdzenie narzędzi

node -v
git --version

node -v musi pokazać v24 lub wyższą wersję. Jeśli któreś z poleceń zgłasza "command not found", narzędzie nie zostało zainstalowane poprawnie.

Instalacja i uruchomienie aplikacji Marinara

  1. Otwórz terminal, czyli okno, w którym wpisuje się polecenia. Na komputerze Mac naciśnij <kbd>Cmd</kbd>+<kbd>Space</kbd>, wpisz Terminal i naciśnij Enter. W systemie Linux otwórz aplikację Terminal.
  2. Pobierz aplikację Marinara.
   git clone https://github.com/Pasta-Devs/Marinara-Engine.git
  1. Otwórz nowy folder.
   cd Marinara-Engine
  1. Uruchom aplikację Marinara programem uruchamiającym, czyli skryptem, który ją konfiguruje i uruchamia.
   ./start.sh

Pierwsze uruchomienie trwa kilka minut, bo wszystko jest wtedy pobierane i budowane. Terminal pokazuje postęp, a potem Press Ctrl+C to stop. Marinara otwiera się w przeglądarce pod adresem http://127.0.0.1:7860. Jeśli przeglądarka się nie otworzy, przejdź pod ten adres samodzielnie.

Jeśli to nie zadziałało:

Uruchamianie i zatrzymywanie aplikacji Marinara

Przy każdym uruchomieniu ./start.sh z kopii pobranej przez Git program uruchamiający:

  1. Sprawdza, czy jest nowsza wersja, i aktualizuje aplikację, jeśli ją znajdzie.
  2. Sprawdza Node.js i właściwą wersję pnpm.
  3. Instaluje brakujące części i przebudowuje aplikację, jeśli zmienił się kod.
  4. Uruchamia serwer i otwiera przeglądarkę.

Zmiana ustawień programu uruchamiającego

Ustawienia programu uruchamiającego leżą w pliku .env w folderze aplikacji Marinara. Plik .env to zwykły plik tekstowy z jednym ustawieniem w każdej linii. Żeby program uruchamiający nie otwierał przeglądarki, dodaj tę linię:

AUTO_OPEN_BROWSER=false

PORT ustawia port, czyli liczbę po dwukropku w adresie (domyślnie 7860). Program uruchamiający pozwala innym urządzeniom w sieci lokalnej dotrzeć do aplikacji Marinara, ale blokuje je, dopóki nie ustawisz logowania. Zobacz Dostęp zdalny.

Aktualizacja aplikacji Marinara

Uruchomienie ./start.sh najpierw aktualizuje aplikację Marinara. Czaty, postacie i ustawienia zostają na miejscu. Jeśli w kodzie są twoje własne zmiany, program uruchamiający odkłada je na bok i po aktualizacji przywraca na miejsce. Pomijanie aktualizacji, przycisk Apply Update (wgranie aktualizacji) w aplikacji i polecenia ręczne opisuje przewodnik Aktualizacja aplikacji Marinara Engine.

Konfiguracja ręczna bez programu uruchamiającego

Większość osób powinna korzystać z programu uruchamiającego. Żeby wykonać każdy krok samodzielnie, potrzebujesz pnpm. Node.js 24 zawiera Corepack, narzędzie, które włącza pnpm. Node.js 25 go nie zawiera.

  1. W Node.js 24 włącz pnpm:
   corepack enable pnpm

W Node.js 25 lub 26 najpierw zainstaluj Corepack:

   npm install --global corepack
   corepack enable pnpm
  1. Pobierz aplikację Marinara.
   git clone https://github.com/Pasta-Devs/Marinara-Engine.git
  1. Otwórz jej folder.
   cd Marinara-Engine
  1. Zainstaluj części, zbuduj aplikację i uruchom serwer.
   pnpm install --force
   pnpm build
   pnpm start
  1. Otwórz http://127.0.0.1:7860.

Przy pnpm start serwer nasłuchuje tylko na twoim komputerze. Żeby pozwolić na połączenia innym urządzeniom, dodaj HOST=0.0.0.0 do pliku .env i uruchom serwer ponownie.

Opcjonalnie: narzędzie do usuwania tła

Marinara prosi o przezroczyste tło generowanych sprite'ów (obrazków postaci) i sama czyści jednolite tła. Jako metodę zapasową dla szczegółowej scenerii lub cieni możesz zainstalować opcjonalne narzędzie AI do usuwania tła. Tworzy ono środowisko venv Pythona (prywatny folder na pakiety Pythona) i pobiera duże pliki: PyTorch (bibliotekę uczenia maszynowego) oraz modele U2Net (pliki, które odnajdują główny obiekt na obrazie).

  1. W systemie macOS najlepiej sprawdza się Python 3.11. Najpierw go zainstaluj. Działają wersje Pythona od 3.9 do 3.11.
   brew install python@3.11
  1. W folderze aplikacji Marinara uruchom:
   pnpm backgroundremover:install

Żeby program uruchamiający zainstalował to narzędzie przy następnym uruchomieniu, dodaj tę linię do pliku .env:

BACKGROUNDREMOVER_AUTO_INSTALL=true

Kiedy coś pójdzie nie tak

W niektórych systemach Linux instalacja kończy się błędem zawierającym ERR_PNPM_ENAMETOOLONG (za długie ścieżki plików). Usuń niedokończone foldery i jeszcze raz uruchom program uruchamiający:

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

Więcej rozwiązań znajdziesz w przewodniku Rozwiązywanie problemów w aplikacji Marinara Engine.

Powiązane przewodniki