Installation and upgrading the SDK

Installation

To install the SDK, follow this process:

  • Download and extract Furhat SDK from the Furhat Developer Zone (furhat.io)
  • Open the folder in your terminal
  • Run gradlew run. This will download all needed assets and eventually run the SDK development server

Running the SDK

  • Run gradlew run in your SDK folder

First time setup of SDK

  • Make sure the SDK is running
  • Open your browser (Chrome is recommended) and navigate to http://localhost:8080
  • Log into the web interface with password "admin"
  • Connect the Virtual Furhat (that was opened automatically) by pressing Connect. Test a few gestures on the Home screen of web interface to verify that it works.
  • (To set up TTS): Create an AWS account, create Amazon Polly credentials and paste your key and secret into Voice settings in the web interface.
  • (To set up ASR): Create a Google cloud service account and paste your JSON-key into Recognizer settings in the web interface.
  • (To set up mics): Configure microphone under microphone settings.
  • (To set up speaker): Configure speaker under the home settings.
  • Test the speech, gaze and gestures on the home screen.

Upgrading

To upgrade your SDK (or downgrade a version), follow this process:

  • Run the SDK with gradlew run or by running it from IntelliJ IDEA
  • Open your browser (Chrome is recommended) and navigate to http://localhost:8080
  • Log into the web interface with password "admin"
  • Go to settings and upgrade to the latest version (or choose an older version)