https://github.com/mlh-fellowship/poserunner

"Run" through MLH Fellowship in outer space, with your poses!
https://github.com/mlh-fellowship/poserunner

game machine-learning posenet react threejs

Last synced: about 2 months ago
JSON representation

"Run" through MLH Fellowship in outer space, with your poses!

• Host: GitHub
• URL: https://github.com/mlh-fellowship/poserunner
• Owner: MLH-Fellowship
• License: mit
• Created: 2021-03-04T20:53:42.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2021-04-21T23:01:52.000Z (almost 4 years ago)
• Last Synced: 2024-12-16T19:13:27.568Z (about 2 months ago)
• Topics: game, machine-learning, posenet, react, threejs
• Language: JavaScript
• Homepage: https://pose-runner.vercel.app
• Size: 11.4 MB
• Stars: 2
• Watchers: 4
• Forks: 3
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# :fire: PoseRunner



PoseRunner is a browser-based endless runner game built with Three.js.

#### Where there is Will, there is a way!

### "Run" through the MLH Fellowship in outer space, with your poses!

(also, please avoid as many obstacles as you can, _if_ you can :p)

## It's not just a regular runner game, we have added a special twist for you - PoseNet! 😲

#### Use your webcam to control your character!

We analyze your arm gestures.

- Doing this will trigger "Right" ➡️.



- Doing this^ with your other hand will trigger "Left" ⬅️.

- Doing this will trigger "Jump" ⬆️.



### Key Features

- Player can run endlessly as long as they have their lives secured. A total of 3 lives are given throughout the game.

- Theme: MLH Fellowship!

- Avoid daily obstacles like stress, anxiety, **TikTok**, etc.

- Calibration screen for calibrating the person to fit in the gestures.

- Save player's score and high score using browser cache.

### Run Locally

1. Clone the repo

2. Open the repo in your favorite browser and navigate into it

3. `npm install`

4. `npm start`

5. The game should run locally in port 3000.

### Future Changes:

- Add multiple characters to select from

- Add more variety of obstacles

- Power Boosts!

### How to Contribute:

1. Fork the repo to your GitHub

2. Clone locally and navigate into the repo

3. Set upstream to the original(our) repo

4. Make a new branch

5. Make changes

6. Make sure you pull upstream's main branch to local main to ensure updated changes get applied.

  - If there are new changes added to the main branch you might need to rebase and resolve conflict(if any)

7. Push to your repo

8. Make a pull request and we will review it. :)

### Collaborators:

- [Rashi Sharma](https://github.com/rashi-s17)

- [Aitik Gupta](https://github.com/aitikgupta)

- [Shrill Shrestha](https://github.com/ShrillShrestha)