Chat Hackers is a collaboration between Campaign Lab and John Evans to build tools for group chats used in political organising.

Instructions for using the tools can be found on chathackers.uk

We have several repositories supporting the project.

The Tool Hub manages the connection to group chats and forwards events to the tools that have been activated for a particular group chat.

The hub also provides the chathackers website.

The Welcome Tool provides a welcome message that is sent when someone new joins the chat. The code demonstrates a tool reacting to "membership events".

The Events Tool stores events that are linked to in the group and send reminders as the event time approaches. The code demonstrates a tool listening to an external source of events.

The Publish Tool allows a message to be sent to the web from a group chat. The code demonstrates a tool providing a public api that can be used externally.

The Trello Tool allows a message to be turned into a card on a Trello board and assigned to someone. The code demonstrates a tool integrating with an existing external platform.

The Example Tool is a demonstration of how to interact with messages, including keywords, replies and emoji reactions. This is an ideal codebase to read for developers new to the project who want to understand how it works. Development of new tools typically starts by forking the example tool.

The Docker Deployment makes it easier to deploy the tools to a server managed by the matrix-docker-ansible-deploy playbook.

Newspeak House and Space4 for the use of their space to host hack days for the project.