Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
This is a simple interactive, multi-user, 3D, online application,
based on KataJS and Sirikata.

Easy Deployment
Probably the easiest way to get the application up and running for
testing is to install using the EC2 scripts. Note that these are
really just a scripted version of the full instructions below, so they
will also work on a regular Ubuntu installation and could be easily
adapted to other distributions and platforms. However, many services
run as root (god for monitoring the space server and the web server
for running on port 80), so an isolated environment is encouraged.

(NOTE: The script installed default-jre, which currently
 hangs on some micro instances on EC2. If you want to host on a micro
 instance, you might need to run the install portion with an EBS image
 on a larger instance, then move it back to a micro instance.)

To build and deploy, use the ec2 scripts in contrib as follows:
1. Setup a security group that leaves TCP connections for SSH (22),
   Web (80) and Sirikata (7777 by default).
2. Boot up a base image, e.g.
   using this security group.
3. Copy the ec2 scripts onto the server:
    local> scp -i me.pem contrib/ contrib/
4. SSH into the server
    local> ssh -i me.pem
5. Run the build script. This installs system dependencies (will ask
   for sudo password), checkout out both source trees, compile the
   space server and grab some extra dependencies for KataJS/Kataspace.
    remote> ./
   Note that unless you update any
   source code, you should only need to perform this step once.
6. Customize your deployment. Mainly this will be in
   scripts/deployment.js for a simple deployment. By default, SpaceURL
   will automatically be set to the same server using the default port
   for Sirikata of 7777, e.g. if you access
   it will be converted to
    SpaceURL = "sirikata://
   In a customized deployment you will need to adjust this (e.g. to
   use a different port). Also feel free to modify other settings in
   this file, for example to add your own avatars.
6. Run the servers.
    remote> ./
   This starts the God, which in turn starts the Sirikata space
   server. It also starts lighttpd on port 80, serving files directly
   from the Kataspace directory. God is started last to facilitate
   debugging of the config script. Run with --debug to run god
   interactively so you can see the output and catch any errors that
   may need to be fixed.
7. Connect to the server. Visit to start using the

Full Instructions
The following gives the full instructions for compiling the space
server, running it, and running the application, based on KataJS, from
on a web server.

To interact with other users we connect to a Sirikata space server.
See for details.  If you want to set up a server
to connect to, download the code for Sirikata and build the space
server. Using the minimal set of dependencies is sufficient because
only the server component is used -- KataJS provides the client-side
code for connecting to a Sirikata space.

Once you have the code, simply run the space server
(sirikata/build/cmake/space, append _d for the debug version). The
appropriate ports are hard-coded into the application to work with the
defaults.  If you need to use different ports, or want to point to a
server other than localhost, make the appropriate changes in index.html.

To "protect" against crashes, you can use monitoring software to
ensure the server is restored in case of a crash. The EC2 scripts use
God (, and the Sirikata code has a sample
God script (under tools/space/space.god.rb).

The code in this repository, along with KataJS, included as an
submodule, is a full client for Sirikata-based worlds. Because we rely
on KataJS, which in turn relies on other libraries, there's quite a
bit of initialization.  This should all be wrapped up nicely in the
Makefile, so simply typing


in this directory should make sure all the libraries are up to date
and built. This application must then be served by a web server.  A
convenient way to do that is to run


from this directory, which uses lighttp to serve this directory from
localhost:8888.  To view the application, enter


into your browser.

Avatar modeling, texture and animation by:
Stein Lotveit -
Creative Commons Attribution License:


An interactive, web-based, multi-user, 3D application, based on KataJS and Sirikata.






No releases published


No packages published