Skip to content


Repository files navigation


Build Status Maintainability Requirements Status codecov

The objective of this project is to utilize social network analysis techniques to examine the relationships between actors on the Internet Relay Chat(IRC) social networking service. The IRCLogParser is an application that accepts IRC log files from different channels and parses them to analyse the principles of interaction between IRC users. Study of these interactions on different levels helps us in deriving the local and global communication patterns between users on different channels. Therefore, IRCLogParser draws its inspiration from various fields such as data mining, graph theory and inferential modeling in order to form predictive models that help in understanding certain intricate characteristics of a social network. This involves analyzing graphs with IRC users(nodes) and their connections(edges), to study the details about various network graph properties such as density, size, node centrality, degree, connectedness etc.


Follow the steps to install dependencies and IRCLogParser library:-

> git clone
> cd IRCLogParser
> sudo script/install

Ideally the installation takes not more than 10 minutes.


The library's working has been modularised into many modules namely input, analysis, output, visualisation and validation. The file very comprehensively presents how one can use IRCLogParser for parsing and analysis.

A page on typical workflow for using IRCLogParser also exists on the documentation here.

To run and test the sample program, execute in root directory : python


IRCLogParser uses Sphinx Python Documentation Generator for generating documentation of the library. The documentation is auto-generated from the commits made on the dev branch. Please see the online documentation.


IRCLogParser is available under the GPL v3.0