Native runtime for AI games: LLM as DM, deterministic state

A native agent runtime for AI-driven games, using an LLM as the Dungeon Master and a deterministic state machine.

Native Runtime for AI Games: LLM as DM, Deterministic State

This project provides a native runtime environment for developing AI-driven games. It leverages a Large Language Model (LLM) to act as the Dungeon Master (DM), dynamically generating game content and managing narrative flow. Crucially, it incorporates a deterministic state machine to ensure predictable game progression and reproducible outcomes, essential for complex AI interactions and testing.

What it Does

The native gaming harness allows developers to integrate LLMs directly into game logic. The LLM functions as the game's narrator, rule interpreter, and NPC controller, responding to player actions and environmental changes. The deterministic state machine tracks all game variables and events, ensuring that given the same initial state and sequence of player inputs, the game will always evolve identically. This combination enables sophisticated AI game masters and robust game development workflows.

Key Features

LLM as Dungeon Master: Utilizes an LLM for dynamic narrative generation, NPC dialogue, and world interaction.
Deterministic State Machine: Guarantees predictable game states and outcomes through a robust state management system.
Native Runtime: Designed for efficient execution and integration within game engines or custom applications.
Developer-Focused: Provides the foundational components for building complex AI game mechanics.
Reproducible Simulations: Facilitates testing and debugging of AI agents and game logic.

Who it's For

This tool is intended for AI developers, game developers, and researchers interested in creating AI-powered interactive experiences. It is particularly useful for those building games with emergent narratives, complex AI NPCs, or requiring highly controlled and reproducible game environments. If you are looking to experiment with LLMs as core game mechanics or need a reliable framework for AI game development, this harness offers a solid starting point.