Intelligent Real-time Interactive Systems Toolkit
To install IrisTK, start by cloning the IrisTK repository from GitHub:
There, you can choose to either download the repository as a ZIP file, or clone it using you Git client.
NB: To avoid troubles, choose a path on your computer that does not contain spaces.
After cloning or unzipping the repository, go to the root IrisTK directory, and type:
Here you can find instructions on how to do this procedure directly in Eclipse.
IrisTK comes with two example applications: Chess (speech-only interaction) and Quiz (multi-party interaction with an animated agent). To test the Chess app, open a command window and type:
The app will use the Windows ASR and TTS, which assumes that you are running on an English version of Windows. To test the game, you are advised to use a headset. You can say commands such as “move the pawn that stands in front of the queen”, “move the right knight to the left”, etc. In case of ambiguity, the system will make clarification requests.
You can also test the game without ASR and TTS, using the keyboard. To do so, start the game with “iristk chess console”. To interact with the game, you must first click in the text entry field in the bottom the console panel. Then you can type your command (such as “move the pawn”) and press enter.
The quiz app have a few more requirements. For more information on these, see Tutorial 2.
If there are any problems during installation, or if the test doesn’t work, check the following:
If you don’t know how to change or set environment variables in Windows, please check these instructions.
If these things don’t help, use the iristk-users mailing list. Try first to search the list for similar problems, and if that doesn’t help, you can post your problem there.
The IrisTK installation consists of a set of packages. Each package is self-contained in its own folder, which makes them easy to add or remove (although packages may rely on each other).
The IrisTK installation contains four main folders:
|core||The core package for IrisTK (no modules for ASR or TTS are included here)|
|addon||Add-on packages that add support for input and output, or any other kinds of extensions to the core.|
|app||Application packages built with IrisTK. Two example applications, “chess” and “quiz” are included. This is a convenient place for new applications.|
Each package folder has the following contents:
|package.xml||A description of the package|
|src||Java source files|
|bin||Java class files (compiled from src)|
|lib||Java library files (mainly jar files, but also dll:s)|
If you have installed IrisTK properly, you can open a command window and run the iristk.exe tool from anywhere. This is a convenient command to use instead of java.exe, since it provides short names for typical actions and programs, locates the correct Java version and sets the classpath for you. To check which commands iristk.exe provides, simply run “iristk” without any parameters. The set of commands are defined in the “package.xml” files and are thus possible to extend.
Copyright © Gabriel Skantze, 2013-