Skip to content
Meme tracker and source discovery
JavaScript Python Shell
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
api
deploy/debian
doc
license
static
.gitignore
README.md

README.md

SwiftMeme v0.2.0

Synopsis

SwiftMeme is a source discovery and keyword monitoring tool for tracking memes online.

Architecture

Architectural Diagram

Internal Dependencies

External Dependencies

Debian 6.0 (Squeeze) Installation Instructions

Automatic

Run the following at the command line:

wget -qO- --no-check-certificate https://raw.github.com/ushahidi/SwiftMeme/master/deploy/debian/install.sh | sudo bash

Manual

  1. Install the necessary Debian packages.
    apt-get install apache2 libapache2-mod-wsgi memcached python-pip git

  2. Install the necessary Python packages.
    pip install Flask oauth2 python-memcached

  3. Create a user for SwiftMeme processes to run as.
    adduser --disabled-password --gecos "" swiftmeme

  4. Create a local clone of the application.
    git clone https://github.com/ushahidi/SwiftMeme.git /var/www/swiftmeme

  5. Replace the default Apache configuration with the bundled one.
    cp /var/www/swiftmeme/deploy/debian/000-default /etc/apache2/sites-enabled/

  6. Tell Apache to reload its configuration.
    /etc/init.d/apache2 reload

  7. Copy the example SwiftMeme configuration file for customisation.
    cp /var/www/swiftmeme/api/config.example.py /var/www/swiftmeme/api/config.py

  8. Open the configuration file in vim.
    vim /var/www/swiftmeme/api/config.py

Apache Configuration

<VirtualHost *:80>
 Alias /static/ /var/www/swiftmeme/static/
 AliasMatch ^/$ /var/www/swiftmeme/static/index.html
 AliasMatch ^/dashboard$ /var/www/swiftmeme/static/dashboard.html
 WSGIDaemonProcess swiftmeme user=swiftmeme group=swiftmeme threads=5
 WSGIScriptAlias / /var/www/swiftmeme/api/swiftmeme.wsgi
</VirtualHost>
  • If your application is installed in a different directory than /var/www/swiftmeme, please modify the path accordingly, both in the Apache configuration and in the WSGI handler (swiftmeme.wsgi).
  • You need a user set up for the SwiftMeme process to run as. In the above, we assume both the user and group will be swiftmeme.

Licenses

Credits

  • Charl van Niekerk (Front End and Back End Development)
  • Joe Zhou (Design and Front End Development)
  • Jon Gosier (Creative Input and Inspiration)
  • Matthew Griffiths (Architecture and Inspiration)

Support

See Also

Something went wrong with that request. Please try again.