Skip to content

Cluedo

Cluedo is a multi-agent Clue murder mystery game built on OpenEnv 0.2.1.

Code Demo Video Cerebral Valley

Core trick

Partial observability per player with a structured check-sheet observation lets LLM agents deduce cards from show-card responses.

Tags

agents

Description

Cluedo is a multi-agent Clue murder mystery game built on OpenEnv 0.2.1. It lets players play Clue with AI agents in two modes: Human vs Agents (one human vs AI) and Agents vs Agents (all AI). The environment includes: Partial observability (each player sees only their cards) A check sheet for tracking deductions (Y / X / / / 1–3) Turn-based gameplay: roll & move, suggest, show card / no card, accuse REST API for the game UI and an LLM-ready observation format It targets multi-agent RL and agent training by giving structured feedback (win / lose / elimination) from gameplay, suitable for GRPO or similar methods.
Saurabhkhire/clue-openenv★ 00 forksCreated Mar 8, 2026 · last push Mar 8, 2026

README excerpt

# Clue — Multi-Agent Murder Mystery (OpenEnv)

Multi-agent murder mystery game built on **OpenEnv 0.2.1** for the hackathon.

## Hackathon Fit

- **Statement 1: Multi-Agent Interactions** — Partially observable, cooperation, competition, theory-of-mind
- **Halluminate Sub-Theme** — Moderator agent manages multiple actors; agents discover the secret envelope

## Quick Start

```bash
cd clue-openenv
pip install openenv-core
pip install -e .
```

**For full configuration, run, and test instructions:** see [RUN_AND_TEST.md](RUN_AND_TEST.md).

### Run server locally

```bash
python -m uvicorn clue_env.server.app:app --host 0.0.0.0 --port 8000
```

### Play locally (random agent)

```bash
python demo/play_clue.py
```

### Gradio UI

```bash
pip install gradio
python demo/app.py
```

## Game Rules

- 3–6 players, 6 characters, 6 weapons, 9 rooms
- Secret envelope: 1 character + 1 weapon + 1 room (hidden)
- Turn: roll dice → move to room → make suggestion → show card (or pass)
- Accusation: correct → win; wrong → eliminated

## Deploy to HF Spaces

```bash
cd clue_env
openenv push
```

## Training (Colab)

See `training/grpo_clue_colab.ipynb` for a minimal TRL/GRPO training script.

## License

BSD-3-Clause
# clue-openenv

Team