Multiplayer social deduction game — reverse Turing test. Players join a group where some are AI, some human. Everyone votes each round on who sounds most human. After 5 rounds: big reveal, highest score wins.
- Python 3.12+
- uv (Python package manager)
- Node.js 18+
- A Google API key (for Gemini AI players)
cp .env.example .env
# Edit .env to add your GOOGLE_API_KEY
make devBackend starts on http://localhost:8501, frontend on http://localhost:3500. Dependencies install automatically.
Open the frontend. Click play to enter matchmaking (finds a game automatically), or private game to create a shareable link.
Run make to see all targets.
| Command | Description |
|---|---|
make dev | Start backend + frontend together |
make backend | Start backend only |
make frontend | Start frontend only |
make codegen | Regenerate frontend types from backend OpenAPI |
make lint | Lint + format Python |
make test | Run all tests |
make clean | Remove caches and build artifacts |
- Architecture — real-time system, state machine, AI scheduling
- Game Design — mechanics, prompts, design rationale
© 2026 Nat Bishop. All rights reserved. This repository is published for portfolio and evaluation purposes only; it is not licensed for reuse, redistribution, or derivative works.