Skip to main content

One Night Ultimate Werewolf: AI Edition

Project description


One Night Ultimate Werewolf: AI Edition

By Tyler Yep & Harry Sha

Python 3.9+ Build Status GitHub license codecov DeepSource


This is an implementation of the popular board game One Night Ultimate Werewolf.

To try it out, run python in the terminal. (You may need to run pip install -r requirements.txt if you do not have tqdm already installed.)

Constants, along with their use cases, are listed in src/ You can change:

  • # of players
  • # of center cards
  • Which roles are used
  • Behavior of AI players on the Werewolf Team / Village Team

Interactive Mode

To play the game yourself as a character, use the -u / --user flag:

python --user

To replay a game, add the -r / --replay flag.

python --user -r

To examine verbose output of a game, use the -l / --log_level flag.

python -l trace

Simulating Games

To simulate many runs of the game, use the -n flag.

python -n 100

For additional information, please check out the GitHub Wiki!


All issues and pull requests are much appreciated!

  • To start developing, first run pip install -r requirements-dev.txt.
  • Next, run 'scripts/install-hooks'.
  • To see test coverage scripts and other auto-formatting tools, check out scripts/run-tests.
  • To run all tests, run pytest.
  • To only run unit tests, run pytest unit_test.
  • To only run integration tests, run pytest integration_test.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wolfbot-0.0.1.tar.gz (18.4 kB view hashes)

Uploaded source

Built Distribution

wolfbot-0.0.1-py3-none-any.whl (21.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page