Guía de instalación para macOS / Linux

Instala Marinara Engine en una Mac o en una computadora con Linux e inícialo con el lanzador start.sh. Marinara se ejecuta entonces en tu propia computadora.

Antes de empezar

Necesitas dos herramientas:

No necesitas instalar pnpm (la herramienta que instala las partes de la app). El lanzador configura la versión correcta.

Instalar Node.js y Git en macOS

Con Homebrew, un solo comando instala las dos:

brew install node git

Sin Homebrew, descarga el instalador de Node.js desde nodejs.org. Luego instala Git con las herramientas de línea de comandos de Xcode:

xcode-select --install

Instalar Node.js y Git en Linux

Usa tu gestor de paquetes. En Ubuntu o Debian, la versión de Node.js predeterminada suele ser más antigua que la 24, así que agrega primero la versión de NodeSource:

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

En Fedora:

sudo dnf install -y nodejs git

En Arch:

sudo pacman -S nodejs npm git

Verificar las herramientas

node -v
git --version

node -v debe mostrar v24 o un número mayor. Si cualquiera de los comandos dice "command not found", la herramienta no está instalada correctamente.

Instalar e iniciar Marinara

  1. Abre una terminal, una ventana donde escribes comandos. En una Mac, pulsa <kbd>Cmd</kbd>+<kbd>Space</kbd>, escribe Terminal y pulsa Enter. En Linux, abre tu app de terminal.
  2. Descarga Marinara.
   git clone https://github.com/Pasta-Devs/Marinara-Engine.git
  1. Abre la carpeta nueva.
   cd Marinara-Engine
  1. Inicia Marinara con el lanzador, el script que la configura y la inicia.
   ./start.sh

La primera ejecución tarda unos minutos mientras descarga y compila todo. La terminal muestra el progreso y luego Press Ctrl+C to stop. Marinara se abre en tu navegador en http://127.0.0.1:7860. Si el navegador no se abre, ve tú mismo a esa dirección.

Si no funcionó:

Iniciar y detener Marinara

Cada vez que ejecutas ./start.sh desde una descarga de Git, el lanzador:

  1. Busca una versión más nueva y se actualiza si encuentra alguna.
  2. Comprueba Node.js y la versión correcta de pnpm.
  3. Instala las partes que falten y vuelve a compilar la app si el código cambió.
  4. Inicia el servidor y abre tu navegador.

Cambiar las opciones del lanzador

Las opciones del lanzador viven en un archivo .env en la carpeta de Marinara. Un archivo .env es un archivo de texto plano con una opción por línea. Para que el lanzador no abra tu navegador, agrega esta línea:

AUTO_OPEN_BROWSER=false

PORT establece el puerto, el número que va después de los dos puntos en la dirección (7860 de forma predeterminada). El lanzador permite que otros dispositivos de tu red local accedan a Marinara, pero los bloquea hasta que configures un inicio de sesión. Consulta Acceso remoto.

Actualizar Marinara

Ejecutar ./start.sh primero actualiza Marinara. Tus chats, personajes y opciones se conservan. Si cambiaste el código tú mismo, el lanzador aparta tus cambios y los vuelve a poner después de la actualización. Para omitir una actualización, el botón Apply Update (Aplicar actualización) dentro de la app y los comandos manuales, consulta Actualizar Marinara Engine.

Configuración manual sin el lanzador

La mayoría de las personas deberían usar el lanzador. Para ejecutar cada paso tú mismo, necesitas pnpm. Node.js 24 incluye Corepack, una herramienta que activa pnpm. Node.js 25 no lo incluye.

  1. En Node.js 24, activa pnpm:
   corepack enable pnpm

En Node.js 25 o 26, instala primero Corepack:

   npm install --global corepack
   corepack enable pnpm
  1. Descarga Marinara.
   git clone https://github.com/Pasta-Devs/Marinara-Engine.git
  1. Abre su carpeta.
   cd Marinara-Engine
  1. Instala las partes, compila la app e inicia el servidor.
   pnpm install --force
   pnpm build
   pnpm start
  1. Abre http://127.0.0.1:7860.

Con pnpm start, el servidor escucha solo en tu propia computadora. Para que otros dispositivos se conecten, agrega HOST=0.0.0.0 a .env y reinicia.

Opcional: eliminador de fondo

Marinara pide fondos transparentes para los sprites (imágenes del personaje) generados y limpia por sí misma los fondos planos. Como alternativa para paisajes detallados o sombras, puedes instalar el eliminador de fondo con IA opcional. Configura un venv de Python (una carpeta privada para los paquetes de Python) y descarga archivos grandes: PyTorch (una biblioteca de aprendizaje automático) y los modelos U2Net (archivos que encuentran el sujeto de una imagen).

  1. En macOS, Python 3.11 es lo que mejor funciona. Instálalo primero. Python 3.9 a 3.11 funciona.
   brew install python@3.11
  1. Desde la carpeta de Marinara, ejecuta:
   pnpm backgroundremover:install

Para que el lanzador lo instale en el próximo inicio, agrega esta línea a .env:

BACKGROUNDREMOVER_AUTO_INSTALL=true

Si algo sale mal

En algunos sistemas Linux, la instalación falla con un error que contiene ERR_PNPM_ENAMETOOLONG (rutas de archivo demasiado largas). Elimina las carpetas a medio terminar y vuelve a ejecutar el lanzador:

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

Para más soluciones, consulta Solución de problemas de Marinara Engine.

Guías relacionadas