Marinara Engine is a local, AI-powered engine designed for intuitive chat, roleplay, and gaming experiences, prioritizing a "plug-and-play" philosophy for immediate use. It targets users seeking a fun, low-setup environment for AI-driven interactions, offering multi-agent capabilities and seamless memory transfer across different modes, significantly reducing setup time and complexity.

How It Works

The engine operates on a modular architecture featuring over 25 built-in AI agents that manage tasks like world state tracking, combat, narrative direction, and more, all disabled by default for user control. It supports three distinct interaction modes: Conversation (Discord-style DMs), Roleplay (immersive RPG with visual elements), and Game (AI Game Master). Core features include advanced prompt engineering tools like drag-and-drop prompt ordering, lorebooks with keyword triggers, and a macro system. Data is stored locally in an encrypted SQLite database, ensuring privacy and no account requirement.

Quick Start & Requirements

Installation is supported across multiple platforms: Docker/Podman, Windows, macOS/Linux, and Android (via Termux), with dedicated guides available for each. Users should consult the platform-specific installation guides for detailed instructions. The project is currently in Alpha Software status.

Highlighted Details

• Multi-Modal Interaction: Offers Conversation, Roleplay (with character sprites, custom backgrounds, weather effects), and Game (AI GM, party management, combat) modes.
• AI Agent System: Over 25 built-in agents for diverse functionalities, user-configurable.
• Advanced Prompt Engineering: Features include preset systems, lorebooks, AI lorebook maker, world info inspector, regex scripts, and macro/template systems.
• Broad AI Provider Support: Integrates with OpenAI, Anthropic, Google, OpenRouter, Mistral, Cohere, NovelAI, ComfyUI, SD Web UI, and custom OpenAI-compatible endpoints.
• Local Data Storage: All data is stored locally in an encrypted SQLite database; no account is required.

Maintenance & Community

Community support, feedback, and character sharing are facilitated through a Discord server. Financial contributions to support the project are accepted via Ko-fi.

Licensing & Compatibility

The project is licensed under the AGPL-3.0 license. This strong copyleft license requires derivative works to also be made available under the AGPL-3.0, which may have implications for commercial use or integration into closed-source projects.

Limitations & Caveats

As Alpha Software, users should anticipate rough edges, potential missing features, and the possibility of breaking changes. Bug reports and user feedback are actively encouraged to aid development.