LLM World

A simple 2D RPG game using LLMs to control NPCs behavior.

Important note

This project is made for fun and learning purposes. It is not meant to be a finished product or a good example of how to use LLMs in a game. It is a proof of concept and a starting point for further development. It is created with heavy help from an LLM too, on purpose. This is to demonstrate the potential of LLMs to control complex systems and create interesting behaviors.

Features

• 2D top-down view
• Procedural world generation with simple rules and objects
• NPCs with unique personalities and behaviors
• NPCs store memories and learn from them
• Weather system with different weather effects
• Time system based on real time
• Save and load game

Installation

Copy the env.example file to .env and fill in the missing values if needed.

Using pip / venv

Optional (create virtual environment)

python -m venv .venv
source .venv/bin/activate

Install dependencies

pip install -r requirements.txt

Using uv

uv venv .venv
uv pip install -r requirements.txt

Run the game

Using python

python src/main.py

Using uv

uv run python src/main.py

Requirements

• An Ollama server running locally or in the location defined in the .env file.