Skip to content

ChatLab

ChatLab is a free, open-source, local-first chat history analysis tool. It supports importing records from WhatsApp, QQ, LINE, Discord, Instagram, Telegram, and iMessage, and offers visual analytics and AI-powered conversation features — with all data stored locally, never uploaded to the cloud.

How to Use ChatLab

  • Introduction — Learn what ChatLab is and what it can do.
  • Quick Start — Step-by-step guide to installing ChatLab and importing your first chat records.
  • Export & Import — Export chat records from WhatsApp, QQ, LINE, and other platforms and import them into ChatLab.
  • Configure AI — Connect OpenAI, Claude, DeepSeek, or other AI models to analyze your chat history in natural language.
  • Troubleshooting — Fix common issues with failed imports, unsupported formats, and AI configuration errors.

For Developers: Integrating with ChatLab

  • API & Standards — ChatLab's local REST API for querying, importing, and analyzing chat data from external tools.
  • ChatLab Format — The open chat data interchange format for cross-platform data compatibility.
  • Push Import Protocol — Push external chat data into ChatLab via HTTP.
  • Pull Data Source Protocol — Expose standard HTTP endpoints so ChatLab can pull remote chat data on demand.
  • AI Conversion Guide — Use AI to convert unsupported chat export formats into ChatLab Format.

Contributing

  • Development Guide — Local development setup, repo structure, architecture boundaries, and PR guidelines for ChatLab.

More

  • Website & Roadmap — Download ChatLab desktop app or CLI, view the product roadmap, and find community links.