explaingit

in30mn1a/lumimuse

Analysis updated 2026-05-18

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

TLDR

A self-hosted AI companion app for creating persistent, memory-driven characters you chat with privately on your own machine.

Mindmap

mindmap
  root((LumiMuse))
    What it does
      Custom AI characters
      Persistent memory
      Private self-hosted chat
    Tech stack
      Next.js
      TypeScript
      SQLite
      Docker
    Use cases
      Build a companion character
      Generate character images
      Keep data on your device
    Audience
      Vibe coders
      Privacy focused users
    Setup
      Bring your own API key
      Optional image service
      Docker deployment

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

Build a custom AI character with its own personality and backstory to chat with.

USE CASE 2

Run a private AI companion where all data stays on your own device.

USE CASE 3

Generate character images through your own Stable Diffusion, NovelAI, or ComfyUI setup.

USE CASE 4

Self-host a chat app that remembers facts about you across sessions.

What is it built with?

TypeScriptNext.jsReactTailwind CSSSQLiteDocker

How does it compare?

in30mn1a/lumimuseavacocloud/avaco-denodoorman11991/budget-aware-mcp
Stars191919
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity3/53/53/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 · 1h+

Requires your own OpenAI-compatible API key and, for images, a separate image generation service.

In plain English

LumiMuse is a self-hosted AI companion application that lets you create customizable characters to chat with over time. Rather than a generic chatbot, each character you build has its own personality, backstory, opening greeting, and example dialogue. The system keeps a persistent memory that grows through your conversations, so the character gradually "remembers" facts about you and your relationship history across sessions. When you chat, the app can generate images of the character using external image-generation services you connect yourself, such as Stable Diffusion, NovelAI, or ComfyUI. It streams AI responses in real time, lets you edit or regenerate messages, and supports attaching images and text files as context. Memory extraction runs in the background according to rules you configure, for example after every few messages or when certain keywords appear, and those memories are injected back into future conversations so the character stays consistent. You would use LumiMuse if you want a private, locally stored AI companion experience where your data never leaves your own machine or server. All characters, chats, and memories are saved in a SQLite database file on your device, and the application connects only to AI API endpoints you supply. It is built with Next.js and React on TypeScript, uses Tailwind CSS for styling, and runs through Docker for server deployment. You need to bring your own OpenAI-compatible model API key to drive the conversations. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Walk me through deploying LumiMuse with Docker and connecting my own API key.
Prompt 2
Explain how LumiMuse's memory extraction and injection system works.
Prompt 3
Show me how to connect an image generation service like Stable Diffusion to LumiMuse.
Prompt 4
How is character and chat data stored locally in LumiMuse's SQLite database?

Frequently asked questions

What is lumimuse?

A self-hosted AI companion app for creating persistent, memory-driven characters you chat with privately on your own machine.

What language is lumimuse written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, React.

How hard is lumimuse to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is lumimuse for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.