# hellodigua/chatlab

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/hellodigua-chatlab).**

4,522 stars · 1,136 forks · TypeScript · agpl-3.0

## Links

- GitHub: https://github.com/hellodigua/ChatLab
- Homepage: https://chatlab.fun
- awesome-repositories: https://awesome-repositories.com/repository/hellodigua-chatlab.md

## Topics

`ai` `chat-analysis` `chat-history` `data-analysis` `data-visualization` `electron` `nlp` `typescript`

## Description

ChatLab is a self-hosted chat database and data pipeline designed to normalize, store, and analyze large-scale social conversation histories. It functions as an analytics platform that uses large language models to extract patterns and insights from messaging data imported from multiple platforms.

The system distinguishes itself through an AI-powered analysis engine that utilizes vector-based history analysis and agent-based function calling to summarize conversation trends. It further identifies behavioral patterns by generating visual analytics, including heatmaps, word clouds, and activity rankings.

The platform handles high-volume data ingestion through multi-threaded stream processing and schema-based normalization to convert disparate export formats into a unified data model. It provides a headless API runtime and a command line interface for managing the application lifecycle as a background service.

Users can import conversation records via JSONL batch loading, programmatic ingestion, or scheduled push-pull synchronization.

## Tags

### Business & Productivity Software

- [Self-Hosted Analytics Platforms](https://awesome-repositories.com/f/business-productivity-software/self-hosted-analytics-platforms.md) — Provides a self-hosted analytics platform that normalizes, stores, and analyzes social conversation histories.

### Data & Databases

- [Chat Query Engines](https://awesome-repositories.com/f/data-databases/data-visualization-charts/natural-language-querying/natural-language-to-sql/chat-query-engines.md) — Uses large language models and agent-based function calling to answer natural-language questions about chat history through SQL translation.
- [Embedded SQL Query Engines](https://awesome-repositories.com/f/data-databases/sql-query-execution-engines/embedded-sql-query-engines.md) — Runs a SQL database entirely on the user's machine, enabling private querying and analysis without external data transfer.
- [AI-Enhanced SQL Chat Analyzers](https://awesome-repositories.com/f/data-databases/sql-query-execution-engines/embedded-sql-query-engines/ai-enhanced-sql-chat-analyzers.md) — Combines a SQL engine with AI agents to let users query, summarize, and extract patterns from their own messaging data. ([source](https://cdn.jsdelivr.net/gh/hellodigua/chatlab@main/README.md))
- [Stream Ingestion](https://awesome-repositories.com/f/data-databases/table-data-processing/stream-ingestion.md) — Processes large chat imports by streaming data through multiple worker threads to maintain responsiveness at scale.
- [Telegram Chat Importers](https://awesome-repositories.com/f/data-databases/json-data-import/telegram-chat-importers.md) — Imports chat history from Telegram using the official desktop export feature, accepting a machine-readable JSON file. ([source](https://docs.chatlab.fun/usage/how-to-export))

### Artificial Intelligence & ML

- [Local Chat Analysis Agents](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-application-frameworks/local-on-device-ai/local-chat-analysis-agents.md) — Executes AI-powered agents that process chat histories entirely on the user's machine for privacy. ([source](https://chatlab.fun))
- [AI-Powered Data Assistants](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-powered-data-assistants.md) — Lets natural-language questions be answered by an AI agent that translates them into SQL and returns insights from personal chat data. ([source](https://chatlab.fun/roadmap/tasks))
- [Chat Analysis](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-powered-observability-analysis/chat-analysis.md) — Uses large language models to query, summarize, and extract behavioral patterns from personal conversation records.
- [Chat History Exporters](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis/chat-history-exporters.md) — Imports chat records from WhatsApp, QQ, LINE, Discord, Instagram, Telegram, and iMessage for local analysis. ([source](https://docs.chatlab.fun/))
- [Chat Record Importers](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis/chat-record-importers.md) — Brings in chat history by dragging a file, connecting an external source for scheduled syncs, or pushing records through a local API. ([source](https://docs.chatlab.fun/usage/quick-start))
- [Local Chat Processing](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis/local-chat-archiving/local-chat-processing.md) — Keeps all chat history and analysis on the user's machine, never uploading private conversations to external services. ([source](https://chatlab.fun/roadmap/tasks))
- [SQL Analytics](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis/local-chat-archiving/sql-analytics.md) — Runs SQL queries and AI agents on private chat data to uncover trends and insights without sending data to external servers.
- [Chat Importers](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-platforms/chat-importers.md) — Parses and normalizes chat exports from WhatsApp, LINE, Telegram, Discord, Instagram, iMessage, and QQ into a consistent format.
- [Agent Tool Selection Pipelines](https://awesome-repositories.com/f/artificial-intelligence-ml/function-calling-interfaces/agent-tool-selection-pipelines.md) — Routes natural-language queries through an AI agent that selects from 24+ tools to search, summarize, and extract insights.
- [Vectorized Conversation Analysis](https://awesome-repositories.com/f/artificial-intelligence-ml/natural-language-processing-analysis/vectorized-conversation-analysis.md) — Embeds chat records into vector space to enable similarity search and pattern extraction across large conversation histories.
- [LINE Chat Importers](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis/chat-history-exporters/line-chat-importers.md) — Imports chat history from LINE using the official chat export feature, accepting a plain text file. ([source](https://docs.chatlab.fun/usage/how-to-export))
- [WhatsApp Chat Importers](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis/chat-history-exporters/whatsapp-chat-importers.md) — Imports chat history from WhatsApp using the official Export Chat feature, accepting a plain text file. ([source](https://docs.chatlab.fun/usage/how-to-export))
- [Headless API Runtimes](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis/headless-api-runtimes.md) — Ships a headless REST API runtime for querying, importing, and analyzing chat records from external tools.
- [CLI Lifecycle Managers](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis/headless-api-runtimes/cli-lifecycle-managers.md) — Operates as a background service with a REST API and command-line interface for managing the application lifecycle.
- [Large-Scale Chat Processors](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis/large-scale-chat-processors.md) — Stream-parses and multi-worker processes chat imports to keep analysis responsive even at million-message scale. ([source](https://cdn.jsdelivr.net/gh/hellodigua/chatlab@main/README.md))
- [Large-Scale Local Chat Processors](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis/local-chat-archiving/large-scale-local-chat-processors.md) — Uses stream parsing and multi-worker processing to keep imports and analysis responsive even at million-message scale. ([source](https://cdn.jsdelivr.net/gh/hellodigua/chatlab@main/README.md))

### Development Tools & Productivity

- [Playlist Importers and Exporters](https://awesome-repositories.com/f/development-tools-productivity/playlist-managers/playlist-importers-and-exporters.md) — Parses and normalizes chat exports from seven platforms into a unified model for consistent analysis. ([source](https://cdn.jsdelivr.net/gh/hellodigua/chatlab@main/README.md))
- [Chat Data Query APIs](https://awesome-repositories.com/f/development-tools-productivity/rest-apis/chat-data-query-apis.md) — Provides a local REST API for querying, importing, and analyzing chat data from external tools. ([source](https://docs.chatlab.fun/))
- [Chat Trend Visualizers](https://awesome-repositories.com/f/development-tools-productivity/project-history-navigation/git-history-navigation/activity-trend-visualizers/chat-trend-visualizers.md) — Displays time patterns, interaction frequency, word clouds, and activity rankings from imported conversation histories.

### Networking & Communication

- [Chat Data Normalizers](https://awesome-repositories.com/f/networking-communication/chat-data-normalizers.md) — Imports and normalizes chat exports from multiple platforms into a unified data model.
- [Chat Data Pipelines](https://awesome-repositories.com/f/networking-communication/chat-data-normalizers/chat-data-pipelines.md) — Imports, normalizes, and stores chat histories from multiple platforms into a unified local database for analysis.
- [iMessage Chat Importers](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/messaging-platform-integrations/imessage-integrations/imessage-chat-importers.md) — Imports chat history from iMessage on macOS using a dedicated export tool that produces a standard JSON file. ([source](https://docs.chatlab.fun/usage/how-to-export))
- [Instagram Chat Importers](https://awesome-repositories.com/f/networking-communication/data-import/instagram-chat-importers.md) — Imports chat history from Instagram using the official data download feature, accepting a JSON file. ([source](https://docs.chatlab.fun/usage/how-to-export))
- [Discord Chat Importers](https://awesome-repositories.com/f/networking-communication/discord-integrations/discord-chat-importers.md) — Imports chat history from Discord using a JSON file exported by the DiscordChatExporter tool. ([source](https://docs.chatlab.fun/usage/how-to-export))

### Security & Cryptography

- [Privacy-Preserving Processing](https://awesome-repositories.com/f/security-cryptography/privacy-preserving-processing.md) — Keeps all chat history and analysis on the user's machine with no cloud upload of raw conversations.
- [Local Chat Data Storage](https://awesome-repositories.com/f/security-cryptography/private-data-privacy-tools/local-chat-data-storage.md) — Stores all chat data and settings locally without requiring any cloud upload of raw conversations. ([source](https://cdn.jsdelivr.net/gh/hellodigua/chatlab@main/README.md))

### Software Engineering & Architecture

- [Chat Data Pipelines](https://awesome-repositories.com/f/software-engineering-architecture/local-first-tool-processing/chat-data-pipelines.md) — Provides a local-first data pipeline with stream parsing and multi-worker processing for chat history analysis.

### Part of an Awesome List

- [Conversation Heatmaps](https://awesome-repositories.com/f/awesome-lists/data/heatmap-visualization/conversation-heatmaps.md) — Generates heatmaps, word clouds, activity rankings, and trend charts from imported conversation records.
