Skip to main content

Moteur de jeu narratif piloté par LLM (headless) : univers persistants SQLite, arbitrage LLM, event-sourcing/rewind, mémoire vectorielle.

Project description

axiomai-engine

Moteur de jeu narratif piloté par LLM, headless (aucune interface graphique requise).

  • Univers persistants en SQLite, versionnables en arborescence texte (« Universe-as-Code »)
  • Narration arbitrée par LLM (Gemini, Ollama, ou tout endpoint OpenAI-compatible)
  • Event-sourcing : chaque tour est rejouable, le temps de jeu est rembobinable (rewind)
  • Mémoire vectorielle long-terme (ChromaDB + sentence-transformers)
  • Modes de jeu : Normal, Hardcore (mort permanente), Companion (héros co-piloté par IA)
  • CLI complet : axiom play, axiom compile, axiom populate, axiom save-*

Installation

pip install axiomai-engine

Démarrage rapide

import axiom
axiom.help()   # guide intégré : 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("MonUnivers.db", "Alice", "Normal")

s = axiom.Session("MonUnivers.db", save_id, llm=llm)
result = s.take_turn("J'ouvre la porte de la taverne.")
print(result.narrative_text)

Projet

Code source, application graphique (vitrine du moteur) et suivi des bugs : https://github.com/Frosoore/AxiomAI

Licence

AGPL-3.0-or-later — voir LICENSE. Citation de l'origine requise en cas de redistribution (terme additionnel AGPLv3 §7(b)) — voir NOTICE.

Ce package est développé dans le mono-repo Axiom AI, dont l'application graphique sert de vitrine au moteur. Version 0.1.2.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

axiomai_engine-0.1.2.tar.gz (186.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

axiomai_engine-0.1.2-py3-none-any.whl (207.1 kB view details)

Uploaded Python 3

File details

Details for the file axiomai_engine-0.1.2.tar.gz.

File metadata

  • Download URL: axiomai_engine-0.1.2.tar.gz
  • Upload date:
  • Size: 186.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for axiomai_engine-0.1.2.tar.gz
Algorithm Hash digest
SHA256 01d759e65f0e0b8ed8df736384cfe6857741049071c8fa40e3e5130d858f5767
MD5 01e2f17af1e763c8d8aa1f47001170fd
BLAKE2b-256 444f612f6d1963a96be38d3ec69af965fff00037b018610d0db72a6b75b237e4

See more details on using hashes here.

File details

Details for the file axiomai_engine-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: axiomai_engine-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 207.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for axiomai_engine-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3498d84d737318d15d68121787ab932c1556d7cd83bed1849250828a24bb3773
MD5 bfa1fe6aa045918e1fced3b9d1725ff0
BLAKE2b-256 d4693e71f57e2c0e9e1ebf8b1ebd3da7db8aaea493760b196ca1b8e2ea906524

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page