Skip to main content


Project description

An extendable Python based Twitter bot which will reply to various keyworded tweets.

“Isn’t this against the ToS?”, I hear you ask. Well, sort of, but sort of not. Yes, it might be covered by the spamming or unsolicited mentions rules, but in my opinion, no more than some asshole going around correcting people manually, depending on your settings.

Example usage

Here’s my favourite use of the Corrections bot (and why I actually wrote this): the a lot correction bot:

# -*- coding: utf-8 -*-
from corrections import Correct
from random import choice

class Alot(Correct):
    auth = (OAUTH_TOKEN,
    phrases = ["alot"]
    cooldown = (60 * 5, 60 * 3)

    def reply(self, phrase, user):
        return choice([
            "@{user}: a lot*",
            "@{user}: Surely you mean 'a lot', right?",
            "@{user}: I think you meant 'a lot'!",
            "@{user}: Come on, use 'a lot', lazy..",
            "@{user}: Alot is sad you can't use 'a lot' right..",
            "@{user}: There should be a space in there somewhere.. 'a lot'*",

if __name__ == "__main__":
    correct = Alot()

Just for testing

Want to make sure your bot is functional but don’t want to start spamming tweets yet? Easy! Set dry = True in your Corrections class and Corrections won’t actually update your status.

class Alot(Correct):
    auth = (OAUTH_TOKEN,
    phrases = [...]
    cooldown = (...)
    dry = True

    def reply(...):
        # ...

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

corrections-0.2.3.tar.gz (4.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page