Skip to main content

Conversational Analytics and Plotting Library

Project description

Converse

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

Quickstart

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
    
    init_notebook_mode(connected=True)
    convo = Conversation()
    convo.load("path-to-message.json") # structure is usually archive-root/convo-name/message.json
    iplot(convo.plot())
    

Built With


License


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.

Filename, size & hash SHA256 hash help File type Python version Upload date
converse-0.1a5.tar.gz (5.1 kB) Copy SHA256 hash SHA256 Source None Jul 31, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page