Yozakura is an AI-powered social simulation in which characters (including the user) move around a map, interact with each other via the user's LLM of choice, and form memories and intentions towards each other, creating a dynamically evolving narrative with up to dozens or even hundreds of characters.

This article gives a brief peek at the main features of Yozakura via screenshots. There's also a YouTube video showing some of the same features in action (turn on subtitles).

Chat

During the user turn, choose one or more characters to chat with (below, Beatrix is the user in a three-way chat).

Memories

After each chat, NPC memories are updated. The memory system is designed for continuity and narrative momentum, and several different types of memory are maintained. You can read more about the memory system here.

NPC Chat

Once the user's turn is finished, NPCs each get a chance to move around the map or talk to other characters (including the user). If an image API is configured, images can be generated automatically as NPCs converse with each other. NPC chats appear in the UI while NPCs each take their turn. You can control how often NPCs chats happen and how long they last.

The user character is not privileged (unless you tweak certain settings). It's possible to play without a user character too, by running Yozakura in auto mode. You could sleep with it running and you might wake up with an interesting tale to read.

Import Characters

The character editor supports importing CharacterTavern/SillyTavern style character cards. Upload the card image and for best results, select "Convert" when it asks you what you want to do with it. It will use your LLM to re-write the character information to work better in Yozakura, while remaining true to the character's basic personality.

You can also of course create new characters from scratch.

The wardrobe system can automatically enable different combinations of image model tags each day.

Create Your Own Worlds

Maps in Yozakura are just a list of locations, their names, descriptions, and which other locations they are connected to. It's the character interactions that add all the color. You can create your own map in no time with the map editor.

Prompt Templates

Yozakura prompt templates can be edited and the templating system is very powerful. Context documents are generated automatically so you can upload them to a frontier LLM (Claude, ChatGPT, Gemini, etc...) to do the edits for you, which may be complex, depending on what you're going for. Read more about the templating system here.

Get Started

Continue to the getting started guide for installation instructions.