Skip to content

google-gemini/angular-rock-paper-scissors-sample

Repository files navigation

Angular Rock Paper Scissors Sample

Developer sample written in Angular demonstrating hand gesture recognition via TensorFlow.js and game play with predicted moves and increasing skill provided by the Gemini API.

This project was generated with Angular CLI version 17.0.5 and uses tensorflow.js, a library for machine learning in Javascript. Video from the webcam is passed to a pre1.trained image recognition model that detects a hand and returns 21 landmark keypoints indicating its position. We then use fingerpose, a finger gesture classifier, to define and recognize the hand gestures for Rock, Paper, and Scissors based on the position of each finger.

For more information on Angular, visit angular.dev.

Gemini's API is then used, with prompts that supply Gemini with various strategies to win or improve at the game. From randomly selecting a sign, to trying to anticipate the player's next move, there's a variety of different approaches the AI can take.

Can you beat AI at the game?

demo.mov

Open the Demo in IDX

Try in IDX
  1. Open this project using the button above.
  2. Open the IDX integration panel to get an Gemini API key.
  3. Update the API_KEY="…" line in the functions/.env file

IDX Integration

Get the demo running locally!

  1. Create a personal fork of the project on Github, then clone the fork on your local machine.
  2. Run npm run i to install the dependencies required to run the server.
  3. [IMPORTANT!!] This demo needs a Gemini API to run. Go to Google AI Studio to get an API key then add it to the Firebase Function in angular-rock-paper-scissors-sample/functions/.env. This demo simulates how you might store and protect a private Gemini API key in a real world app.
  4. Run ng run s to run the server. Since we're using Firebase Functions, you'll need to run our functions and the app in a Firebase Emulator, this command does this automatically!
  5. Open a browser tab to http://localhost:4200. The app will automatically reload if you change any of the source files.