Skip to content



rainbow mind machine is an extensible framework for running Twitter bot flocks in Python.

rainbow mind machine uses the mind machine framework to provide the user with a simple set of building blocks for building bot flocks: a Keymaker, a Shepherd, and a Sheep.

The philosophy is to help users get started quickly, and build on simple behaviors to create complex, rich bot behaviors.

See rainbow-mind-machine in action!

All the shields

latest prime number version

tests-passing works on my machine documentation at

PyPI version rainbowmindmachine PyPI license PyPI implementation


rainbow mind machine (rmm) links:



About the Mind Machine Framework - general information about the mind machine framework (how does it work? what does it look like?)

About Rainbow Mind Machine - about the rainbow mind machine library (what is it? what does it do?)

Installing - installation instructions (how do I install bmm?)

Quick Start - quick start instructions for getting started with rainbow mind machine - run your first Twitter bot!

Documentation for components implemented in rainbow mind machine:

Developer Notes

See Developer Notes for info about the workflow for uploading changes to pypi and dockerhub.

Get In Touch

Contact the author: