ai-plays-jackbox

Bringing the dead internet theory to life. Have AI play JackBox with you; no friends required!

Installation

pip install ai-plays-jackbox

Usage

Web UI

ai-plays-jackbox-ui

CLI

ai-plays-jackbox --chat-model-name openai --room-code abcd

usage: ai-plays-jackbox [-h] --room-code WXYZ --chat-model-provider {openai,gemini,ollama} [--chat-model-name CHAT_MODEL_NAME] [--num-of-bots 4] [--temperature 0.5] [--top-p 0.9]

options:
  -h, --help            show this help message and exit
  --room-code WXYZ      The JackBox room code
  --chat-model-provider {openai,gemini,ollama}
                        Choose which chat model platform to use
  --chat-model-name CHAT_MODEL_NAME
                        Choose which chat model to use (Will default to default for provider)
  --num-of-bots 4       How many bots to have play
  --temperature 0.5     Temperature for Gen AI
  --top-p 0.9           Top P for Gen AI

Supported Games

Not every game will get AI support. Why?

Screen Interactions

Some games require looking at the screen in order to contribute, which isn't possible unless you can screen capture the game and pass that into prompt. Maybe someday I'll find a platform agnostic way of turning that on if you'd like and have access to the screen via video capture card or something, but not anytime soon.

Trivia Games

I tested with this... AI destroys all other players and isn't necessarily funny to watch. All the bots just get everything right.

Out Loud Play

Some of the games lean heavy into players interacting with each other. Could I program that? Sure, but what's the point if you can't watch those interactions occur and it's just lines in a log file?

Supported Chat Model Providers

Bot Personalities

Dev Prerequisites

• Python 3.11+
• Poetry v2.0+

Setup

• poetry install
• ai-plays-jackbox-ui

Linting

• poetry run python ai_plays_jackbox/scripts/lint.py
• poetry run mypy ai_plays_jackbox