---
title: Chameleon
emoji: 🦎
colorFrom: green
colorTo: yellow
sdk: streamlit
sdk_version: 1.32.0
app_file: src/app.py
pinned: true
---
# Chameleon

*A social deduction game powered by LLMs*

[Play Now](https://huggingface.co/spaces/ericbotti/chameleon)

## Description

Chameleon is a social deduction game (a la Mafia, Among Us, etc.) about blending in, and figuring out who doesn't belong.

At the start of the game, each player is assigned one of two roles:
- **Herd**: The herd is a group of players who are all the same animal. They are trying to identify the chameleon hidden amongst them, while keeping the true animal a secret.
- **Chameleon**: This player is pretending to be part of the herd. Their goal is to identify what animal the herd is while remaining undetected.

See the [game rules file](GAME_RULES.md) for more details.

## Running the Game

The Easiest way to play the game is to use [Hugging Face Space Demo](https://huggingface.co/spaces/ericbotti/chameleon)

If you want to run the game locally, you can clone the repository and run the game using the command line or the Streamlit app.

1. **Using the command line**:
    - Run `python src/main.py` from the root directory

2. **Using the Streamlit App**:
    - Run `streamlit run src/app.py` from the root directory