fediverse-graphs 0.9.0

Interface to download and interact with the Fediverse Graph Dataset

Python API to interact with the Fediverse Graph Dataset

This Python package provides a simple interface to interact with the Fediverse Graph dataset: https://www.kaggle.com/datasets/marcdamie/fediverse-graph-dataset/data. Our package automatically downloads the dataset from Kaggle and loads graphs in a usable format (i.e., NetworkX).

The Fediverse Graph dataset provides graphs for different decentralized social media. These graphs represents the interactions between servers in these decentralized social media. The graph type corresponds to the type of interactions modelled by the graph. Finally, the dataset provides the graphs obtained on different dates, so the users can analyze the evolution of the interactions.

Refer to this repository to discover more about the data acquisition.

Extracting a graph

Three pieces of information are necessary to select a graph in the datatset: the software/social media, the graph type, and the date.

We provide graphs using the NetworkX format.

Example:

    from fediverse_graphs import GraphLoader

    loader = GraphLoader()
    graph = loader.get_graph(software="peertube", graph_type="federation", date="20250324")
    graph = loader.get_graph(software="peertube", graph_type="federation") # Loads the most recent graph

Extracting graph metadata

Along with each graph, we also provide some metadata about the nodes composing the graph. Depending on the social media, the amount of information available varies.

We provide this information using a Pandas dataframes.

Example:

    from fediverse_graphs import GraphLoader

    loader = GraphLoader()
    graph = loader.get_graph_metadata(software="peertube", graph_type="federation", date="20250324")
    graph = loader.get_graph_metadata(software="peertube", graph_type="federation") # Loads the most recent graph

Utility functions

Finally, we provide a few utility functions:

    from fediverse_graphs import GraphLoader

    loader = GraphLoader()
    loader.list_all_software()
    loader.list_graph_types("peertube")
    loader.list_available_dates("peertube", "federation")