Update README.md

README.md

@@ -9,5 +9,142 @@ app_file: app.py
 pinned: false
 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
+🌟 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:
+
+    🎭 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.
+⚙️ 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
+
+✅ Interactive moral choice engine
+✅ Seraphina + Malachar dual-voice guides
+✅ Symbol evolution system (Hope, Ambition, Burden)
+✅ 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
+
+    Modular Python Backends – Separate logic per agent, designed to coordinate
+
+🧭 Demo Suggestions
+
+Here’s how to explore Dungeon Smasher’s modular agent systems:
+🧙 Try the AI Dungeon Master
+
+    Run the DM Assistant.
+
+    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"
+
+    Watch the DM generate a scene setup, tone, and hooks for encounters or player decisions.
+
+👥 Generate an Intelligent NPC
+
+    Open the NPC Generator.
+
+    Try inputs like:
+    "an informant in a crime-ridden city"
+    "a cursed knight guarding forgotten ruins"
+
+    The NPC will return with motivations, secrets, backstory hooks, and roleplaying tips.
+
+🗺️ Build a Region or Faction
+
+    Use the World Builder.
+
+    Type prompts like:
+    "a coastal nation obsessed with prophecy"
+    "a desert empire fallen to shadow"
+
+    You’ll get a named region, faction structure, power conflicts, and thematic details.
+
+💰 Create Unique Loot or Magic Items
+
+    Run the Loot Master.
+
+    Prompt with:
+    "a cursed artifact from a sunken temple"
+    "a gift from a dragon who respects mercy"
+
+    See how the loot ties into story, alignment, and gameplay mechanics.
+
+🐉 Build a Heroic Character
+
+    Open the Character Creator.
+
+    Prompt with:
+    "A rogue raised by nobility but haunted by secrets"
+    "A storm sorcerer who fears their own magic"
+
+    The system outputs stats, class, race, personality, narrative flaws, and potential arcs.
+
+🎯 Future Goals
+
+    Fully playable narrative loop with dungeon crawl interface
+
+    Combat simulation + stat-driven decisions
+
+    Campaign memory and persistent NPC state
+
+    Player reputation, fear, and legend-tracking
+
+    Voice narration and agent expression for NPCs and DM
+
+📄 License
+
+💬 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.
+
+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.
+
+Sincerely,
+
+Jesse W. Stucker
+ghost logic. is still running
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference