+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