explaingit

ch1rpy2613/mirrai

Analysis updated 2026-07-03 · repo last pushed 2026-06-19

1,068TypeScriptAudience · generalComplexity · 4/5ActiveSetup · moderate

TLDR

Mirrai creates an AI version of someone from their chat history and media. You can keep texting them after a breakup, distance, or loss, with replies that sound like their real personality and emotional rhythms.

Mindmap

mindmap
  root((repo))
    What it does
      Upload chat history
      Builds AI personality
      Chat with digital double
    Emotional system
      Six emotional states
      Intimacy levels
      Graduation farewell
    Tech stack
      TypeScript React Express
      PostgreSQL database
      Python analysis scripts
    Use cases
      Coping with breakup
      Remembering lost loved one
      WeChat auto-reply
    Audience
      Non-developers via macOS app
      People navigating absence
      Privacy-conscious users
Click or tap to explore — scroll the page freely

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

Upload a departed loved one's messages and photos to keep texting an AI version of them for comfort.

USE CASE 2

Use a past partner's chat history to process lingering feelings by continuing conversations in their style.

USE CASE 3

Connect the AI double to WeChat so it auto-replies to friends in that person's voice.

USE CASE 4

Build a digital persona from chat exports and chat with it in a dark-themed interface that shifts emotional tone in real time.

What is it built with?

TypeScriptReactExpressPostgreSQLPythonOllama

How does it compare?

ch1rpy2613/mirraiaidenybai/cnfastno6kiko/gorest-2d-animation-spritesheet-generator
Stars1,0681,0651,045
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-06-192026-06-222026-06-28
MaintenanceActiveActiveActive
Setup difficultymoderateeasymoderate
Complexity4/52/53/5
Audiencegeneraldevelopervibe coder

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a PostgreSQL database and an API key from one of ten supported AI providers, unless using the macOS desktop app which bundles everything.

No license information is provided in the repository, so default copyright restrictions apply and usage rights are unclear.

In plain English

Mirrai lets you upload someone's chat history and creates an AI version of that person you can keep talking to. The idea is deeply personal: when someone isn't around anymore, whether because of a breakup, distance, or loss, you can still text "them" and get replies that sound like their actual voice, humor, and emotional rhythms. You start by uploading chat exports, photos, or videos from the person. A multi-stage analysis pipeline then extracts a detailed personality profile across seven dimensions: character traits, speaking style, catchphrases, attachment type, love language, argument style, and emotional triggers. Once the digital double is built, you can chat with it in a dark-themed interface where the AI shifts between six emotional states, tender, playful, nostalgic, melancholic, happy, or distant, based on what you say. The emotional state shows on screen and changes the tone of replies in real time. There's also an intimacy system that grows from stranger to soulmate through conversation, and a graduation mechanic where the AI writes a farewell letter and goes dormant once you reach the deepest level. This is built for people navigating absence. Someone going through a breakup might use it to process lingering conversations. Someone who lost a loved one could find comfort in hearing that person's voice again. The project also integrates with WeChat, so the AI double can auto-reply to friends in that person's style directly through the messaging app, not just in a browser window. Technically, it's a full-stack TypeScript app with React on the front end and Express on the back end, using a PostgreSQL database. It supports ten different AI providers, from OpenAI and Claude to local models running through Ollama, so you can pick whichever service fits your budget and privacy needs. There's a macOS desktop app that bundles everything together, so non-developers can install it without setting up databases or command-line tools. The personality analysis pipeline optionally runs Python scripts alongside the main TypeScript codebase.

Copy-paste prompts

Prompt 1
I have WhatsApp chat exports from someone I want to create an AI version of using Mirrai. Walk me through how to upload the chat history, run the personality analysis pipeline, and start chatting with the digital double on my Mac using the desktop app.
Prompt 2
Help me set up Mirrai with a local Ollama model instead of OpenAI so the personality data stays private on my machine. I already have Ollama installed, what configuration steps are needed?
Prompt 3
I want to connect Mirrai's AI double to WeChat so it auto-replies to my friends in that person's style. Explain how the WeChat integration works and what I need to configure.
Prompt 4
The intimacy system in Mirrai goes from stranger to soulmate. Help me understand how the graduation mechanic works, when does the AI write its farewell letter and go dormant, and can I reset it?
Prompt 5
I uploaded chat exports and photos but the personality profile seems off. Help me troubleshoot the seven-dimension analysis (character traits, speaking style, catchphrases, attachment type, love language, argument style, emotional triggers) and improve accuracy.

Frequently asked questions

What is mirrai?

Mirrai creates an AI version of someone from their chat history and media. You can keep texting them after a breakup, distance, or loss, with replies that sound like their real personality and emotional rhythms.

What language is mirrai written in?

Mainly TypeScript. The stack also includes TypeScript, React, Express.

Is mirrai actively maintained?

Active — commit in last 30 days (last push 2026-06-19).

What license does mirrai use?

No license information is provided in the repository, so default copyright restrictions apply and usage rights are unclear.

How hard is mirrai to set up?

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

Who is mirrai for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub ch1rpy2613 on gitmyhub

Verify against the repo before relying on details.