axiomai-engine

LLM-driven narrative game engine, headless (no GUI required).

• Persistent SQLite universes, versionable as a plain-text tree ("Universe-as-Code")
• LLM-arbitrated narration (Gemini, Ollama, or any OpenAI-compatible endpoint)
• Event sourcing: every turn is replayable, in-game time can be rewound (rewind)
• Long-term vector memory (ChromaDB + sentence-transformers)
• Game modes: Normal, Hardcore (permadeath), Companion (AI co-piloted hero)
• Full CLI: axiom play, axiom compile, axiom populate, axiom save-* …

Installation

pip install axiomai-engine

Quick start

import axiom
axiom.help()   # built-in guide: API, modules, CLI

from axiom.config import load_config, build_llm_from_config
from axiom.db_helpers import create_new_save

llm = build_llm_from_config(load_config())
save_id = create_new_save("MyUniverse.db", "Alice", "Normal")

s = axiom.Session("MyUniverse.db", save_id, llm=llm)
result = s.take_turn("I push open the tavern door.")
print(result.narrative_text)

Documentation

Guides (Universe-as-Code, CLI, saves, populate, backends, images) and full API reference, in English and French: https://frosoore.github.io/AxiomAI/en/

Project

Source code, GUI application (the engine's showcase) and issue tracker: https://github.com/Frosoore/AxiomAI

License

AGPL-3.0-or-later — see LICENSE. Attribution is required when redistributing (AGPLv3 §7(b) additional term) — see NOTICE.

This package is developed in the Axiom AI mono-repo, whose GUI application showcases the engine. Version 0.2.0.