Discover insights from your chat conversations
Chat Analysis is a powerful Python tool designed to analyze chat conversations exported from messaging applications like WhatsApp. It processes chat text files, extracts meaningful insights, and generates beautiful visualizations including word clouds, frequency analysis, and time-based patterns.
Whether you want to understand your communication patterns, discover your most used words, or explore conversation trends over time, Chat Analysis provides a comprehensive suite of analytical tools wrapped in an intuitive web interface.
Analyze word frequency, discover your most used words, and generate beautiful word clouds from your conversations.
Explore messaging patterns by hour, day, and week. Understand when you're most active in your conversations.
Compare messaging activity between different participants and analyze response times and engagement patterns.
Interactive charts and graphs including heatmaps, timelines, and distribution charts for comprehensive data exploration.
Filter analysis by author, date range, or keywords to focus on specific conversations or time periods.
Compare multiple chat conversations side-by-side to discover patterns across different groups or contacts.
The project is built using modern Python technologies and web frameworks:
The project follows a clean, modular architecture:
src/data/ - Data import, cleaning, and transformation modulessrc/analysis/ - Analysis operations for words and time patternssrc/config/ - Configuration management and settingssrc/utils/ - Utility functions for logging and file operationstemplates/ - HTML templates for the web interfacestatic/ - CSS stylesheets and JavaScript filestests/ - Comprehensive test suiteYour data stays local. All processing happens on your machine. Chat files are never sent to external servers or third-party services. The application runs entirely on your local computer, ensuring complete privacy and security of your conversations.
You can review the source code to verify that no data is transmitted externally. All analysis is performed locally using open-source libraries.
The tool is highly customizable through the config.yaml file. You can configure:
Ready to analyze your chats? Here's how to get started:
pip install -r requirements.txtpython app.pyhttp://localhost:5000This project is open source and welcomes contributions! Whether you want to add new features, improve existing functionality, or fix bugs, your contributions are appreciated.
To contribute: