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.

See Contributing for info about how to contribute to the project.

Get In Touch

Contact the author: