---
title: Read The Room
emoji: 👀
colorFrom: yellow
colorTo: yellow
sdk: gradio
sdk_version: 6.16.0
python_version: "3.13"
app_file: app.py
pinned: false
tags:
  - track:wood
  - sponsor:openai
  - sponsor:modal
  - achievement:offgrid
  - achievement:offbrand
  - achievement:llama
  - achievement:sharing
  - achievement:fieldnotes
---

# Track 2: Read the Room

Play [here](https://huggingface.co/spaces/build-small-hackathon/read_the_room)

You're a player in a situation where each character has an agenda and an opinion of everyone else, including you. You talk your way to a goal. The inspiration is text adventures RPGs like Zork crossed with social deduction games like Avalon and Werewolf. The social dynamic is the game - I've always wished videogame dialogues gave me more options to explore. Traditional games have always been constrained in this and current AI games dodge the social element: they usually focus on one character, or fixed characters on rails. So I built a game with multiple AIs reacting to each other and especially you (the player)

Anyone can publish a scenario (optional but recommended scene picture) and play what others shared


# Merit Badges

## Off the grid

The app makes zero network requests of its own - art and font are bundled and inlined. Point `RTR_API_BASE` at a local llama.cpp/vLLM and it runs fully offline (the hosted Space points it at a Modal GPU instead)

## Off-Brand

The default Gradio doesn't work well for a game, so I gave it some style with a custom front-end

## Llama champion

Llama.cpp is the canon way to play the game - start a server locally and wire it up. I playtested with Qwen3.6-27B (Q8_K_XL gguf from unsloth)

## Sharing is Caring

Playthrough traces - raw prompt and completions are available. You can use 🐞 export function to see what happened each turn - what fed into the LLM and what the response was. Here is one: [Ilia-Iliev/read-the-room-traces](https://huggingface.co/datasets/Ilia-Iliev/read-the-room-traces)

## Field Notes

More details in my [blogpost](https://ilia.foo/blog/read_the_room)

[Video](https://www.youtube.com/watch?v=eY81SvsOJy4)

[Social Media post](https://www.linkedin.com/posts/ilia-iliev-7903a015a_read-the-room-a-hugging-face-space-by-build-small-hackathon-activity-7471300743883522048-rKGz?utm_source=share&utm_medium=member_desktop&rcm=ACoAACYk8lwBA6YMOvmo6sowMJ679w1Iy48UvP0)