Skip to content


Repository files navigation

Tweet Archives Unleashed Toolkit (twut)

codecov Maven Central LICENSE Contribution Guidelines

An open-source toolkit for analyzing line-oriented JSON Twitter archives with Apache Spark.


Getting Started


Spark Shell

$ spark-shell --packages "io.archivesunleashed:twut:0.0.4"


You can download the latest release files here and include it like so:

Spark Shell

$ spark-shell --jars /path/to/twut-0.0.4-fatjar.jar


$ pyspark --py-files /path/to/

You will need the PYSPARK_PYTHON and PYSPARK_DRIVER_PYTHON environment variables set.

Documentation! Or, how do I use this?

Once built or downloaded, you can follow the basic set of recipes and tutorials here.


Licensed under the Apache License, Version 2.0.


This work is primarily supported by the Andrew W. Mellon Foundation. Other financial and in-kind support comes from the Social Sciences and Humanities Research Council, Compute Canada, the Ontario Ministry of Research, Innovation, and Science, York University Libraries, Start Smart Labs, and the Faculty of Arts and David R. Cheriton School of Computer Science at the University of Waterloo.

Any opinions, findings, and conclusions or recommendations expressed are those of the researchers and do not necessarily reflect the views of the sponsors.