منصوبے کے بارے میں

Storyloom ایک AI‑پاورڈ ویژوال ناول انجن ہے جو حقیقی وقت میں نریٹیو پیدا کرتا ہے۔ یہ streaming XML pipeline (StreamParser → StateManager → EventDispatcher) استعمال کرتا ہے جو LLM کے آؤٹ پٹ کو بافرنگ کے بغیر لائن‑بے‑لائن پڑھتا ہے، اور ایک bridge pre‑fetch میكانزم ہے جو próxima API کال کو پاراگراف کے درمیان چلا کر پڑھنے کے وقت کی دیرانی کو چھپاتا ہے۔ اہم صلاحیتیں شامل ہیں: - دو گیم موڈز: ٹیکسٹ اور گراف، جن میں سین‑اندر چوائسز اور چیک پوائنٹس پر آؤٹ لائن‑لیول روٹ فورکس شامل ہیں - کردار اسپرائٹس اور سین بیک گراؤنڈز، جن کے لیے ایسیٹ pipeline O(1) catalogue match، LLM fallback اور async AI generación کرتا ہے - State validation جہاں LLM لکھنے کی تجویز دیتا ہے اور انجن لاگو کرنے سے پہلے type‑check کرتا ہے؛ منکوب لکھنے دوبارہ مودل میں فیڈ 백 ہوتے ہیں - Context management sliding window، permanent system prompt anchor اور checkpoint compression (~50K tokens) کے ذریعے - Co‑creation flow جہاں AI استعمال کرنے والے سے ان کی خیال کے بارے میں انٹرویو کرتا ہے تاکہ دنیا، کردار اور plot پیدا کرنے سے پہلے - Atomic JSON saves جو mode‑agnostic ہیں، جس کی وجہ سے ٹیکسٹ اور گراف موڈز کے درمیان کبھی بھی تبدیلی کی جا سکتی ہے - i18n support انگریزی، سادہ چینی اور روایتی چینی کے لیے gettext کے ذریعے - Web UI FastAPI + SSE + vanilla JS SPA پر مبنی ہے، جس میں pywebview کے ذریعے اختیاری نیٹو ڈیسک ٹاپ وینڈو شامل ہو سکتا ہے انسٹال کرنے کے اختیارات شامل ہیں: اسٹینڈ الون بائنری (پائتھن کی ضرورت نہیں)، PyPI 휠 (پائتھن ≥ 3.10)، اور سورس سے۔ اختیاری اضافوں میں نیٹو ڈیسک ٹاپ وینڈو سپورٹ اور onnxruntime کے استعمال سے جنریٹ شدہ تصاویر کا بیک گراؤنڈ ہٹانا شامل ہے۔ پروเจक्ट MIT لائسنس شدہ ہے اور stdlib‑first پایتھن کنونشن کے ساتھ Conventional Commits کی پابندی کرتا ہے۔