Skip to main content

Interface server of the KogniHome project

Project description

A web server and bridge between networks using the Web Application Message Protocol (WAMP) and the Robotic Service Bus (RSB) build upon crossbar. WAMP is provided by autobahn. This software is actively developed as part of the project KogniHome.


KogniServer can be obtained via pip

$ pip install kogniserver

or cloned and installed from github

$ git clone
$ cd kogniserver
$ python install (--prefix=/install/path/prefix)
$ # python install --prefix=/usr/local

/install/path should be the root of your preferred environment and will be concatenated with 'lib/python2.7/site-packages'. Make sure that /install/path/lib/python2.7/site-packages is in your PYTHONPATH.

Configuration and Starting

To configure crossbar you need to create a config.json and tell crossbar where to find it. kogniserver will assist you in creating a file if it cannot find one.

$ kogniserver 
config.json for crossbar does not exists. Should a default one be created? [y]/n:y
Location of proto-files? [/usr/local/share/rst0.12/proto]:/usr/local/share/rst0.12/proto/
No instance is currently running from node directory /home/foobar/kogniserver.

This will create a common config.json at /install/path/etc/crossbar/config.json (e.g. /usr/local/etc...) If you like to use an existing config.json you can use the -c option:

$ kogniserver -c /path/to/your/crossbar/config.json

To overwrite an existing config.json at /install/path/etc/crossbar/config.json, start kogniserver with -f:

$ kogniserver -f
Location of proto-files? [/usr/local/share/rst0.12/proto]:

Alternatively you can start crossbar and kogniserver individually. First start a crossbar instance:

$ crossbar start --config=/path/to/config.json

After that you can initialize kogniserver:

$ kogniserver -k # --keep-alive; use existing crossbar instance
kogniserver(asyncio) started...

The --keep-alive flag will tell kogniserver to use the running instance. If it is not passed, kogniserver will try to shutdown this instance and start a new one.

If you use the standard configuration, files will be hosted under /install/path/var/www/kogniserver and can be reached via http://localhost:8181.

Ctrl+C or a SIGTERM will exit the server.

What now?

If you plan to write applications in javascript, head over to the KogniJS-Framework.


The development of this software was supported through project grants KogniHome (German Federal Ministry of Education and Research (BMBF) grant no. 16SV7054K) at Bielefeld University.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kogniserver-0.3.1.tar.gz (10.3 kB view hashes)

Uploaded source

Built Distribution

kogniserver-0.3.1-py2.py3-none-any.whl (14.2 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page