whatisgithub

What is yozakura?

mistval/yozakura — explained in plain English

Analysis updated 2026-05-18

15TypeScriptAudience · vibe coderComplexity · 3/5Setup · moderate

In one sentence

An AI-driven social simulation game where characters move on a map, talk, and build memories of each other, forming an evolving story.

Mindmap

mindmap
  root((yozakura))
    What it does
      Character map simulation
      AI-driven dialogue
      Memories and opinions
      Evolving story
    Tech stack
      TypeScript
      Node.js
      Electron
      Docker
    Use cases
      Story generation
      Character sandbox
      Social simulation play
    Audience
      Vibe coders
      Hobbyist developers
      Narrative tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play a simulated character among dozens of AI-driven others that remember past encounters.

USE CASE 2

Generate an evolving narrative by watching AI characters interact and form opinions.

USE CASE 3

Experiment with a chosen LLM to drive character dialogue and decisions.

What is it built with?

TypeScriptNode.jsElectronDocker

How does it compare?

mistval/yozakuraaredotna/api-examplesceelog/openweread
Stars151515
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js and separate installs for client and server, or the Docker image.

So what is it?

Yozakura is a social simulation game powered by AI. Characters move around a map, talk to each other, and build memories and opinions about one another over time. You can play as one of those characters yourself. The AI drives the dialogue and decision-making for all the other characters, creating a story that changes based on who interacts with whom and what they remember from past encounters. The simulation can support anywhere from a small handful of characters up to dozens or even hundreds, all handled by a language model of your choice. Because the model drives each character's behavior independently, the narrative that emerges is not scripted: it evolves from the accumulation of individual conversations and memories. Installing Yozakura is straightforward. The project offers a downloadable Electron desktop app and a Docker image for users who just want to run it, with links to a getting-started guide in the documentation. Developers who want to dig into the code or contribute can clone the repository directly and run it locally with Node.js. The project includes both a production build mode and a development mode with hot reloading. The codebase is split into a client and a server, both written in TypeScript. Setup requires running an install command in each folder and then starting the server. Once running, the app is accessible in a browser at a local address. VS Code debugging configurations are included in the repository for people who want to step through the code. The project is new and actively developed. Bug reports go to GitHub Issues and feature requests go to Discussions. The author also maintains a Discord server for questions and community conversation.

Copy-paste prompts

Prompt 1
Help me install Yozakura using the Docker image and get it running locally.
Prompt 2
Walk me through setting up the client and server for Yozakura from a git clone.
Prompt 3
Explain how Yozakura characters form memories and opinions of each other.
Prompt 4
Show me how to set up VS Code debugging for the Yozakura server and client.

Frequently asked questions

What is yozakura?

An AI-driven social simulation game where characters move on a map, talk, and build memories of each other, forming an evolving story.

What language is yozakura written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Electron.

How hard is yozakura to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is yozakura for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.