Skip to content
Projects

mistval/yozakura

View on GitHub

mistval/yozakura has 41 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 01:53 UTC. Last push 2026-11-13.

How these counts are measured

41 stars2 Forks

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

An LLM-powered social simulation and roleplaying engine where NPCs have their own lives too.

AI

README.md

Original

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. Read more about core features here.

Installation

If you want to use Yozakura, head to the getting started guide for download and installation instructions for the Electron app or Docker image.

If you want to contribute, tinker, or you just prefer the git clone installation method, continue reading below.

Requirements

Quick Start

If you want to run a production build and use the application, run these commands after installing Node.js and Git:

git clone https://github.com/mistval/yozakura.git
cd yozakura
git checkout main
npm install --prefix client
npm install --prefix server
npm run build:web
npm run start --prefix server

Then go to http://localhost:3001/ in your browser.

Dev Setup

If you want to run Yozakura in dev mode, then after cloning, run:

npm install
npm install --prefix client
npm install --prefix server
npm run dev

This runs the server and the client concurrently with hot reloading.

That should be all you need to do to get it running. Navigate to http://localhost:5173/ in your browser to see the app.

Debugging in VS Code

To debug both the server and the client from within VS Code, the repo ships two VS Code launch configurations in .vscode/launch.json:

  1. Start the server in debug mode — run the Debug Server launch configuration. This starts the server with the Node debugger attached.
  2. Start the client — run the client with npm run dev --prefix client.
  3. Attach to the client — run the Debug Client launch configuration, which opens Chrome against the running client and attaches the debugger.

Bugs and Feature Requests

Please submit features requests to Discussions and bug reports to Issues.

You can also join my Discord for either purpose or others.