Skip to content
A janky framework for building Signal bots.
Branch: master
Clone or download
thefinn93 Merge pull request #6 from aaronetz/patch-1
Remove redundant json.dumps on handler response
Latest commit 749ecd1 Mar 17, 2019

Janky Signal Bot Framework

A janky framework for building Signal bots. Requires signald.


pip install git+

Might put it in pypi eventually


See examples/ folder for more complete examples, etc

A simple example that responds to messages starting with "hi" with the text "Hello!"

from jsbf import Bot

def message_responder(message):
    return {
        "type": "send",
        "recipientNumber": message['data']['source'],
        "messageBody": "Hello!",
        "id": "1"

Bot's constructor takes one optional argument, a string to the path to the signald control socket. It defaults to /var/run/signald/signald.sock, the signald default.


Highly unstable, please get in touch or file an issue if you're planning on using this. Right now I'm assuming no one uses it and may post breaking changes

You can’t perform that action at this time.