README.md

Guess The Number

A simple game to learn User Authentication, and the difference between q.app, q.user, and q.client in a Wave app.

This app is a single player game where the player guesses the number picked by the computer. All players that are logged into the same app instance can compare their scores against each other.

Table Of Contents

• Running this App Locally
  • 1. Install Wave Server
  • 2. Create a python environment
  • 3. Run the app
• Setup User Authentication

Top

Running this App Locally

1. Download the latest release of Wave and have that running

• Read instructions from Wave Documentation

Top

2. Create a python environment in the app directory and install requirements

• Need Python 3.7.9 +

git clone https://github.com/h2oai/wave-apps.git
cd wave-apps/guess-the-number
make setup

Top

3. Run the app by pointing to the module directory

make run

• Point your web browser to localhost:10101. In the future, if you want to run this app you can skip step 2 as the environment is already set up.

Top

Setup User Authentication

The previous section will help get the app up and running. However, the player is always Default-User. Follow the instructions at Run waved with authentication during development using keycloak to have the ability to login as a different user. Please DO NOT use these instructions for a production environment.

Top