|
--- |
|
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 |
|
|
|
|