Skip to content

Pasta-Devs/Marinara-Engine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

632 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

🍝 Marinara Engine

Fun. Intuitive. Plug-And-Play.

A local, AI-powered chat, roleplay, and game engine built around one idea: you install it, you run it, and it just works. Oh, and don't forget about the part where you have fun! ALSO, HEY, LOOK, IT'S FREE.
Created with agentic use in mind, allowing multiple requests at once. Everything is connected. Chat with your characters OOC about your roleplays. Have them create RP scenes for you. All designed with simplicity in mind: we don't want to spend hours on setup, we just want to goon play.


⚠️ Alpha Software — Early release. Expect rough edges, missing features, and breaking changes. Bug reports and feedback are very welcome!


Table of Contents


Screenshots

Roleplay Chat — Desktop
Roleplay Mode — Character sprites, custom backgrounds, weather effects, and AI agents

Home    Onboarding Tutorial

Home screen   ·   Guided onboarding

DM Conversation    Conversation with Selfie

Conversation Mode — Discord-style DMs with selfies and image generation

Bot Browser
Bot Browser — Search and import characters from Chub.ai

Game Mode — Scene
Game Mode — AI Game Master, party of characters, generated backgrounds, weather, and time of day

Game Dialogue    Party Card

NPC dialogue tracking   ·   Party member card with stats, levels, and abilities

Mobile Group Conversation      Mobile Roleplay      Mobile Game Mode

Fully responsive — Conversations, Roleplay, and Game Mode all work on phones and tablets via PWA


Latest Release

Current stable release: v1.5.6.

See CHANGELOG.md for detailed release notes. Tagged releases use the vX.Y.Z format and are published on the Releases page.


Roadmap

  • Free-to-download mobile apps for Android and iPhone
  • An engine feature for building and sharing full games with custom sprites, soundtracks, and scenarios
  • New game modes: tabletop-style, point-and-click, and classic text adventures
  • Ongoing improvements and bug fixes

More detailed public roadmap.


Installation

Platform Guide
🐳 Docker / Podman Container Installation Guide — recommended
🪟 Windows Windows Installation Guide
🍎🐧 macOS / Linux macOS / Linux Installation Guide
🤖 Android (Termux) Android (Termux) Installation Guide

Each guide covers installation, updating, and LAN access for that platform. See Configuration Reference for environment variables setup. Having trouble? See FAQ and Troubleshooting.


Features

Chat & Roleplay

Three chat modes — Conversation (Discord-style DMs), Roleplay (immersive RPG with sprites and backgrounds), and Game (AI Game Master with party, quests, and combat). Characters can share memory across modes. Create or import characters, search the Chub.ai bot browser, organize chats into folders, branch conversations, swipe between alternate responses, and import from SillyTavern.

Visual & Immersive

Character expression sprites with automatic emotion switching, custom scene backgrounds, dynamic weather overlays, two visual themes (Y2K Marinara and SillyTavern classic), and light/dark mode.

AI Agent System

25+ built-in agents that run alongside your chat — world state tracking, quest management, combat, expression detection, background selection, narrative direction, prose analysis, Spotify DJ, CYOA choices, and more. All disabled by default; enable only what you want, or create custom agents.

Prompt Engineering

Preset system with drag-and-drop prompt ordering, lorebooks with keyword triggers, an AI lorebook maker, world info inspector, regex scripts, and a macro/template system.

Connections & Providers

OpenAI, Anthropic, Google, OpenRouter, NanoGPT, Mistral, Cohere, Pollinations, Stability AI, Together AI, NovelAI, ComfyUI, SD Web UI, and custom OpenAI-compatible endpoints. API keys are encrypted at rest with AES-256. Per-chat connection overrides.

Export & Data

Export chats as JSONL or plain text. Fully local SQLite database — all data stays on your machine. No account required.


Documentation

Document Description
docs/INSTALLATION.md Installation guide index (all platforms)
docs/CONFIGURATION.md Environment variables and .env reference
docs/TROUBLESHOOTING.md Common issues and fixes
docs/FAQ.md Frequently asked questions (LAN access, etc.)
docs/FRONTEND.md Frontend architecture, components, hooks, and API reference
android/README.md Android WebView wrapper (APK) guide
CONTRIBUTING.md Contributor workflow, validation, versioning, and release steps
CHANGELOG.md Release notes
CLAUDE.md Maintainer notes for contributors using Claude

Community & Support


Contributors


License

AGPL-3.0