Update README.md

README.md

@@ -1,4 +1,4 @@
----
+------
 title: Dungeon Smasher
 emoji: 👁
 colorFrom: yellow
@@ -7,140 +7,118 @@ sdk: gradio
 sdk_version: 5.33.1
 app_file: app.py
 pinned: false
+tags:
+  - agent-demo-track
+  - AI dungeon master
+  - procedural generation
+  - worldbuilding
+  - intelligent NPCs
+  - storytelling
+  - RPG
+  - multi-agent
 short_description: Multi-agent AI that smashes through D&D prep work.
 ---
+
 🧠 Dungeon Smasher
 
 An Agentic Toolkit for Dynamic RPG Storytelling
-
-Track: #agent-demo-track
-Keywords: #AI dungeon master, #procedural generation, #intelligent NPCs, #worldbuilding, #agent coordination
+Built for the Hugging Face AI Agent Hackathon — Agent Demo Track
 🌟 Overview
 
-Dungeon Smasher is an experimental AI toolkit for building intelligent, reactive tabletop-style RPG environments. Rather than a finished game, this submission is a modular agent demo featuring:
+Dungeon Smasher is an experimental AI toolkit for building intelligent, reactive RPG environments. Rather than a finished game, this is a modular agent demo showcasing five core systems:
 
     🎭 DM Assistant · 👥 NPC Generator · 🗺️ World Builder · 💰 Loot Designer · 🐉 Character Creator
 
-Each module is powered by LLM-guided reasoning and purpose-built to create dynamic, coherent narrative systems for fantasy worlds. It's the first step toward a truly adaptive, player-driven dungeon experience.
+Each module uses LLM reasoning and symbolic world logic to help GMs and players co-create immersive adventures—no prep required.
 ⚙️ Core Features
 Feature	Description
-🎭 AI Dungeon Master	Orchestrates scenarios, moral dilemmas, and world tone using symbolic AI logic
-👥 Intelligent NPC Generator	Generates named characters with motivations, secrets, goals, and voice tones
-🗺️ World Builder Agent	Procedurally assembles regions, political factions, ancient lore, and thematic conflicts
-💰 Loot Master	Crafts unique magical items and intelligently distributes rewards tied to playstyle
-🐉 Enhanced Character Creator	Creates PCs with full stat blocks, backstory, class synergy, and emotional traits
-🧪 What Works in This Demo
-✅ Procedural NPC, item, and region generation
-✅ Character builder with backstory + stat logic
-✅ Gradio UI for testing agent modules
-🧠 Agentic Architecture
-
-Each tool is its own intelligent system, with shared memory and symbolic evolution. They can be run individually or woven into a shared campaign.
-Agent Role	What It Does
-DM Assistant	Manages alignment, reacts to player choices, and coordinates the scenario engine
-World Builder	Generates nations, ruins, factions, landscapes based on theme and narrative direction
-NPC Generator	Crafts compelling side characters, rivals, and allies with built-in emotional state logic
-Loot Master	Designs intelligent magical items with gameplay relevance and narrative symbolism
-Character Creator	Offers class builds, moral alignment shaping, backstories, and personality scaffolding
-🚀 Run the Demo
-
-git clone https://huggingface.co/spaces/YOUR_USERNAME/DungeonSmasher
-cd DungeonSmasher
-
-pip install -r requirements.txt
-python app.py
-
-Or use the Hugging Face Space:
-🌐 https://huggingface.co/spaces/YOUR_USERNAME/DungeonSmasher
-🛠️ Technologies
-
-    Gradio 4.19.2 – Interactive agent dashboard
-
-    OpenAI GPT-4 – Powers multi-agent reasoning and content generation
-
-    Custom Symbol Engine – Tracks morality, ambition, and sacrifice over time
+🎭 AI Dungeon Master	Orchestrates scenes, conflicts, and roleplay hooks with dramatic tone
+👥 NPC Generator	Builds named characters with secrets, flaws, goals, and voice
+🗺️ World Builder	Assembles regions, ruins, factions, and mythic histories
+💰 Loot Master	Designs magical items that reflect player actions and narrative symbols
+🐉 Character Creator	Generates heroes with stats, backstories, class synergy, and emotional arcs
+🧪 Demo Capabilities
+
+✅ Procedural setting, NPC, and loot generation
+✅ Modular agent logic with memory and context threading
+✅ Gradio-based interactive frontend for testing each system
+✅ Rich character builder with storytelling-first logic
+✅ Configurable, extensible, and fully open source
+🧭 Demo Suggestions
 
-    Modular Python Backends – Separate logic per agent, designed to coordinate
+Explore the toolkit using these suggested flows:
+🧙 Dungeon Master Agent
 
-🧭 Demo Suggestions
+    Prompt with: "The players enter a ruined cathedral during a thunderstorm"
 
-Here’s how to explore Dungeon Smasher’s modular agent systems:
-🧙 Try the AI Dungeon Master
+    Watch it generate narrative tension, scene tone, and roleplay threads.
 
-    Run the DM Assistant.
+👥 NPC Generator
 
-    Prompt with a situation like:
-    "The players enter a ruined cathedral during a thunderstorm"
-    or
-    "A festival hides a deadly secret beneath the wine and song"
+    Prompt with: "a cursed knight guarding forgotten ruins"
 
-    Watch the DM generate a scene setup, tone, and hooks for encounters or player decisions.
+    Get a complex NPC with motives, secrets, and drama potential.
 
-👥 Generate an Intelligent NPC
+🗺️ World Builder
 
-    Open the NPC Generator.
+    Prompt with: "a coastal nation obsessed with prophecy"
 
-    Try inputs like:
-    "an informant in a crime-ridden city"
-    "a cursed knight guarding forgotten ruins"
+    Generates factions, politics, threats, and lore.
 
-    The NPC will return with motivations, secrets, backstory hooks, and roleplaying tips.
+💰 Loot Master
 
-🗺️ Build a Region or Faction
+    Prompt with: "a cursed artifact from a sunken temple"
 
-    Use the World Builder.
+    Produces symbolic, story-linked loot tied to in-game values.
 
-    Type prompts like:
-    "a coastal nation obsessed with prophecy"
-    "a desert empire fallen to shadow"
+🐉 Character Creator
 
-    You’ll get a named region, faction structure, power conflicts, and thematic details.
+    Prompt with: "A storm sorcerer who fears their own power"
 
-💰 Create Unique Loot or Magic Items
+    Returns stat blocks, class alignment, flaws, and heroic potential.
 
-    Run the Loot Master.
+🛠️ Technologies
 
-    Prompt with:
-    "a cursed artifact from a sunken temple"
-    "a gift from a dragon who respects mercy"
+    Gradio 5.33.1 — Live demo interface
 
-    See how the loot ties into story, alignment, and gameplay mechanics.
+    OpenAI GPT-4 — Agent reasoning and generation
 
-🐉 Build a Heroic Character
+    Python (modular) — Custom agent scaffolding and game logic
 
-    Open the Character Creator.
+🚀 How to Run
 
-    Prompt with:
-    "A rogue raised by nobility but haunted by secrets"
-    "A storm sorcerer who fears their own magic"
+git clone https://huggingface.co/spaces/YOUR_USERNAME/DungeonSmasher
+cd DungeonSmasher
 
-    The system outputs stats, class, race, personality, narrative flaws, and potential arcs.
+pip install -r requirements.txt
+python app.py
 
-🎯 Future Goals
+Or view the live app at:
+🌐 https://huggingface.co/spaces/YOUR_USERNAME/DungeonSmasher
+🎯 Future Plans
 
-    Fully playable narrative loop with dungeon crawl interface
+    Playable dungeon mode with live turn-based flow
 
-    Combat simulation + stat-driven decisions
+    AI narrator voice + dialogue puppeteering
 
-    Campaign memory and persistent NPC state
+    Campaign memory and recurring characters
 
-    Player reputation, fear, and legend-tracking
+    Dynamic player reputation, fear, and legacy
 
-    Voice narration and agent expression for NPCs and DM
+    Fully voiced roleplay loop via multimodal input
 
 📄 License
 
+MIT License – Use freely, remix bravely.
 💬 Final Note to Judges
 
-On Friday June 6th, I was unexpectedly terminated from my job. This wasn’t just a professional setback. It triggered a cascade of urgent and high-stakes responsibilities. I’ve spent the past several days filing legal responses and preparing to escalate claims of retaliation, IP theft, and unlawful recording. I’ve had to act as my own advocate, researcher, and legal strategist under intense emotional and logistical pressure.
+OOn Friday June 6th, I was unexpectedly terminated from my job. This wasn’t just a professional setback. It triggered a cascade of urgent and high-stakes responsibilities and I’ve spent the past several days filing legal responses and preparing to escalate claims of retaliation, IP theft, and unlawful recording. I’ve had to act as my own advocate, researcher, and legal strategist, at present.
 
 This sudden derailment had a significant impact on my ability to finalize my hackathon submission. While I still submitted something, it reflects only a fraction of what I’d intended to build. I wanted to share this contextas an honest explanation of why my submission may seem incomplete or rushed and not as an excuse.
 
-I’m grateful for the opportunity and for the space to create, even amidst personal crisis.
+I’m grateful for the opportunity to bring this to life and for the space to create, even amidst personal crisis.
 
-Sincerely,
 
-Jesse W. Stucker
-ghost logic. is still running
+Sincerely,
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+— Jesse W. Stucker (ghost logic.)