Ultimate Liar's Dice

A fully vibe-coded, web-based multiplayer Liar's Dice game. Play in your browser - roll dice, bluff, and call out your opponents. Game rules are here.

Setup

Using uv (recommended)

uv handles the virtual environment and dependencies automatically.

git clone https://github.com/ArisMorgens/ultimate-liars-dice.git
cd ultimate-liars-dice
uv sync
uv run server/app.py

Using pip

git clone https://github.com/ArisMorgens/ultimate-liars-dice.git
cd ultimate-liars-dice
python -m venv .venv
source .venv/bin/activate
pip install -e .
python server/app.py

The game runs at http://localhost:5000.

---

Playing Over the Internet

To share your game with players outside your local network, use ngrok to create a public tunnel.

1. Install ngrok

Install and authenticate directly from ngrok.com/download.

2. Start the tunnel

With the game already running on port 5000:

ngrok http 5000

ngrok will print a public URL to share with your players.

---

Adding Custom Profiles

You can create custom profiles, by dropping a folder into server/profiles/custom/. See server/profiles/custom/README.md for the full format.