Skip to main content

Conversational Analytics and Plotting Library

Project description


Sentiment analysis and charting library supporting Messenger data dumps

Converse is a flexible charting library in python that makes sentiment analysis and charting easier. The aim is to provide strong functionality out of the box with minimal code while being configurable enough to support larger projects.

Getting Started

pip install converse

That's all, really. For a full walkthrough of the basic features, look here - Converse: An easy sentiment analysis library for Messenger - or in docker/messages/Demo.ipynb. For a ready-to-go installation with a (really small, faked) conversation, run:

docker pull hrishioa/converse


Converse currently supports only facebook messenger (Whatsapp dump support is planned).

  1. The first step is to download your chat data (use one of these guides to do so - make sure to pick JSON over HTML as the format), and unzip the archive. Converse is completely offline (even for plotting), and all your information is local.

  2. Create new jupyter notebook (ideally in the messages directory) with

    jupyter notebook
  3. The following piece of code should have you up and plotting:

    from converse import Conversation
    from tqdm import tqdm_notebook as tqdm
    from plotly.offline import init_notebook_mode, iplot
    convo = Conversation()
    convo.load("path-to-message.json") # structure is usually archive-root/convo-name/message.json

Built With


This project is licensed under GPLv3.

This project was cobbled together from tools built by the author in a weekend to do some standard sentiment analysis. Still very much in alpha, maybe even pre-alpha. Do submit any issues or problems, I'll do my best to patch!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

converse-0.1a5.tar.gz (5.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page