Repository navigation
deepwolf 0.1.0
First public release of deepwolf — an LLM werewolf engine.
Highlights
- Self-play arena — LLM agents play full games of werewolf so you can benchmark reasoning, deception and deduction under hidden information.
- Human copilot — an explainable werewolf-suspicion model that advises your vote while you play.
- Strict seeded rules engine — Villager / Werewolf / Seer / Doctor, fully reproducible games, illegal agent moves validated away.
- Vendor-neutral LLMs — any OpenAI-compatible endpoint; ships with a deterministic offline mock so everything runs with zero setup.
- CLI —
deepwolf simulate,deepwolf arena,deepwolf play.
33 tests, CI across Python 3.10–3.12. See the README to get started in one command:
deepwolf simulate --players 7 --seed 1