ChatLab /ChatLab

Local-first chat history analyzer with AI. | 本地优先的 AI 聊天记录分析工具

★ 7,617⑂ 1,544👁 18▤ 83
TypeScriptCreated 2025-11-26chatlab.fun
+0
Daily
+0
Weekly
+100
Monthly
7,617
stars
1,544
forks
18
watchers
–
prs
–
issues
83
releases

README

Your chat history, finally yours.

English | 简体中文

Official Website · Docs · Quick Start · Roadmap · Releases



ChatLab is an open-source desktop app for understanding your social conversations. It combines a flexible SQL engine with AI agents so you can explore patterns, ask better questions, and extract insights from chat data, all on your own machine.

Currently supported: WhatsApp, LINE, QQ, Discord, Instagram, Telegram, iMessage, and Google Chat. Coming next: Messenger and KakaoTalk.

 New install? Start here: Getting started

 Core Features

- 🚀 Built for large histories: Stream parsing and multi-worker processing keep imports and analysis responsive, even at million-message scale.
- 🔒 Private by default: Your chat data and settings stay local. No mandatory cloud upload of raw conversations.
- 🤖 AI that can actually operate on data: Agent + Function Calling workflows (24+ tools) can search, summarize, and analyze chat records with context.
- 📊 Insight-rich visual views: See trends, time patterns, interaction frequency, rankings, and more in one place.
- 🧩 Cross-platform normalization: Different export formats are mapped into a unified model so you can analyze them consistently.

 Installation

 Desktop App

Download the installer for your OS from the official website or GitHub Releases, then double-click to install.

 CLI

Requires Node.js ≥ 20.

bash
npm i chatlab-cli -g


Start ChatLab:

bash
clb web             Start API + Web UI, auto-open in browser
clb web --no-open   Start API + Web UI, skip auto-open
clb web --headless  API only, no Web UI (for scripts / AI Agents)


Common options: --port  (default 3110), --host , --token .

To run as a persistent background service (auto-start on login + auto-restart on crash):

bash
clb web --daemon    Install as system service (macOS / Linux)
clb status            Check service status
clb stop              Stop and uninstall service


For a full walkthrough, see the Quick Start guide.

 Usage Guides

- Download Guide
- Chat Record Export Guide
- Standardized Format Specification
- Troubleshooting Guide

 Preview

For more previews, please visit the official website: chatlab.fun

!Preview Interface

 Architecture Overview

ChatLab is a pnpm monorepo built on Electron + Vue 3 + Nuxt UI + Tailwind CSS. Core business logic lives in shared packages (@openchatlab/core, @openchatlab/node-runtime, @openchatlab/tools), consumed by both the desktop app and the CLI service — so they stay in sync.

Data flows in five stages: format detection → stream parsing → local persistence → SQL + AI query → visualization.

For a deep dive, see the architecture documentation.

 Architecture Principles

- Local-first by default: Raw chat data, indexes, and settings remain on-device unless you explicitly choose otherwise.
- Streaming over buffering: Stream-first parsing and incremental processing keep large imports stable and memory-efficient.
- Composable intelligence: AI features are assembled through Agent + Tool Cal

Snapshot: 2026-11-04T14:00:00Z · Data license Apache-2.0 · JSON