Demonstration of fluid flow around an image tweeted to our bot
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 29 commits ahead of ngcm:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


An implementation of interactive-fluid-demo which runs on a server monitoring a given Twitter account. Whenever a tweet is written mentioning that Twitter account and attaching an image, the software will instantly grab the image, run the fluid flow simulation on top of that image and tweet an animated GIF back.

example1 example2


  • A Twitter account
  • A Twitter app linked to that account

Create a file called credentials.txt and place it in the main directory. First to fourth lines should contain the consumer key, the consumer secret, the access token and the access token secret, respectively. If needed, the fifth line can contain the Slack app auth token as well.

Installation in Linux

Can be easily run on any Linux box, just follow the instructions here.

Using a virtual machine

Moreover, we provide Vagrant recipe to create a virtual machine with all the necessary software installed. This is very convenient as it can be quickly deployed somewhere to run non-stop.

Inside the vagrant directory do vagrant up to download and setup an Ubuntu 16.04 virtual machine and install all the requirements. Once this is done, log in with vagrant ssh. Then just: cd interactive-fluid-twitter-master and python