TaleWeaver v0.5.0-beta

TaleWeaver Release v0.5.0-beta 🚀

Welcome to TaleWeaver v0.5.0-beta! This release marks a significant milestone, shifting TaleWeaver from a text-and-audio game to a fully immersive generative RPG platform with local speech processing, a fully functional world builder, and story expansion features.

🎧 Speech-to-Text & Push-to-Talk (PTT)

Experience true hands-free roleplaying. Speak directly to your AI Gamemaster or converse in-character with NPCs.

• OpenAI Whisper Integration: Support for local Whisper model execution.
• Background Preloading: Whisper models load in a separate background thread to keep the user interface fully responsive, displaying real-time loading states.
• Push-to-Talk: Press and hold UI mic buttons or keys (V, B, or T) to capture audio, with instant auto-transcription and submission upon release.
• In-Character Speech Shortcuts: Hold down B, T, or Shift to automatically prepend /say to your message, seamlessly shifting between gameplay actions and direct spoken dialogue.

🛠️ Fully Functional Adventure Editor

You can now create, edit, and build complete adventure templates from scratch or customize existing ones directly in the app.

• Full CRUD Management: Create, read, update, and delete scenes, exits, quests, NPCs, items, containers, and switch outcomes.
• Bidirectional Route Mapping: Exit creation handles bidirectional linking automatically, storing connections cleanly in a single database row.
• Asset Integration: Associate custom visual assets, set styles, and refine details of all generated entities.

🌀 Cover Mode (Sequels & Variations)

Expand your library by generating sequels or spinoffs of your favorite adventures.

• Similarity Index: Set a similarity index (from 0% for freely inspired variants to 100% for close sequels).
• Asset Portability: Toggle the reuse of visual styles and media assets from the original cover source to keep the look-and-feel consistent across generations.

⚙️ Core Enhancements & Stability

• Chronicles Checkpoints & Timeline Rollback: Automatically saves your state at major milestones (scene entry, quest updates, achievement unlocks). The new Chronicles timeline allows you to rewind time and roll back the story.
• Interactive World Map: Fully interactive map with pathfinding, panning, and zoom support to visualize connections between your scenes.
• Path Traversal Security Hardening: Hardened path handling routines across media routes and APIs to mitigate uncontrolled file system risks.
• Robust Serialization & Import/Export: Excluded system columns (pk, session_id, created_at, updated_at, template_id) from exports. This fixes sqlite JSON serialization errors (datetime objects not serializable) during adventure template imports.
• Model Integration: Support for new LLM providers like Kimi (Moonshot), as well as automatic LLM blank JSON retry logic to maximize parsing success rates.

---

🧪 Installation & Running

Backend

Make sure to apply database migrations before launching:

# Activate virtual environment
venv\Scripts\activate  # Windows
source venv/bin/activate  # macOS/Linux
# Apply migrations
python -m alembic upgrade head
# Start FastAPI server
python -m backend.main
Frontend
bash
cd frontend
npm install
npm run dev
For Docker users, run bash scripts/docker-update.sh to fetch and apply the latest image updates.