Official downloadable agents and capability packages for Marinara Engine.
Marinara Engine starts lightweight: a fresh installation contains no optional agents. Open Agents → Download Agents on desktop or mobile to browse this catalog, read what each package does, and install only the features you want. Installed packages appear in the normal Agents panel and the chat modes they support. You can update or uninstall them from the same catalog. Restart Marinara Engine when the installer asks you to do so.
Across its Engine compatibility lanes, the catalog currently contains 31 first-party packages: 6 Writer Agents, 8 Tracker Agents, and 17 Misc Agents. Most packages support Marinara Engine v2.3.0+; Storyboard remains available from v2.3.5, while World Maps and Long-Term Memory require the stable v2.4.1 release. Every package accepts compatible Engine v2 and v3 releases below v4.0.0. Each Engine release sees only the packages compatible with its major version. Users upgrading from an older Engine keep every feature that was available before the package split. Migration downloads matching packages once and preserves existing chat selections, agent settings, runtime data, and history.
| Agent | Package | What it does |
|---|---|---|
| Card Evolution Auditor | card-evolution-auditor |
Audits durable roleplay changes and proposes precise character-card edits for approval. |
| Continuity Checker | continuity |
Fixes concrete spatial, timeline, and physical logic errors without changing the story. |
| Knowledge Retrieval | knowledge-retrieval |
Finds relevant lorebook information, summarizes it, and injects it into the prompt. |
| Knowledge Router | knowledge-router |
Selects relevant lorebook entries from a lightweight catalog and injects them verbatim. |
| Narrative Director | director |
Creates one-shot story directions when the user chooses to push the next response forward. |
| Prose Guardian | prose-guardian |
Removes banned words, repetition, and unwanted prose habits without changing meaning. |
| Agent | Package | What it does |
|---|---|---|
| Background | background |
Selects the best existing scene background from your library. |
| Character Tracker | character-tracker |
Tracks present characters, moods, actions, appearance, thoughts, and character stats. |
| Custom Tracker | custom-tracker |
Tracks user-defined currencies, counters, flags, and other custom fields. |
| Expression Engine | expression |
Detects character emotions and selects matching Visual Novel sprites or expressions. |
| World Maps | hierarchical-maps |
Adds persistent nested locations, durable shared worlds, reusable artwork, customizable Direct Link lines, map authoring, and movement. |
| Persona Stats | persona-stats |
Tracks the player persona's status bars and custom stats from narrative events. |
| Quest Tracker | quest |
Manages quest objectives, completion states, and rewards. |
| World State | world-state |
Tracks date, time, weather, location, temperature, and custom world details. |
| Agent | Package | What it does |
|---|---|---|
| 8-Ball Pool | eightball |
Adds a complete Conversation-mode 8-Ball Pool table and /8ball command. |
| Chess | chess |
Adds a Conversation-mode chess board and /chess command. |
| Combat | combat |
Manages combat encounters, initiative, HP tracking, and turn-based actions. |
| Calls | conversation-calls |
Adds live audio/video calls, microphone transcription, and character video presence. |
| CYOA Choices | cyoa |
Generates clickable Choose Your Own Adventure choices after Roleplay responses. |
| Echo Chamber | echo-chamber |
Simulates a streaming-style audience chat reacting to Roleplay in real time. |
| Haptic Feedback | haptic |
Controls connected Intiface devices from analyzed narrative content. |
| Illustrator | illustrator |
Creates images and videos, with optional automatic Roleplay backgrounds for new scene locations. |
| Immersive HTML | html |
Adds diegetic HTML/CSS/JS visual artifacts without changing story meaning. |
| Lorebook Keeper | lorebook-keeper |
Creates and updates durable lorebook entries from important story facts. |
| Long-Term Memory | long-term-memory |
Extracts durable memories from chat summaries, character records, and lorebooks, with scoped vault browsing, review, source management, recall controls, and preset-marker placement for Roleplay. |
| Music DJ | spotify |
Plays scene-matched music through Spotify, YouTube, or local Game Assets. |
| Poker | poker |
Adds No-Limit Texas Hold'em for Conversation chats and the /poker command. |
| Rock-Paper-Scissors | rock-paper-scissors |
Adds best-of-three, five, or seven Conversation matches and the /rps command. |
| Storyboard | storyboard |
Plans and generates still or animated Game and Roleplay storyboards with provider-tuned prompt chains. |
| Tic-Tac-Toe | tic-tac-toe |
Adds one-on-one Conversation matches and the /tictactoe command. |
| UNO | uno |
Adds a complete Conversation-mode UNO table and /uno command. |
For complete mode, lifecycle, and settings documentation for every package, see the Engine's Downloadable Agents Reference.
The Engine downloads only entries from its Engine-major lane in this official HTTPS catalog, validates the catalog schema, checks Engine version compatibility, verifies the archive SHA-256 checksum, rejects unsafe archive paths and undeclared files, validates each declared file hash and size, and installs atomically into the Engine data directory. Installed packages remain available offline. Server-capability packages run with their declared permissions and require a restart when their runtime changes.
Package source and reproducible build scripts live in this repository instead of the base Engine distribution. Generated artifacts are published under artifacts/, package manifests under packages/, and machine-readable catalogs under catalog/. Engine 2 uses catalog/v2/catalog.json, Engine 3 uses catalog/v3/catalog.json, and catalog/catalog.json remains the legacy Engine 2 alias.
Catalog entries classify packages as writer, tracker, or misc. Every official package has a square Professor Mari cover under artwork/agent-covers/, published through its HTTPS iconUrl; Marinara displays that artwork in Download Agents and falls back to the Agents star icon when artwork is unavailable. Agent code does not need to be repackaged when catalog artwork changes.
Conversation mode's About Me profile and update_about_me tool are built into Marinara Engine. They are not agents and must not be published in this catalog.
Agent ideas, bugs, documentation corrections, and package improvements are welcome. Read CONTRIBUTING.md before starting: contributions begin with an issue and target the staging branch. Engine staging users automatically consume Agents staging for package testing. Every ready PR must pass validation and CodeRabbit; outside and first-time contributors also need an approving review from SpicyMarinara. Only SpicyMarinara promotes tested staging work to main.
Build the shared package snapshot and all feature bundles from a neighboring Marinara Engine checkout:
node scripts/build-agent-catalog.mjs
node scripts/build-feature-packages.mjs
node scripts/validate-catalog.mjsThe build records generic Engine source dependencies needed by feature packages under sources/engine. Package-owned implementations stay with their package; for example, World Maps and Long-Term Memory source live under their respective packages/<id>/src/engine/ trees and are overlaid on those generic dependencies during each build.
- Join our Discord — Chat, get help, share characters, and give feedback
- Support on Ko-fi — Help keep the project alive
Made with contrib.rocks.