git404hub

what is weloom fr?

clearyss/weloom — explained in plain English

Analysis updated 2026-05-18

16PythonAudience · developerComplexity · 3/5Setup · moderate

tl;dr

A local-first tool that turns exported chat history into a searchable memory system and an AI companion that talks in that person's style.

vibe map

mindmap
  root((repo))
    What it does
      Local chat memory system
      AI companion clone
      Five stage pipeline
    Tech stack
      Python
      SQLite FTS5
      OpenAI compatible API
    Use cases
      Search past chats
      Generate relationship reports
      Chat with AI clone
    Audience
      Developers
      Personal data hobbyists

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 make with this?

VIBE 1

Import your WeChat or QQ chat exports to build a searchable local archive of past conversations.

VIBE 2

Generate long-form reports summarizing communication patterns in a relationship.

VIBE 3

Chat with an AI companion that responds in the style of a specific person from your exports.

what's the stack?

PythonSQLiteFTS5

how it stacks up fr

clearyss/weloom920linjerry-stack/capital-studioadya84/ha-world-cup-2026
Stars161616
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/53/52/5
Audiencedeveloperresearchergeneral

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

how do i run it?

Difficulty · moderate time til it works · 30min

Needs Python 3.10 and an OpenAI-compatible API key for chat and report features.

in plain english

WeLoom is a Python tool that turns your personal chat history into a local-first memory system and AI companion. You export conversations from messaging platforms, feed them into WeLoom, and can then chat with an AI that responds in the style of the person whose messages were in those exports, a digital clone built from real conversation data. The pipeline runs in five stages: import (load chat JSON files into a local SQLite database), index (build a full-text search index using SQLite's FTS5 engine), distill (extract reply samples and build a personality profile), analyze (generate long-form reports summarizing the relationship and communication patterns), and chat (run a conversation session where the AI uses the indexed memories and personality profile to reply authentically). All data, the database, profile, reports, and cache, is stored locally in a storage folder. The AI model calls out to an OpenAI-compatible API only when you explicitly run commands that need it. Search is done with SQLite FTS5 (a built-in full-text search engine), with fallbacks to keyword matching and LIKE queries if FTS5 is not available. The system retrieves relevant past messages as evidence before generating each reply, and you can pass a flag to see the retrieval trace for any response. It currently supports chat exports in WeChat (via WeFlow) and QQ (via QQChatExporter V5) JSON formats. The only hard dependencies are Python 3.10 and SQLite, both standard. An AI API key is required only for report generation and chat. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
Walk me through exporting my WeChat chats and importing them into WeLoom.
prompt 2
Explain what happens at each of the five pipeline stages: import, index, distill, analyze, chat.
prompt 3
Show me how to connect WeLoom to an OpenAI-compatible API for chat and report generation.
prompt 4
Help me set up SQLite FTS5 search over my imported chat history.

Frequently asked questions

what is weloom fr?

A local-first tool that turns exported chat history into a searchable memory system and an AI companion that talks in that person's style.

What language is weloom written in?

Mainly Python. The stack also includes Python, SQLite, FTS5.

How hard is weloom to set up?

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

Who is weloom for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.