Create beautiful Spotify Wrapped-style visualizations for your WhatsApp group chats!

✨ Features

| | | | |:---:|:---:|:---:| | 📈 Rich Analytics | 🎨 Interactive Charts | 👥 User Insights | | Message counts, patterns & emoji stats | Beautiful Plotly visualizations | Top contributors & activity sparklines | | 📅 Calendar Heatmaps | 📄 Multiple Formats | 🔒 100% Private | | Year-at-a-glance activity view | HTML (Desktop), Static HTML (Mobile) | All processing stays on your device |

🚀 Get Started in 60 Seconds

Option 1: Google Colab (Recommended)

Zero installation required — just upload your chat and get your report!

Option 2: Local Installation

# 1. Clone the project
git clone https://github.com/Duelion/whatsapp-wrapped.git && cd whatsapp-wrapped
2. Generate your report (uv auto-installs dependencies)
uv run whatsapp-wrapped your-chat.zip

💡 Don't have uv? Install it: curl -LsSf https://astral.sh/uv/install.sh | sh (macOS/Linux) or irm https://astral.sh/uv/install.ps1 | iex (Windows)

Available Options:

• --name "My Group 2024" - Custom report name and title displayed in the report
• --year 2024 - Filter messages to a specific year
• --static - Generate mobile-friendly static HTML (requires optional static dependencies)
• --output reports/ - Custom output directory
• --quiet - Suppress progress messages
• --help - Show all available options

Optional: Static HTML Generation

For mobile-friendly reports that work without JavaScript, install the optional static HTML dependencies:

# Install with static HTML support
uv pip install -e ".[static]"
Install Playwright's WebKit browser
uv run playwright install webkit

The --static flag will then generate a pre-rendered HTML file perfect for mobile devices.

💡 Note: On Linux, Playwright may require system dependencies. If you see a warning about missing dependencies, run: sudo playwright install-deps webkit

📱 How to Export Your WhatsApp Chat

• Open WhatsApp → Go to your group chat
• Tap the group name → More → Export chat
• Choose "Without Media" for faster processing
• Save the .zip file and use it with WhatsApp Wrapped!

🔒 Privacy First

Your conversations never leave your device. WhatsApp Wrapped:

• ✅ Runs entirely offline (after install)
• ✅ Never uploads or shares your data
• ✅ Generates reports locally

📦 Installation Options

Basic Installation (Recommended)

The basic installation includes everything you need for interactive HTML reports:

# Using pip
pip install git+https://github.com/Duelion/whatsapp-wrapped.git
Using uv (faster)
uv pip install git+https://github.com/Duelion/whatsapp-wrapped.git

With Optional Features

Static HTML Generation - For mobile-friendly reports without

pip install "git+https://github.com/Duelion/whatsapp-wrapped.git#egg=whatsapp-wrapped[static]"
playwright install webkit

Development - For contributors:

pip install "git+https://github.com/Duelion/whatsapp-wrapped.git#egg=whatsapp-wrapped[dev]"

Report Bug · Request Feature · ⭐ Star this project

Made with ❤️ for WhatsApp users who love data