main is the stable release branch. All new features land on Rawhide (the rolling development branch) and are promoted here when ready. Nightly cutting-edge builds are available from Rawhide for users who want the latest.
A privacy-first AI companion for Windows, Linux, and macOS. Runs fully offline with local LLMs (KoboldCpp, etc.) by default, but also supports remote APIs like OpenRouter, Nano-GPT, and OpenAI with no lock-in when you want them.
💬 Join the Discord — questions, feedback, and hanging out welcome.
Front Porch is growing a small companion ecosystem. Big thanks to community members building tools that integrate deeply.
Character Card Forge by @FrozenKangaroo — A companion editor with strong integration, including emotion image export and seeding initial Realism Engine state.
Check it out →
If you use it, a star would mean a lot to the developer.
Note: This community tool uses direct database access for its advanced features. It can be impacted by future schema changes.
v0.9.9.1 adds powerful new tools and makes the Realism Engine and group features far more reliable and usable.
🎨 Image Studio – First-Class Experience
- Full integrated studio (no more popups or separate dialogs). Buttons for Visualize Scene, Character Portrait, Chat Background, Custom, etc.
- Configure everything inside: models/LoRAs, style, negative, steps, CFG, advanced DT settings.
- Visualize Scene now uses an N-slider to pull the most recent chat messages so images actually match what's happening right now.
- Prompts start clean with proper visual descriptions (no boilerplate).
- Fixed Draw Things model picker to a proper dropdown with refresh.
🧠 Realism Engine & Needs – Dramatically More Reliable
- Bond, Trust, and Lust deltas now consistently appear in chips and reflect actual changes.
- Manual Needs Reprocess is safe and non-destructive (survives regens, handles empty model responses, works in groups).
- Group chats now correctly track per-speaker needs, decay, scene rewards (fun, hygiene, etc.), and sidebar/cards.
- Larger positive impacts from strong scenes (+100 possible). Characters give earlier natural hints about needs.
- Dedicated Needs tab in group settings + editable per-character realism baselines (bond, trust, emotion, time).
- Fixed missing needs reactions, double-firing post-gen checks, state bleed on new chats/forks/imports.
🧬 Character Evolution
- Now respects your exact "Evolve every N messages" setting with its own counter (works in groups too).
👤 Character Creator & Home
- Local KoboldCpp model picker now fully works with the same clean searchable UI as remote backends.
- Home folders show 2×2 character previews. Refresh button for external imports.
✨ Editor & Prompting Improvements
- Live syntax highlighting (amber dialogue, actions, teal {{macros}}) + spellcheck in all editors with no typing lag.
- Fullscreen editor preserves colors, highlighting, and spellcheck.
- SillyTavern-style macros now work inside cards, scenarios, and lorebooks: {{random}}, {{pick}}, {{roll}}, {{time}}/{{date}}/{{weekday}}, comments, {{newline}}, {{space}}, and escaping.
- Unified lorebook editor across the whole app with quick enable/disable toggles (disabled entries don't inject).
📤 Other Polish & Fixes
- Export User Personas as full SillyTavern-compatible JSON (learned facts are a Front Porch-only feature and will be ignored by other apps).
- Fixed Windows maximized window ghosting.
- Database Cleanup Tool for orphaned records.
- Many group, needs, and stability fixes for a much smoother experience.
If you're evaluating local AI tools, here's an honest breakdown. Every project on this list is doing something right — the goal isn't to trash competitors, it's to help you pick the right tool for you.
| Feature | Front Porch AI | SillyTavern | Jan.ai | Backyard AI |
|---|---|---|---|---|
| Native desktop app | ✅ Flutter (Win/Mac/Linux) | ❌ Web-based (local server) | ✅ Electron | ✅ (abandoned) |
| Fully offline — no cloud required | ✅ | ✅ | ✅ | ✅ |
| Remote LLM Endpoints | ✅ Native multi-provider support (OpenRouter, Nano-GPT, custom, etc.) with deep integration | ✅ Strong native support for custom OpenAI-compatible endpoints | ❌ (service discontinued) | |
| Built-in TTS (50+ voices) | ✅ Kokoro + Piper + ElevenLabs + OpenAI | ⚙️ Extension required | ❌ | ❌ |
| Speech-to-text (push-to-talk) | ✅ Whisper, built-in | ⚙️ Extension required | ❌ | ❌ |
| Local image generation | ✅ A1111, Forge, Draw Things | ⚙️ Extension required | ❌ | ❌ |
| Realism Engine | ✅ Time, trust, emotion, chaos, objectives | ❌ | ❌ | ❌ |
| Character Expressions | ✅ ONNX + LLM, live avatar swap | ⚙️ Extension required | ❌ | ❌ |
| RAG memory (local) | ✅ ONNX embeddings, no cloud | ⚙️ Extension required | ❌ | ❌ |
| Novel / story generator | ✅ Porch Stories pipeline | ❌ | ❌ | ❌ |
| Cloud sync | ✅ Google Drive / WebDAV | ❌ | ❌ | ❌ |
| Character card compatibility | ✅ V2 spec + Backyard .byaf import | ✅ V2 spec | ❌ | .byaf only |
| Group chat | ✅ | ✅ | ❌ | ❌ |
| Extension / plugin ecosystem | ❌ | ⭐ Very large | Moderate | ❌ |
| Open source license | ✅ AGPL-3.0 | ✅ AGPL-3.0 | ✅ MIT | ❌ |
| Best for | Polished AI companion + storytelling | Power users / heavy customization | Simple local chat | — |
SillyTavern's extension ecosystem is genuinely impressive and unmatched for customization depth. If you want maximum flexibility and don't mind configuration work, it's excellent. Front Porch AI prioritises everything working out of the box for users who want to chat, not configure.
- Immersive roleplay with V2-spec character cards — full SillyTavern / Backyard AI compatibility
- Smooth output buffer — text drips at your reading pace, not your GPU's pace
- Rich text styling — dialogue highlighted in amber, actions in grey
- Regenerate, Continue, Impersonate, Edit — full message control
- Persistent sessions — chat history auto-saved and restored per character
- Inline image rendering —
markdown renders in-chat - Chat branching — fork from any message to explore alternate storylines
- Emotion tracking — character mood evolves naturally across the conversation, carrying inertia between turns
- Relationship & Trust system — earn a character's trust over time; it shifts how open and vulnerable they allow themselves to be
- Autonomous time progression — scene time advances deterministically every 6 turns; OOC time-skips (
(OOC: we drive for several hours)) are auto-detected and applied - Manual time nudge — step time forward or back with sidebar chevrons
- Character Objectives — autonomous goals the character pursues independently based on story events
- Fixation Engine — active emotional obsessions that subtly color every response
- Character Evolution — characters organically develop new traits as your story progresses
- RAG Memory — local semantic memory powered by a lightweight ONNX embedding engine; the AI recalls past conversations without any cloud
- V2 spec support — fully compatible with the V2 character card specification (PNG & JSON)
- One-click import from
aicharactercards.comandchub.aivia a built-in browser - Backyard AI (.byaf) importer — rescue your characters from the archive format Backyard AI left behind when they killed their desktop app
- Folder organization, global search, tag editor, bulk PNG import
- One-click duplication — clone any character card for risk-free experiments
- Quick Create — type a name and concept, the AI builds a complete V2 card from scratch
- World Lore (RAG-Lite) — paste a Fandom wiki URL or attach a local
.txt/.pdfand the generator embeds that lore into the character - Editor passes — Anti-Puppet, Consistency Check, Quality Polish, Truncation Completion
- Alternate greetings — generate up to 5 unique first messages with configurable tone
- Lorebook auto-generation — world-building entries generated alongside the character
- Multi-character conversations — 2+ characters interacting with each other and with you
- Director Mode — manually choose who speaks next
- Fork any 1:1 chat into a group, preserving full message history
- Four engines: Kokoro (local, 50+ voices, 9 languages), ElevenLabs (cloud, expressive), OpenAI (cloud, premium), Piper (lightweight fallback)
- Parallel generation — sentences generated concurrently for fast audio output
- Narration filters — dialogue-only or skip action blocks (SillyTavern-style)
- Per-character voices in group chats
- Natively connects to A1111, Forge, SDNext, and Draw Things
- Live model switching, LoRA injection, dedicated unload controls
- Natural Language or Danbooru Tags prompt mode depending on your model
- Distill character chats into a coherent storyline timeline
- 5-stage autonomous pipeline: concept → outline → draft → edit → publish
- Skeuomorphic page-flip reader with audiobook TTS read-along
- Sync your entire database and character PNGs via Google Drive or Nextcloud/WebDAV
- Row-level merge engine with UUID primary keys — no ID collisions across devices
- Automatic backups before every sync, one-click restore
- Privacy-first: syncs only to accounts you own, no data touches our servers
- Emotion-driven avatar swapping — the character's portrait changes in real time as their mood shifts during the conversation
- Two classification paths: a lightweight ONNX model (distilbert, fully offline, ~300 ms) or the LLM path via the Realism Engine for deeper contextual accuracy
- One-click model download — the ONNX classifier downloads in-app with a glassmorphic teal progress overlay; no manual file hunting
- 26 emotion categories mapped to your character's expression image set (compatible with SillyTavern expression packs)
- Sidebar and fullscreen display modes — float the expression portrait or dock it beside the chat
- Automated download and update of the KoboldCpp backend
- Hardware detection — Vulkan on PC, Metal on Apple Silicon, Intel ARC support, Nvidia Blackwell (RTX 50-series) support
- Model Hub: search and download GGUF models directly from HuggingFace
- Start/Stop KoboldCpp from inside the Character Creator
- Advanced Launch Options — collapsible panel exposing Flash Attention, Context Shift, mlock, GPU ID selector, and prefill batch size with sane auto-selected defaults
Debian / Ubuntu / Mint / Pop!_OS
curl -fsSL https://apt.dreamersai.art/install.sh | bash
sudo apt install front-porch-aiOr manually:
curl -fsSL https://apt.dreamersai.art/front-porch-ai.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/front-porch-ai.gpg
echo "deb [signed-by=/etc/apt/keyrings/front-porch-ai.gpg] https://apt.dreamersai.art stable main" | sudo tee /etc/apt/sources.list.d/front-porch-ai.list
sudo apt update && sudo apt install front-porch-aiFedora / RHEL / openSUSE
sudo dnf config-manager --add-repo https://rpm.dreamersai.art/front-porch-ai.repo
sudo dnf install front-porch-aiArch Linux (AUR)
yay -S front-porch-ai-bin # Stable (recommended)
yay -S front-porch-ai-beta-bin # Beta / Early accessFuture updates arrive through your normal system updates (apt upgrade, dnf upgrade, yay -Syu).
Beta builds are available for early access to new features. They install to a completely separate directory (
~/Documents/FrontPorchAI-Beta/) and usebeta_preference keys so they never touch your stable data. See the Beta Builds section below for details.
Head to the Releases page:
- Stable:
.exeinstaller (Windows),.dmg(macOS),.AppImage/.deb/.rpm(Linux) - Beta: Standalone
.zip(Windows/macOS),.AppImage/.tar.gz(Linux) — no installer, just extract and run
Beta releases (e.g. the 0.9.8-Beta series) are available for early access to new features. They are completely isolated from your stable installation:
- Data directory:
~/Documents/FrontPorchAI-Beta/ - All preferences are namespaced with a
beta_prefix - Stable builds will never offer a beta update (and vice versa)
This isolation protects your main library while you test new features. Beta builds are recommended only for users comfortable with occasional rough edges.
- Backend — go to Settings → Download Backend to fetch KoboldCpp, or point it at an existing binary.
- Model — go to Manage Models → HuggingFace Search, find a GGUF model (recommended:
Q4_K_MorQ5_K_M), download. - Optimize — hit Auto-Configure to let the app pick the best GPU layer split and thread count for your hardware.
Backyard AI built a genuinely good local LLM companion app. Then they killed it — no warning, pivoted to a cloud subscription, and left users with characters stuck in a proprietary .byaf archive format with nowhere to go.
Front Porch AI was built directly in response to that. The goal: an open-source, local-first alternative that cannot be yanked out from under you by a pivot to SaaS. We even support importing directly from .byaf files so your characters can escape.
Starting with v0.9.0, this project is licensed under AGPL-3.0 — meaning anyone who hosts a modified version as a service must open-source their changes too. It stays open, even in a world of cloud-hosted forks.
Note: v0.8.x and earlier are licensed under GPLv3.
🎩 Hat tip to the Backyard AI team for at least open-sourcing the
.byafformat on their way out.
- Discord: Join our server
Pull requests are welcome! If you're a dev reading this far down, here's what you need to know:
- Branch workflow: All new features, experiments, and major work target the
Rawhidebranch (the primary rolling development line). Bug fixes for the current stable go todev. Beta stabilization branches (e.g.0.9.x-Beta) receive only fixes for that release series.mainis for final tagged stable releases only. See AGENTS.md for the full current model. - Nightly / scheduled builds & schedule triggers: Automatic builds are powered by
.github/workflows/nightly.yml. GitHub only readson: schedule:from the default branch (main). A current copy of the workflow (especially the version-patching step) must live onmain, otherwise nightly compiles will fail. The job typically checks out the active development branch for source, but the workflow definition itself always comes frommain. - Commit conventions: Follow the guidelines in AGENTS.md for commit message format, code style, and naming conventions.
- Full guide: See CONTRIBUTING.md for build instructions, testing requirements, and the PR template.
- Before you PR: Run
flutter analyzeandflutter testlocally. The project is now at 0 warnings on the active rules. CI analyzes only changed.dartfiles on PRs (plus a full scheduled lint job). Introducing new warnings will fail CI.
To everyone who has shown up with kind words, bug reports, feature ideas, and genuine enthusiasm — thank you. You've turned what started as a "screw it, I'll build my own" into something worth building every day.
— SosukeAizen on Discord
Front Porch AI stands on the shoulders of these incredible open-source projects:
| Project | What It Does | Link |
|---|---|---|
| KoboldCpp | The local LLM backend. Single-file, GGUF-native, GPU-accelerated. | GitHub |
| Faster Whisper | Speech-to-text for push-to-talk and voice call mode. | GitHub |
| Kokoro | Default TTS engine. Beautiful offline voices via ONNX. | GitHub |
| Piper | Fallback TTS engine. Fast, lightweight, privacy-respecting. | GitHub |
If Front Porch AI is useful to you, please consider starring these projects too — they're the foundation everything is built on.
| Contributor | Role |
|---|---|
| Hakko504 | Bug Testing, UI/Feature Suggestions |
| PacmanIncarnate | Bug Testing, UI/Feature Suggestions |
| SunTzucious | Beta Testing |
Front Porch AI does not collect, store, or transmit any personal data. Full details: Privacy Policy
v0.9.0+ — AGPL-3.0
v0.8.x and earlier — GPL-3.0
- Flutter SDK
- Rust toolchain (for the RAG embedding server)
- Git
- Windows, Linux, or macOS
Ubuntu/Debian
sudo apt-get install clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev libstdc++-12-dev libwpewebkit-1.0-devArch Linux
sudo pacman -S clang cmake ninja pkgconf gtk3 xz wpewebkitFedora
sudo dnf install clang cmake ninja-build pkgconf-pkg-config gtk3-devel xz-devel libstdc++-devel wpewebkit-devel
wpewebkitis required for the built-in browser (Chub.ai / aicharactercards.com import). Pre-built AppImages bundle it automatically.
git clone https://github.com/linux4life1/front-porch-ai.git
cd front-porch-ai
flutter pub get
flutter runmacOS release build (includes RAG embedding server):
./scripts/build-macos.shLinux / Windows release build:
cargo build --release --manifest-path tools/embed_server/Cargo.toml
flutter build linux # or windowsOn Linux/Windows, copy
tools/embed_server/target/release/embed_servernext to the built executable underembed_server/embed_server.
📦 Old Release Notes
- 🖼️ Fixed a crash when replacing a character's avatar in the full editor (especially on macOS — "Read-only file system" error).
- ☁️ Cloud Sync settings page now loads the real interface instead of a placeholder.
- 📖 Story engine handles floating-point numbers from AI models (e.g.
1.0instead of1) — generation is much more stable across different models. - 🔊 Emojis stripped before sending to TTS. "Test Voice" now respects the "Only narrate quotes" setting.
- 🖼️ Increased local image generation timeout for slower models.
The headline feature is Character Expressions (live emotion portraits that swap as the conversation evolves), plus major Realism Engine maturation, a much more robust Kokoro TTS experience, .kcpps preset support, custom chat backgrounds, Google Fonts picker, expanded bond/trust/arousal ranges, and dozens of stability fixes.
Complete character editor redesign with a 4-tab layout (Details, Dialogue, Lorebook, Worlds), glassmorphic section cards, Realism Engine settings editable directly in the character editor, and several crash/data-integrity fixes.
🎨 Character Editor — Full Redesign
- New 4-tab layout: Details, Dialogue, Lorebook, and Worlds — dialogue fields (first message, alternate greetings, example conversations) are no longer crammed into the Details tab.
- Glassmorphic section cards with icon headers for visual grouping (Identity, Personality & World, Advanced Prompts).
- 160px avatar display with rounded corners and camera overlay — tap to change.
- Collapsible Advanced Prompts — system prompt and post-history instructions hidden by default to reduce visual clutter.
- Restyled lorebook cards showing keyword chips, trigger depth badges, and always-active indicators.
- Restyled worlds tab with toggle-based linking, visual feedback, and entry count badges.
- Consistent input styling and token counter matching the manual character creator.
🧠 Realism Engine — Editable in Character Editor
- Characters can now have their Realism Engine settings configured directly in the character editor — no longer limited to the character creator.
- Characters without V2.5 extensions can have them created from scratch via the editor.
- Full access to all Realism Engine parameters: bond scores, trust level, time of day, starting emotion, recovery mechanics, and Chaos Mode toggle.
- Includes a friendly note reminding users that changes only affect new conversations — existing chats keep their live state.
🐛 Bug Fixes
- Fixed character creator crash on Linux: The back button was calling
Navigator.pop()on a tab-embedded page, popping the root navigator and leaving a black screen. Now correctly returns to the Home tab. - Fixed V2.5 metadata loss on avatar change: When editing a character and changing the avatar, the save flow was creating a redundant card copy that omitted Realism Engine extensions. The throwaway card has been eliminated — the editor now passes the live character object directly.
- Fixed Realism Engine level 10 prompt: Refined the peak desire state prompt to describe emotional intensity without dictating deterministic narrative outcomes or causing behavioral leakage into subsequent turns.
⚙️ CI/CD
- Converted
release.ymlfrom CRLF to LF line endings. - Added defensive carriage-return stripping to AUR package generation to prevent future regressions.
- Documentation update: supplemented missing changelog entries from the v0.9.7.3 release.
This release overhauls the Learned Facts system, adds full Web UI parity for the character creator, and delivers phased Realism Engine improvements for more natural character behavior.
🧠 Learned Facts — Quality Overhaul
- RP-aware extraction prompt: The system now distinguishes between roleplay actions and real user information — no more "walked to the door" or "kissed the character" polluting your fact list.
- Quality gate filter: Every extracted fact passes through a multi-pattern validation gate that rejects action verbs, vague generics, narrator voice, JSON artifacts, and encoding garbage before saving.
- 50-fact cap with smart consolidation: When your fact list grows beyond 50 entries, the LLM merges related facts into denser statements (e.g., "Has a cat" + "Cat's name is Luna" → "Has a cat named Luna") while preserving all specific details.
- Semantic dedup tightened: Near-duplicate detection threshold lowered from 0.85 → 0.75, catching more "same fact, different words" entries.
- Startup garbage cleanup: Existing fact lists are automatically filtered on every app launch, removing historically accumulated junk entries.
- GBNF grammar constraint: Local KoboldCpp models now output guaranteed-valid JSON arrays, eliminating most parse failures.
🧠 Realism Engine — Phased Recovery
- Dynamic recovery phases: The post-climax recovery prompt now phases through three stages — immediate, settling, and late recovery — based on the ratio of remaining to total recovery turns. Characters with short recovery windows move through phases quickly; characters with longer windows linger naturally.
- Per-character pacing: Recovery duration varies from 1–8 turns based on personality traits, and the prompt now reflects exactly where in that window the character is.
🔄 Unified Periodic Evaluations
- Synchronized cadence: Learned Facts extraction and Character Evolution now fire on the same timer (every 10 user messages), running sequentially instead of on separate, overlapping intervals.
- Reduced LLM contention: Both evaluations share one window, preventing back-to-back queued requests on local backends.
🖥️ Web UI — Character Creator Parity
- Manual Creator Wizard: The web UI's manual character creator is now a full 6-step wizard matching the desktop app — Identity → Personality → Dialogue → Lorebook → Realism Engine → Review & Save.
- AI Creator Realism Step: The AI character creator now includes a dedicated Realism Engine configuration step with bond/trust sliders, time-of-day selector, and feature toggles.
- V2.5 character card extensions: Both creators embed Realism Engine configuration in exported character cards.
This release brings community-contributed fixes and features alongside Realism Engine tuning — primarily focused on API compatibility, macOS packaging, and UI polish.
🤝 Community Contributions — thanks to @willie
- System prompt role fix (#12): The system prompt is now sent with the proper
"system"role when using chat-completion APIs (OpenRouter, LM Studio, OpenAI-compatible backends). Previously it was incorrectly sent as a"user"turn, which caused some models to behave unexpectedly. - LM Studio streaming fix (#11): Fixed SSE streaming compatibility with LM Studio and added support for the
reasoning_contentfield returned by reasoning-capable models. - macOS RAG embedding server bundling (#10): The RAG embedding server (
embed_server) was not being copied into the macOS app bundle during CI builds. RAG Memory now works out of the box on macOS without requiring a manual source build. - Settings tab bar styling (#13): Fixed a dark overlay appearing behind the settings tab bar and corrected low-contrast text on the selected tab label.
- BYAF importer cache directory (#7): Fixed a crash when importing
.byafcharacter archives if the image cache directory did not yet exist on first launch. - pubspec.yaml version format (#8): Corrected an invalid semver string in
pubspec.yamlthat causedflutter pub getto warn on strict tooling setups.
🧠 Realism Engine — Evaluation Tuning
- Expanded the short-term emotional delta ranges so the engine can reflect larger mood and relationship shifts in a single turn when the narrative warrants it.
- Strengthened the justification guidance in evaluation prompts, requiring the model to ground large deltas in concrete story evidence rather than general sentiment.
⚙️ Stability
- Hardened the realism evaluation pipeline against race conditions during hot restarts and rapid message sequences.
- Improved KoboldCpp process lifecycle management to prevent orphaned processes on app restart.
🧠 Realism Engine — Prompt Overhaul
- Personality-aware evaluations: All eval prompts now receive the character's personality traits, relationship tension, and trust level — eliminating "generic NPC" responses.
- Emotion vocabulary guidance: Steered away from flat labels toward nuanced textures filtered through the character's personality.
- Spatial continuity: Posture evals now receive the character's current position, preventing teleportation between turns.
- Dramatic event inertia: Emotions now linger after high-impact narrative events instead of snapping back to neutral.
- Trust system rebalanced: Positive trust range expanded from +10 to +50, with guidance for extraordinary trustworthiness. Catastrophic betrayals are now balanced by the ability to earn trust through genuinely remarkable actions.
- Fixation injection rewritten: Fixations manifest as subconscious coloring (stray thoughts, loaded pauses) rather than the character awkwardly raising the topic.
- Relationship delta reframed: Changed from "tension shift" (negatively primed) to "warmth shift" (neutral framing) to reduce false negatives.
- Objective/fixation spam reduced: 90% of turns should produce "none" for proposed objectives; fixations now require persistent intrusive thoughts, not temporary reactions.
🎰 Chaos Mode — Timing Rework
- Integrated event flow: Chance Time now triggers before the character's response so they react to both the user's message and the chaos event in a single cohesive reply.
- Regen persistence: Chaos events persist through regenerations and swipes; cleared only when the user sends their next message.
- Stacking prevention: SPIN NOW button disables (shows ⏳ EVENT PENDING) while an event is queued.
⚙️ KoboldCpp Stability
- Thinking model support: Injected
ban_eos_tokenandtrim_stopinto generation payloads for stable streaming with reasoning models. - Server idle detection: Eval pipeline now calls
/api/extra/abortand waits for server idle before each request, eliminating dropped requests during heavy generation. - One-shot eval fix: Renumbered eval fields sequentially (1–10) to fix field-ordering confusion in local models.
🐛 Bug Fixes
- Fixed "Looking up a deactivated widget's ancestor" errors with a 150ms debounce on eval stream rebuilds.
- Fixed trust being penalized when the character (not the user) does something guilt-inducing.
- Fixed broken one-shot eval field numbering (fields 2 and 6 were skipped).
🎰 Chance Time — Chaos Mode
- Spinning wheel overlay — full animated roulette with emoji-themed segments, smooth easing curves, and a haptic-style bounce on landing.
- 175+ era-agnostic events across four categories: 🟢 Fortune, 🔴 Misfortune, 💛 Chaos, 💜 Wild Card — plus 35 slapstick events.
- Escalating pressure — 5% base chance per turn, growing +5% each turn without a trigger. Caps at 100%. After ~19 turns, Chance Time is guaranteed.
- No escape — once the overlay fires there is no X button, no back button, no tapping outside. The only exit is Accept Your Fate 🎲.
- Category-specific reveal animations — confetti burst (Fortune), red skull pulse (Misfortune), lightning strobe (Chaos), purple shimmer (Wild Card).
- Manual spin — SPIN NOW button in the sidebar for on-demand chaos.
🎨 Chance Time UI
- Gold-themed narration banners in chat history (🎰 centered card, distinct from normal messages).
- Animated wheel shrinks after landing to reveal the full result card without overflow.
- Pressure bar and percentage visible in both the sidebar and the overlay.
⏰ Deterministic Time Progression
- Fixed: time never moves / time jumps wildly. Time now advances on a fixed cadence: every 6 AI turns, the clock moves forward exactly one period.
- LLM veto only. The model is asked one binary question: is the scene mid-action right now? Hold or advance.
💬 OOC Time-Skip Detection
- Writing
(OOC: we drive for several hours)instantly moves the narrative clock before the AI responds. - The next AI response shows
⏩ Time skip: Eveningin the delta row alongside Bond/Trust/Mood chips.
🕐 Manual Time Nudge
‹and›chevrons flank theMon · Day 1sidebar label when Realism is enabled.
🐛 Bug Fixes
- Fixed GUI overflow when a cooldown badge appeared in the Enhancements header.
- Fixed realism baseline never being captured when enabling Realism after loading a character.
🧠 Realism Engine 2.1
- Emotion Inertia: Moods carry over between turns — small moments produce small drift, big moments require genuine cause.
- Trust-Based Behavioral Calibration: Surfaces more of the character's inner self as trust grows, filtered through their unique persona.
- Narrative Day-of-Week Tracking: Scene time reads
Wednesday Evening (Day 3). Anchored to the real-world day Realism was first enabled. - Post-Greeting Baseline Eval: Engine evaluates emotion and bond from the opening message before the user types anything.
🖥️ Realism Processing Overlay — Redesigned
- Animated pulsing orb, spinning halo, eval pill badges, smooth fade-in. Greeting evals use a purple "Reading the room..." mode.
📊 Sidebar
- Day-of-week visible (
Sun · Day 1). Active Fixation promoted above Realism. Smarter section expand defaults.
🖥️ Realism Engine Streaming UI
- Live glassmorphic overlay streams LLM eval tokens in real-time during emotional evaluations.
- Fixation Engine prompt priority lowered — active fixations feel ambient, not overriding.
✍️ Native Desktop Spell Checking
- macOS:
NSSpellCheckervia native method channel. Windows:ISpellCheckervia custom C++ plugin. Fixed a plugin registration crash reported by the community.
⚙️ Realism Engine 2.0
- Long-Term Relationship Scaling, Dynamic Trust Mechanics, Character Level-Up System.
- Collapsible sidebar modules, one-click character duplication, fault-tolerant AI generator with auto-retry.
🎭 Realism Engine 1.0
- Relationship & Tension System with visual tracking bars. Nuanced emotion wheel. Autonomous time progression with temporal guardrails.
- Context-grounded image prompts generated as the final creator step. Avatar art style selector in Quick Create. Linux CI build fixes.
- Local image generation (A1111, Forge, SDNext, Draw Things). Easy Mode Quick Create. World Lore RAG. Settings UI overhaul. Natural Language vs Danbooru Tags prompt mode. Avatar crop tool with canvas padding.
- Group chat fork from 1:1 conversations. Database power-failure protection (SQLite FULL sync + integrity check). Automatic rolling backups every 10 minutes.
- Platform-agnostic image paths. macOS auto-update fix. Cloud sync upgrade dialog fix. macOS Gatekeeper re-signing fix.
- RAG Memory — local semantic memory, Data Bank UI, RAG-grounded summaries. Character Evolution. User Persona Awareness. Objectives/Goals. Content toggle. Lorebook world-building focus.
- ElevenLabs TTS with configurable voice controls. Inline image rendering with security consent. WebUI mobile UX improvements.
- Database hard-delete optimization (334MB → 2MB). Cloud Sync overhaul. Database Reunification migration. Full-featured Web UI. Voice Call Mode. Chat Summary. AI Character Creator. Push-to-Talk (Whisper STT). AGPL-3.0 license.
- SQLite database backend (migrated from JSON). Row-level cloud sync merge engine with UUID primary keys. Backup management. Backyard AI (.byaf) importer. Director Mode. Cloud sync via Google Drive and Nextcloud/WebDAV.
- Group chat, TTS multi-engine support (Kokoro/OpenAI/Piper), grid scale slider, bulk PNG import, chat branching, per-character system prompts, Author's Note, context/token budget viewer, external API support (OpenRouter, Nano-GPT).
Built with 💙 using Flutter