Software and Rules for Personal Assistants / Artificial Intelligence for Chat Bots
Java HTML JavaScript CSS Shell Batchfile
Latest commit 716a44d Jan 6, 2017 @mariobehling mariobehling committed on GitHub Merge pull request #67 from robbyoconnor/patch-2
loklak is not susi..
Failed to load latest commit information.
.bluemix Export Java 8 env var for build Jun 9, 2016
.settings removed more classes which do not belong to Susi Sep 14, 2016
bin fixed loklak->susi Oct 26, 2016
conf renamed geschenke ai Jan 1, 2017
docs loklak is not susi.. Jan 6, 2017
html Add Console Rule App Dec 11, 2016
installation refactoring, added cms and service path Nov 26, 2016
lib removed more unused libraries Sep 16, 2016
scripts Improving the gh-pagesUpdater script Jan 3, 2017
src/org added "what gift should I buy" rules in german "was sol ich schenken" Jan 1, 2017
ssi more removals and refactoring to extract susi only Sep 14, 2016
test added test cases for susi Oct 17, 2016
.classpath removed more unused libraries Sep 16, 2016
.gitignore Add Gradle build support and utility shell script for gradle Jan 18, 2016
.project removed more classes which do not belong to Susi Sep 14, 2016
.travis.yml resolved conflicts Jan 3, 2017
Dockerfile updated the dockerfile for susi deployment with docker Jan 2, 2017
LICENSE Initial commit Mar 4, 2015
Procfile Server uses the PORT environment variable if available Feb 7, 2016 Added a new script to update gh-pages branch Jan 2, 2017
app.json Heroku, Scalingo, Bluemix deployment buildpack url change to loklak org May 23, 2016
build.gradle fixed gradle file Oct 13, 2016
build.xml Fixes #21 Renames jar file distribution from loklak.jar to susiserver… Oct 30, 2016 Fixes #18: Updating repo link & corresponding commands in cloud9 setu… Oct 23, 2016
docker-cloud.yml Fixes #323, Exposing port 443 to make Docker Cloud deployment endpoin… May 10, 2016
docker-compose.yml Inserting Docker One-Click-Deployment Button May 7, 2016 Fix shell script. Add travis-ci support. Jan 18, 2016 Fix shell script. Add travis-ci support. Jan 18, 2016
manifest.yml Heroku, Scalingo, Bluemix deployment buildpack url change to loklak org May 23, 2016
scalingo.json Heroku, Scalingo, Bluemix deployment buildpack url change to loklak org May 23, 2016 added java 1.8 support hint for heroku and scalingo May 24, 2016

layout title
Susi - Docs


Join the chat at Build Status Join the chat at Docker Pulls Percentage of issues still open Average time to resolve an issue Twitter Twitter Follow

Susi is a server application which is able to collect messages from various sources, including twitter. The server contains a search index and a peer-to-peer index sharing interface. All messages are stored in an elasticsearch index. An automatic deployment from the development branch at GitHub is available for tests here


Please join our mailing list to discuss questions regarding the project:!forum/loklak

Our chat channel is on gitter here:

Why should I use Susi?

If you like to be anonymous when searching things, want to archive tweets or messages about specific topics and if you are looking for a tool to create statistics about tweet topics, then you may consider Susi. With Susi you can:

  • collect and store a very, very large amount of tweets
  • create your own search engine for tweets
  • omit authentication enforcement for API requests on twitter
  • share tweets and tweet archives with other loklak users
  • search anonymously on your own search portal
  • create your own tweet search portal or statistical evaluations
  • use Kibana to analyze large amounts of tweets for statistical data.

How do I install Susi: Download, Build, Run

Deploy Deploy on Scalingo Deploy to Bluemix Deploy to Docker Cloud

At this time, Susi is not provided in compiled form, you easily build it yourself. It's not difficult and done in one minute! The source code is hosted at, you can download it and run Susi with:

> git clone
> cd susi_server
> ant
> bin/

For Windows Users (who are using GitBash/Cygwin or any terminal): > git clone > cd susi_server > git checkout master > ant jar > java -jar dist/susiserver.jar > git checkout development > ant jar > java -jar dist/susiserver.jar

To stop:
> Press Ctrl+C

After all server processes are running, Susi tries to open a browser page itself. If that does not happen, just open http://localhost:4000; if you made the installation on a headless or remote server, then replace 'localhost' with your server name.

To stop Susi, run: (this will block until the server has actually terminated)

> bin/

A self-upgrading process is available which must be triggered by a shell command. Just run:

> bin/

Where can I download ready-built releases of Susi?

No-where, you must clone the git repository of Susi and built it yourself. That's easy, just do

  • git clone
  • cd susi
  • then see above ("How do I run Susi")

How do I install Susi with Docker?

To install Susi with Docker please refer to the Susi Docker installation readme.

How do I deploy Susi with Heroku?

You can easily deploy to Heroku by clicking the Deploy to Heroku button above. To install Susi using Heroku Toolbelt, please refer to the Susi Heroku installation readme.

How do I deploy Susi with cloud9?

To install Susi with cloud9 please refer to the Susi cloud9 installation readme.

How do I setup Susi on Eclipse?

To install Susi on Eclipes, please refer to the Susi Eclipse readme.

How do I run Susi?

  • build Susi (you need to do this only once, see above)
  • run bin/
  • open http://localhost:4000 in your browser
  • to shut down Susi, run bin/

How do I analyze data acquired by Susi

Susi stores data into an elasticsearch index. There is a front-end for the index available in elasticsearch-head. To install this, do:

  • sudo npm install -g grunt-cli
  • cd into the parent directly of Susi_server
  • git clone git://
  • cd elasticsearch-head
  • npm install

Run elasticsearch-head with:

  • grunt server ..which opens the administration page at http://localhost:9100

How do I configure Susi?

The basis configuration file is in conf/ To customize these settings place a file to the path data/settings/

Where can I find documentation?

The application has built-in documentation web pages, you will see them when you opened the application web pages or you can simply open html/index.html or just use as reference.

Where can I find showcases and tutorials?

Articles and tutorials are also on our blog at

Where do I find the javadocs?

At or by building them via 'ant javadoc'

Where can I get the latest news about Susi?

Hey, this is the tool for that! Just put into your rss reader. Oh wait.. you will get a lot of information about tasty Cambodian food with that as well. Alternatively you may also read the authors timeline using or just follow @0rb1t3r (that's a zero after the at sign)

How to compile using Gradle?

  • To install Gradle on Ubuntu:

    $ sudo add-apt-repository ppa:cwchien/gradle
    $ sudo apt-get update
    $ sudo apt-get install gradle
  • To install Gradle on Mac OS X with homebrew

    brew install gradle
  • To compile, first, create dir necessary for Gradle


    Compile the source to classes and a jar file

    gradle assemble

    Compiled file can be found in build dir Last, clean up so that we can still build the project using Ant


What is the software license?

LGPL 2.1

Where can I report bugs and make feature requests?

This project is considered a community work. The development crew consist of YOU too. I am very thankful for pull request. So if you discovered that something can be enhanced, please do it yourself and make a pull request. If you find a bug, please try to fix it. If you report a bug to me I will possibly consider it but at the very end of a giant, always growing heap of work. The best chance for you to get things done is to try it yourself. Our issue tracker is here.

Have fun! @0rb1t3r