Skip to content

v2.0.0

Choose a tag to compare

@github-actions github-actions released this 22 Jun 13:45
4c27abf

Important

Android APK notice: The APK is a Termux bootstrap + WebView shell, not a native Android server build. It opens an already-running local Marinara server, and on first launch it can download Termux from F-Droid, hand it to Android's installer, and start Marinara through Termux after Android permission prompts. Follow the Android wrapper guide if Android blocks the bootstrap handoff.

Release Highlights

  • Refactored major parts of the codebase, UI shell, prompt pipeline, storage/import paths, and agent orchestration so Marinara Engine is easier to extend after the 2.0 line.
  • Professor Mari is now a separate assistant living on the home page, capable of not only helping and creating stuff but also changing the theme of your frontend, creating agents, and extensions for you. Aka, fully customize your experience.
  • Rebuilt the app UI around unified settings controls, square-y chat/sidebar/tab affordances, accent-aware chrome, customizable text/background colors, a reset-to-default appearance action, and optional RGB/pulse accent effects. All available to customize from the Settings. Freshened up mobile view.
  • Reworked all the available Agents and made it easy for anyone to create their own custom one. Agents can also now easily be exported and imported.
  • Treated this as a release-stabilization pass: every known release-blocking bug and maintainer-tracked issue from the 2.0.0 sweep was addressed before preparing the release notes.
  • Marinara's Universal Preset v12 (new version) was set as a new default. Now Presets also include prompts for Conversation and Game modes you can use.

Added

  • Added a Local Model runtime toggle that starts llama.cpp with --jinja for OpenAI-compatible native tool calls.
  • Added tracker field locks for editable Roleplay HUD and Tracker Panel fields so manually pinned tracker values survive generated game-state updates.
  • Added a Termux bootstrap path to the Android APK. The APK now opens a running local server when available and otherwise offers setup actions that can hand the install/start command to Termux after Android's required user permissions.
  • Added folder-based import/export support for custom agents and browser extensions so more complex agents/extensions can travel with code and related files instead of only single JSON payloads.
  • Added Game Mode custom-agent selection in Chat Settings and aligned the Game setup wizard shell with Conversation and Roleplay setup styling.
  • Added UNO/turn-game support for Conversation chats, including in-character setup flow, bot turns, board state, and safer live snapshot handling.
  • Added stronger appearance customization: default accent color alignment, chat chrome text color coverage, app background color and gradient presets, RGB mode controls, and Marinara-style home-screen star glints.
  • Added release-ready Android APK naming and release-note notices for the Termux bootstrap shell.

Changed

  • Moved AI-assisted character, persona, lorebook, preset creation, and preset review workflows to Professor Mari.
  • Unified UI/UX styling across Settings, Characters, Presets, Agents, Browser, Connections, Chat Settings, top bar icons, sidebar tabs, buttons, sort controls, and repeated list rows.
  • Improved Game Mode setup, generation defaults, asset generation bounds, checkpoint restore paths, journal/conclusion serialization, HUD widget persistence, and tracker rendering/merging.
  • Improved prompt assembly around post-history preset sections, assistant prefill steering, context-window trimming, lorebook placement, visible tracker context, and prompt/debug parity.
  • Improved file-backed storage, backup/import/export fidelity, SillyTavern character/lorebook/preset mappings, avatar transcoding, browser card preservation, and JSONL chat import/export.
  • Improved local sidecar lifecycle, backend-aware requests, embedding paths, model provisioning checks, and local inference hardening.
  • Improved Conversation autonomous scheduling, character presence status scoping, chat settings controls, Music DJ descriptions/behavior, and top bar hover/focus behavior.
  • Updated Android docs, FAQ, troubleshooting, configuration, release-note rendering, and APK artifact naming around the new bootstrap-shell behavior.

Removed

  • Removed the deprecated standalone character, persona, and lorebook maker modals (replaced by Professor Mari) and their dedicated generation routes.
  • Removed the Preset editor's standalone review tab and dedicated preset-review route.

Fixed

  • Fixed the "Fetch Models" HTML error hint so non-image connections say "connection" instead of "image service."
  • Fixed server responsiveness issues where long generations could block unrelated UI/API work such as chat switching and /api/health.
  • Fixed Roleplay first-message confirmation layering so "Add Message" can be clicked without the Chat Settings drawer closing underneath it.
  • Fixed light-theme dropdown/list contrast in Chat Settings.
  • Fixed duplicate visual Prose Guardian/agent streaming artifacts when opening other menus mid-generation.
  • Fixed YouTube Music DJ first-track behavior to avoid Shorts-style picks where possible and clarified that Music DJ supports both Spotify and YouTube.
  • Fixed the Professor Mari surprise toast shape so it matches the rest of the toast UI.
  • Fixed max-context-window enforcement so non-history prompt material is prioritized first, recent chat history is windowed afterward, and response/free-token headroom is preserved.
  • Fixed RGB/accent styling drift across top bar icons, settings icons, hard-coded pink text, tab/list icons, New chat buttons, title gradients, and solid-color RGB pulse strength.
  • Fixed pinned gallery images layering so they stay above chat messages but below Chat Settings, trackers, author notes, summaries, session menus, and other chat UI windows.
  • Fixed custom agents in Game Mode chat settings so the picker appears in the Agents section and sits at the bottom of the section.
  • Fixed Android, Windows, Docker, Termux, and release-note wording that still described outdated APK/install behavior.
  • Fixed Claude Subscription assistant prefill steering so embedded </assistant_prefill> text cannot break the synthetic XML-style continuation prompt.
  • Fixed malformed provider/proxy response guards for Google/Gemini and related connection paths.
  • Fixed Game Mode tracker state races, retry result handling, field-lock persistence, widget persistence, malformed stats rendering, game-state snapshot integrity, and committed tracker context rendering.
  • Fixed prompt post-history system sections so they preserve metadata while being injected as user-side content at the configured depth instead of being glued to pre-history system prompts.
  • Fixed a broad sweep of import/export, storage, lorebook, agent, sidecar, game-generation, chat-sidebar, and provider edge cases found during the 2.0.0 stabilization pass.
  • And many, many more.

Platform Notes

  • Users upgrading from v1.6.1 can follow the new Upgrading to v2.0.0 guide. Windows, macOS/Linux, and Termux git installs update by relaunching their platform launcher; Docker/Podman users pull the new image; iOS/iPadOS users update the host server and reload the PWA.
  • Windows installer sources are already set to v2.0.0 and continue to build the Git/Node/pnpm bootstrap installer from tagged releases.
  • Android versionName is 2.0.0 with versionCode 19. Release APKs are now named as Termux bootstrap shells instead of "WebView shell requires Termux" artifacts.
  • Docker/GHCR release images continue to publish from v* tags, including regular and lite variants.
  • iOS/iPadOS remains a Safari PWA flow for v2.0.0. A jailbroken/sideloaded one-tap iOS bootstrap wrapper is still future work and is not included in this release.