IhorRomanovych/RLM-Text-Based-Game-Saigilo

A text adventure game based on the life story of Saigilo, a Datooga King and medicine man (fl. 1890) from East Africa. Built using the [Recursive Language Models (RLM)](github.com) framework for unbounded context processing. # The Prophecies of Saigilo A text adventure game based on the life story of Saigilo, a Datooga King and medicine man (fl. 1890) from East Africa. Built using the Recursive Language Models (RLM) framework for unbounded context processing. ## Overview Play as Saigilo through 6 chapters of his life: 1. **The Exodus** (c. 1836-1851) — Fleeing the Maasai from Ngorongoro Crater 2. **Rise of a Leader** (c. 1850s) — Becoming chief and migrating north 3. **The Medicine Man** (c. 1870s) — Establishing tribal relations 4. **Prophecies Unfold** (c. 1880s) — Predicting the arrival of "red men" 5. **The Raid** (c. 1890) — Defending against Be'a's attack 6. **Legacy and Death** (c. 1895-1910) — Succession and colonial persecution ### Features - Dynamic scene generation based on your choices - Atmospheric ASCII art for each location - Probabilistic prophecy system (outcomes depend on your actions) - Tribal relations tracking (Maasai, Iraqw, Arimi, Nyamwezi, Germans) - Free-text input — describe what Saigilo does - ~30 turns total, with chapter transitions at milestones - Streaming support for OpenCode ## Prerequisites - **Python 3.9+** (tested with 3.13) - **LM Studio** (or any OpenAI-compatible API server) - A loaded model in LM Studio (or configured API key for remote LLM) ## Quick Start ### 1. Activate the Virtual Environment **Windows (PowerShell):** ```powershell cd .\env\Scripts\Activate.ps1 ``` **macOS / Linux:** ```bash cd source env/bin/activate ``` ### 2. Start LM Studio 1. Open LM Studio 2. Load your preferred model (e.g., Qwen, Llama, Mistral) 3. Go to the **Local Server** tab (server icon on the left) 4. Click **Start Server** 5. Verify it's running on `localhost` ### 3. Start the Game Server **Windows (PowerShell):** ```powershell cd .\env\Scripts\python.exe orchestrator.py ``` **macOS / Linux:** ```bash cd python orchestrator.py ``` You should see: ``` Starting 'The Prophecies of Saigilo' Text Adventure Game FastAPI proxy on 0.0.0.127. …