{"id":18746858,"url":"https://github.com/homeworkprod/chatrelater","last_synced_at":"2026-03-07T09:31:33.227Z","repository":{"id":32810382,"uuid":"36403083","full_name":"homeworkprod/chatrelater","owner":"homeworkprod","description":"Chat Relater analyzes chat (IRC, Jabber/XMPP, whatever) logs and generates GraphViz files to visualize the relations between the participants.","archived":false,"fork":false,"pushed_at":"2021-02-28T04:32:32.000Z","size":82,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-21T06:43:07.604Z","etag":null,"topics":["analysis","chat","data-visualization","graphviz","irc","python"],"latest_commit_sha":null,"homepage":"https://homework.nwsnet.de/releases/1856/#chat-relater","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/homeworkprod.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-27T23:53:02.000Z","updated_at":"2023-04-07T13:36:29.000Z","dependencies_parsed_at":"2022-09-12T00:51:42.573Z","dependency_job_id":null,"html_url":"https://github.com/homeworkprod/chatrelater","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/homeworkprod/chatrelater","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homeworkprod%2Fchatrelater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homeworkprod%2Fchatrelater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homeworkprod%2Fchatrelater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homeworkprod%2Fchatrelater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/homeworkprod","download_url":"https://codeload.github.com/homeworkprod/chatrelater/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homeworkprod%2Fchatrelater/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30210832,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T09:02:10.694Z","status":"ssl_error","status_checked_at":"2026-03-07T09:02:08.429Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analysis","chat","data-visualization","graphviz","irc","python"],"created_at":"2024-11-07T16:27:14.897Z","updated_at":"2026-03-07T09:31:33.178Z","avatar_url":"https://github.com/homeworkprod.png","language":"Python","readme":"Chat Relater\n============\n\n**Chat Relater** is a tool consisting of two command-line scripts:\n\n* The analyzer extracts user relations from chat logs. The gained data\n  is serialized as JSON.\n\n* The visualizer takes that data, generates a DOT_ file, and calls the\n  GraphViz_ application to render the graph in the requested output\n  format (e. g. PDF, PNG, SVG).\n\nIt is actually a conceptual clone of the PieSpy_ Social Network Bot.\nHowever, Chat Relater does not act as an IRC bot (although this could be\neasily accomplished by making use of the irc_ package), but therefore\nallows to be run on any logfiles that produce similar output to those\ncreated by XChat_. Of course, this includes logs from Jabber, SILC or\nany other communication (but it might require some minor changes to the\nlog reader).\n\nThe GraphViz_ usage is pretty basic and output may be improved somehow,\nbut so far, the graphs created by PieSpy_ look **much** nicer.\n\n\nRequirements\n------------\n\nPython_ 3.7 or later is required.\n\nChat Relater can be installed via pip:\n\n.. code:: sh\n\n    $ pip install ChatRelater\n\n\nTests\n-----\n\nInstall the test dependencies:\n\n.. code:: sh\n\n    $ pip install -r requirements-test.txt\n\nInstall the local source files as package in development mode:\n\n.. code:: sh\n\n    $ pip install -e .\n\nRun the tests:\n\n.. code:: sh\n\n    $ pytest\n\n\nUsage\n-----\n\nRun the analyzer on one or more log files, saving the intermediate\nresults to another file (``chat.json``):\n\n.. code:: sh\n\n    $ chatrelater-analyze -o chat.json chat_today.log chat_yesterday.log\n\nCreate a nice graph (using the 'twopi' program) from the results\n(``chat.json``) and save it to a PNG image (``graph.png``):\n\n.. code:: sh\n\n    $ chatrelater-visualize -f png -p neato chat.json chat\n\nAnd intermediate file containing the 'dot' description (``graph``) will\nbe created in the process.\n\n\n.. _DOT:        https://www.graphviz.org/doc/info/lang.html\n.. _GraphViz:   https://www.graphviz.org/\n.. _PieSpy:     http://www.jibble.org/piespy/\n.. _irc:        https://github.com/jaraco/irc\n.. _XChat:      http://www.xchat.org/\n.. _Python:     https://www.python.org/\n\n\n:Copyright: 2007-2021 `Jochen Kupperschmidt \u003chttps://homework.nwsnet.de/\u003e`_\n:License: MIT, see LICENSE for details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhomeworkprod%2Fchatrelater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhomeworkprod%2Fchatrelater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhomeworkprod%2Fchatrelater/lists"}