dod-uno / README.md
elismasilva's picture
update tags
4641442

A newer version of the Gradio SDK is available: 6.18.0

Upgrade
metadata
title: DOD - Deploy or Draw
emoji: 🃏
colorFrom: purple
colorTo: pink
sdk: gradio
sdk_version: 6.17.3
python_version: '3.10'
app_file: app.py
pinned: false
hf_oauth: true
license: mit
thumbnail: https://huggingface.co/datasets/DEVAIEXP/assets/resolve/main/dod_thumb.PNG
tags:
  - build-small-hackathon
  - thousand-token-wood
  - gradio
  - game
  - multiplayer
  - custom-ui
  - off-brand
  - off-the-grid
  - tiny-titan
  - llama-champion
  - nemotron
  - nvidia
  - openbmb
  - voxcpm2
  - modal
  - llama-cpp
  - codex
  - field-notes
  - track:wood
  - sponsor:openbmb
  - sponsor:openai
  - sponsor:nvidia
  - sponsor:modal
  - achievement:offgrid
  - achievement:welltuned
  - achievement:offbrand
  - achievement:llama
  - achievement:fieldnotes
short_description: A Multiplayer UNO Game

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

DOD - Deploy or Draw logo

DOD - Deploy or Draw

A multiplayer UNO-inspired game where production incidents become chaos, comedy, and AI-powered table drama.

Play The Incident

DOD - Deploy or Draw turns a software outage into a strange little card-table emergency. Players race to resolve a live production crisis before the Director's panic meter explodes.

The AI is not decoration here. It is load-bearing:

  • Nemotron is a mandatory rival that reads the current board, evaluates playable cards, chooses actions, and selects wild-card colors.
  • The IT Director reacts to every played card with short crisis-aware bilingual commentary.
  • VoxCPM2 turns those Director reactions into voice, making the match feel like an absurd deploy-night war room.

It is part UNO, part incident response simulator, part tiny corporate theater.

Demo Links

The GitHub repository above is the source-of-truth development repository. It contains the full implementation history, installation documentation, local-mode setup, and Codex-attributed commits. This Space repository is a deployment copy prepared for judges to play the finished app.

Hackathon Track

Submitted for An Adventure in Thousand Token Wood.

The goal was to build something delightful that would not exist without AI: a toy-like multiplayer game where small models create the fun, tension, and personality of the table.

Targeted Special Awards And Bonus Quests

  • NVIDIA Nemotron Quest: Nemotron Nano 4B is the required AI opponent.
  • OpenBMB Awards: VoxCPM2 provides the Director voice layer.
  • Modal Awards: the remote TTS path run on Modal for low-friction hosted audio.
  • OpenAI Codex: all development happened in the linked GitHub repository, which includes Codex-attributed commits.
  • Tiny Titan: the gameplay stack uses small models only, including Nemotron Nano 4B and VoxCPM2.
  • Off-Brand: the app uses custom Gradio HTML components for a game-like interface instead of a standard form UI.
  • Off the Grid: the project supports a fully local mode without remote APIs; this public Space uses hosted endpoints so judges can play it easily.
  • Llama Champion: the local LLM server runs GGUF inference through llama-cpp-python.
  • Field Notes: a write-up will document the build, model constraints, prompt design, local/remote fallback system, and what broke along the way.

How It Works

The game is built with:

  • Gradio 6 custom gr.HTML components for the board and toast system.
  • NVIDIA Nemotron Nano 4B for bounded strategic game decisions.
  • VoxCPM2 by OpenBMB for bilingual Director voice generation.
  • Modal as an optional hosted TTS runtime.
  • Hugging Face Spaces for the public Gradio app.
  • Hugging Face OAuth for authenticated leaderboard identity.
  • Hugging Face Datasets or local files for leaderboard and endpoint routing.

The public Space can use hosted LLM/TTS endpoints, while the GitHub version also supports local-only execution for users with suitable GPU hardware.

Gameplay Summary

  • Match the active stack color or the active card icon/category.
  • Resolve the crisis before the Director panic meter reaches 100%.
  • Shout Deploy when you reach one card, or another player can accuse you.
  • Wild cards let the player, or Nemotron, choose the next active stack.
  • The Director reacts to card plays in English and Portuguese.
  • The leaderboard records authenticated Hugging Face users.

Local Mode

The full installation guide lives in the GitHub repository:

https://github.com/DEVAIEXP/doduno

The app can run locally with:

  • local Gradio game server
  • local llama-cpp-python LLM server
  • local NanoVLLM/VoxCPM2 TTS server
  • local leaderboard and inference mapper files

For lightweight development, TTS can be disabled so Director lines appear as text only.

Credits

  • Voice generation uses VoxCPM2 by OpenBMB.
  • Gameplay inference uses NVIDIA Nemotron Nano 4B.
  • Remote audio inference uses Modal.
  • Development was assisted by OpenAI Codex with GPT-5.5.

Built with Gradio and Hugging Face Spaces for the Build Small Hackathon.

License

MIT License. See the linked GitHub repository for the full source and license.