Keep Talking and Nobody Explodes Bot

A KTaNE assistant for when you're alone.
Explore the docs »
View Video Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contact

About The Project

A high-school project made to help users play Keep Talking and Nobody Explodes without the need of another player. Simply start up the program and describe the bomb as it tells you which wires to cut or what code to insert.

(back to top)

Built With

• Python
• Vosk

(back to top)

Getting Started

Currently tested for Windows only. Currently tested for Python 3.9 only.

To get a local copy up and running follow these steps.

Prerequisites

• pip

  pip install --upgrade pip

Installation

1. Clone the repo

   git clone https://github.com/Multipixels/Keep-Talking-and-Nobody-Explodes-Bot.git

2. Install Python package dependencies

   pip install pynput
   pip install pyttsx3
   pip install pyaudio
   pip install vosk

3. Download a Vosk Audio Recognition Model. Extract the folder from the zip file and put the folder in the root directory of the repository as shown below.
   
   • The only two models supported are the following.
     • vosk-model-en-us-0.22-lgraph, Faster bootup, but provides less accuracy. If having trouble, try using the next model.
     • vosk-model-en-us-0.22, Provides more accuracy, but initial bootup takes longer and takes up much more space.

(back to top)

Usage

Run the main.py file. If installation was done correctly, a window will popup. Wait until it shows "Bot heard: Ready to Listen!" When you're ready to start, press the "Activate" button below. Press it again if you want to stop.

Full tutorials will be found here.

For more in-depth details on specific modules and information, please refer to the Wiki.

(back to top)

Roadmap

• Vanilla Modules
  • Complicated Wires
  • Keypad
  • Maze
  • Memory
  • Morse Code
  • Password
  • Simon Says
  • The Button
  • Who's On First
  • Wire Sequence
  • Wires
• Vanilla Needy Modules
  • Knob
• Settings Menu
  • C++ Port
  • Voice activation
  • Activation by keyword ("Hey Bot...")
  • Push-to-talk/Toggle Options
  • Module Settings

(back to top)

Contact

Richard Motorgeanu - [email protected]

Project Link: https://github.com/Multipixels/Keep-Talking-and-Nobody-Explodes-Bot

(back to top)