This project provides a web-based system for analyzing WeChat chat logs, offering advanced search, AI-driven insights, and data visualization. It targets users who need to extract meaningful information from their chat histories, benefiting from a modern interface and powerful analytical capabilities.

How It Works

Built with Node.js and Express, the system processes WeChat chat logs, which must first be obtained and decrypted via the separate Chatlog application. It employs multi-dimensional search filters (time, contact, keywords) and integrates with AI models like DeepSeek and Gemini for content analysis and insight generation. Data is presented through interactive charts and statistical reports, with features like scheduled analysis and data export.

Quick Start & Requirements

• Installation: Run npm install to install dependencies.
• Execution: Use ./start.sh (macOS/Linux) or start.bat (Windows) for one-click start, or npm start for manual service startup. Access the web UI at http://localhost:3000.
• Prerequisites:
  • Chatlog application installed and running (chatlog server on port 5030).
  • WeChat chat data decrypted using chatlog key and chatlog decrypt.
  • Node.js v18.0.0+ and npm v8.0.0+.
  • Network access to AI services (DeepSeek, Gemini).
• Documentation: Quick start guides and detailed project documentation are available within the repository.

Highlighted Details

• Intelligent search supporting time ranges, contacts, and keywords.
• AI analysis capabilities leveraging DeepSeek and Gemini models with custom prompts.
• Comprehensive data visualization, including charts, keyword clouds, and activity analysis.
• One-click export of chat records to text files.
• Responsive design ensures usability across desktop and mobile devices.

Maintenance & Community

The project welcomes contributions via Issues and Pull Requests, following standard GitHub workflows. The latest update (v2.7.0, 2025-01-21) indicates active development, with recent improvements to tooltips and Chatlog service connection mechanisms.

Licensing & Compatibility

This project is licensed under the MIT License, which permits broad use, modification, and distribution, including for commercial purposes and integration into closed-source applications.

Limitations & Caveats

The system has a strict dependency on the Chatlog application for data acquisition and decryption, requiring a separate running chatlog server process. AI analysis necessitates network connectivity and may incur costs associated with API usage. Image display is contingent on correctly configured Chatlog media file paths.