Imok is a simple bot to support people undertaking potentially risky activities. It's aimed at community groups who support these vulnerable people.
The bot lets users 'check in' to the service with an SMS or messaging app. If users don't 'check out' after 30 minutes (for example), it will raise an alarm in a Telegram groupchat.
Example use cases are:
- Supporting protestors at risk of arrest or kidnapping
- Supporting women and LGBTQ+ people walking home at night, or going on dates
- Supporting journalists or medical staff in warzones
- Supporting asylum seekers through 'signing in' processes (see #AbolishReporting on Twitter).
Imok is currently optimised for the latter use case. It is a collaboration between No Borders Manchester and Geeks for Social Change that emerged from the Resistance Lab collective.
We do not currently offer a public instance of imok, and so you will need to set up your own server to use it. The target audience is therefore local mutual aid and community support groups with the capacity and confidence to run a web service.
We currently support SMS and Telegram. WhatsApp is theoretically supported but requires a WhatsApp Business API account, which we do not have.
Please note that imok is currently beta quality software and has not yet been tested in a "real life" setting.
Imok currently requires an admin to invite new users to the system. We expect these invites to happen in community venues and at protests for example. This is both for server security and to keep costs down.
- You add people you want to support ('members') in the imok admin interface
- imok will send an SMS inviting the person to register
- Once the person responds to the SMS to confirm they wish to register, the admin groupchat is notified
- If a timer expires or a member sends an SOS message, it sends a notification to the admin groupchat
We will be further developing admin documentation as the project develops.
As a member of an imok instance:
- You will receive an SMS asking if you want to join the server. After replying to this, the system registers you.
- You can then text the number
INbefore conducting the risky activity - If you text
OUTwithin the designated time, nothing happens - If you don't, admins get notified that something is wrong
- If you text
SOS, admins are immediately notified
That's it! All server commands are listed on the imok wiki.
To find out how to install imok, set up a development environment or provide translations check out the imok wiki on GitHub.
We have a Discord server for support and feedback.
We can also set up an installation for you for a fee. All funds raised go towards improving imok. Email [email protected] or join the Discord server if you'd like to chat about this.
Imok has been developed entirely by volunteers in the Geeks for Social Change collective. If you'd like to support development, please consider sending us a one-off or regular donation.
Imok is released under the MIT license.
