عن المشروع

LLM Gamebook هو إطار عمل لإنشاء قصص تفاعلية حيث يتم توليد الروايات بواسطة النماذج اللغوية الكبيرة (LLMs) مع اتباع رسم بياني منظم لمسارات القصة. يعتمد النظام على بنية monorepo تتكون من خلفية برمجية باستخدام FastAPI وواجهة أمامية باستخدام React. تشمل المكونات التقنية الرئيسية ما يلي: - StoryEngine و EngineManager: يتوليان إدارة تفاعلات وكلاء LLM، وسجل الرسائل، وتجميع الحالات (instance pooling). - StoryContext و SessionState: يديران تعريفات المشروع، وسمات الكيانات، وتتبع تقدم اللاعب من خلال انتقالات عقد الرسم البياني. - MessageBus: نظام pub/sub غير متزامن لإدارة دورات حياة المحرك وأحداث الجلسة. - ProjectManager: يتولى تحميل تعريفات القصص من ملفات YAML. يتم تعريف القصص عبر ملفات YAML، مما يسمح للمطورين بتحديد أنواع الكيانات، وأقواس القصة المستندة إلى الرسوم البيانية، والمواقع، والشخصيات، ووظائف الأدوات التي يمكن لـ LLM استدعاؤها لتحفيز انتقالات الحالة. تتضمن الحزمة التقنية FastAPI و SQLModel (aiosqlite) و Pydantic AI لاستدعاء الأدوات، و Jinja2 لقوالب المطالبات (prompt templating) في الخلفية، مع واجهة أمامية تعتمد على React 19 و TypeScript و Mantine UI.