{"id":13688646,"url":"https://github.com/geeksforsocialchange/imok","last_synced_at":"2026-01-18T09:12:04.694Z","repository":{"id":44547132,"uuid":"333864411","full_name":"geeksforsocialchange/imok","owner":"geeksforsocialchange","description":"A simple bot to support people doing risky activities","archived":false,"fork":false,"pushed_at":"2024-08-07T14:36:49.000Z","size":583,"stargazers_count":12,"open_issues_count":13,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-12T12:48:01.702Z","etag":null,"topics":["asylum-seekers","community","django","python","sms","telegram"],"latest_commit_sha":null,"homepage":"https://gfsc.studio/blog/2021/imok-is-launched/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geeksforsocialchange.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":"gfscstudio","open_collective":"gfscstudio","ko_fi":"gfscstudio","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2021-01-28T19:01:10.000Z","updated_at":"2024-08-07T14:36:52.000Z","dependencies_parsed_at":"2024-11-12T12:31:43.236Z","dependency_job_id":"84ceb8b2-4f01-4b9f-b589-2e0b29926fb5","html_url":"https://github.com/geeksforsocialchange/imok","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geeksforsocialchange%2Fimok","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geeksforsocialchange%2Fimok/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geeksforsocialchange%2Fimok/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geeksforsocialchange%2Fimok/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geeksforsocialchange","download_url":"https://codeload.github.com/geeksforsocialchange/imok/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251932699,"owners_count":21667197,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["asylum-seekers","community","django","python","sms","telegram"],"created_at":"2024-08-02T15:01:18.688Z","updated_at":"2026-01-18T09:12:04.675Z","avatar_url":"https://github.com/geeksforsocialchange.png","language":"Python","funding_links":["https://patreon.com/gfscstudio","https://opencollective.com/gfscstudio","https://ko-fi.com/gfscstudio","https://ko-fi.com/M4M43THUM"],"categories":["django"],"sub_categories":[],"readme":"# I'm OK (imok)\n\nImok is a simple bot to support people undertaking potentially risky activities. It's aimed at community groups who support these vulnerable people.\n\nThe 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.\n\nExample use cases are:\n\n- Supporting protestors at risk of arrest or kidnapping\n- Supporting women and LGBTQ+ people walking home at night, or going on dates\n- Supporting journalists or medical staff in warzones\n- Supporting asylum seekers through 'signing in' processes (see #AbolishReporting on Twitter).\n\nImok is currently optimised for the latter use case. It is a collaboration between [No Borders Manchester](https://nobordersmcr.com/) and [Geeks for Social Change](https://gfsc.studio) that emerged from the [Resistance Lab](https://resistancelab.network) collective.\n\nWe 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.\n\nWe currently support SMS and Telegram. WhatsApp is theoretically supported but requires a [WhatsApp Business API account](https://www.whatsapp.com/business/api/?lang=en), which we do not have.\n\nPlease note that imok is currently **beta quality software** and has not yet been tested in a \"real life\" setting.\n\n## How it works\n\n### For support workers (admins)\n\nImok 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.\n\n1. You add people you want to support ('members') in the imok admin interface\n1. imok will send an SMS inviting the person to register\n1. Once the person responds to the SMS to confirm they wish to register, the admin groupchat is notified\n1. If a timer expires or a member sends an SOS message, it sends a notification to the admin groupchat\n\nWe will be further developing admin documentation as the project develops.\n\n### For members\n\nAs a member of an imok instance:\n\n1. You will receive an SMS asking if you want to join the server. After replying to this, the system registers you.\n1. You can then text the number `IN` before conducting the risky activity\n1. If you text `OUT` within the designated time, nothing happens\n1. If you don't, admins get notified that something is wrong\n1. If you text `SOS`, admins are immediately notified\n\nThat's it! All server commands are listed on the [imok wiki](https://github.com/geeksforsocialchange/imok/wiki/Server-commands).\n\n## Installation and deployment\n\nTo find out how to install imok, set up a development environment or provide translations check out the [imok wiki on GitHub](https://github.com/geeksforsocialchange/imok/wiki).\n\n## Support\n\nWe have a [Discord server](https://discord.gg/4JKak6aymM) for support and feedback.\n\nWe can also set up an installation for you for a fee. All funds raised go towards improving imok. Email [kim@gfsc.studio](mailto:kim@gfsc.studio) or join the [Discord server](https://discord.gg/4JKak6aymM) if you'd like to chat about this.\n\n## Donations\n\nImok has been developed entirely by volunteers in the [Geeks for Social Change](https://gfsc.studio/) collective. If you'd like to support development, please consider sending us a one-off or regular donation.\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/M4M43THUM)\n\n## License\n\nImok is released under the [MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeeksforsocialchange%2Fimok","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeeksforsocialchange%2Fimok","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeeksforsocialchange%2Fimok/lists"}