llm-mafia-game

KO | EN

gitlite — search

#python #ai #llm #golang #machine-learning #rust #deep-learning #nodejs #java #vue #awesome-list #pytorch #ios #open-source

(★ 53)

Which LLM is the best mafia game player?

File Explorer

Download Latest Version (.zip)

- - claude-code-review.yml
  - claude.yml
- DEVELOPMENT.md
- GAME_RULE.md
- - character.ts
  - chat.ts
  - index.html
  - main.ts
  - scene.ts
  - types.ts
- package.json
- pnpm-lock.yaml
- README.md
- tsconfig.json
- vite.config.js
- build-push.sh
- migrate_firebase_to_postgres.py
- pull-down-up.sh
- remote-config.sh
- remote-deploy.sh
- remote-logs.sh
- - 404.html
  - admin.html
  - base.html
  - game_detail.html
  - index.html
  - model_detail.html
- config.py
- dashboard.py
- firebase_manager.py
- game.py
- game_templates.py
- initialize_firebase.py
- logger.py
- openrouter.py
- player.py
- simulate.py
- test_firebase_manager.py
.env.example
.gitignore
.python-version
docker-compose.yml
Dockerfile
pyproject.toml
README.md
requirements.txt
uv.lock

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# LLM Mafia Game

https://github.com/user-attachments/assets/54976d88-6ef1-4c1c-9737-8635b33fd9f0

## Overview

This project allows multiple LLMs to compete against each other in Mafia games. The game is simulated multiple times, and the winning rate of each model is recorded and displayed on a dashboard. You can also see the full game history of each game. The game rules are based on the [Mafia Game Rules](docs/GAME_RULE.md).

## Quick Start

### 1. Clone the Repository

```
git clone https://github.com/guzus/llm-mafia-game.git
cd llm-mafia-game
```

### 2. Install Dependencies

```
uv sync
```

### 3. Set Up Neon PostgreSQL

- Create a Neon project and PostgreSQL database.
- Copy the connection string and set it as `DATABASE_URL` in your environment (`sslmode=require`).

### 4. Set Up OpenRouter API

- Sign up at [OpenRouter](https://openrouter.ai/).
- Get an API key and add it to `config.py` (`OPENROUTER_API_KEY`).

### 5. Run the Mafia Game Simulation

```
uv run src/simulate.py
```

This will:

- Run Mafia games `n` times.
- Store the results in Neon PostgreSQL.
- Print the final statistics.

### 6. Start the Dashboard

```
uv run src/dashboard.py
```

- Open `http://127.0.0.1:5000/` in your browser to view the leaderboard.

## Future Improvements

- Human vs LLMs 3D Mafia Game
- Extend to other games (Poker, etc.) beyond Mafia.
- Create a real-time viewer, chat, and betting system for ongoing games.
- Add more complex roles like Detective, Jester, Sheriff, etc.

## Development

See [DEVELOPMENT.md](docs/DEVELOPMENT.md) for more details on the development process.

llm-mafia-game

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

llm-mafia-game

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README