Spaces:
Sleeping
Sleeping
| title: D'n'D Campaign Manager | |
| emoji: 🎲 | |
| colorFrom: purple | |
| colorTo: red | |
| sdk: gradio | |
| sdk_version: 6.0.1 | |
| app_file: app.py | |
| pinned: false | |
| license: mit | |
| # 🎲 D'n'D Campaign Manager | |
| A complete AI-powered D&D 5e character creator and campaign management system built with Gradio. | |
| ## Features | |
| ### Character Creation | |
| - **AI-Powered Generation**: Create fully-detailed D&D 5e characters with backstories, personality traits, and equipment | |
| - **Race & Class Support**: All standard D&D 5e races and classes | |
| - **Background System**: Rich backgrounds with personality traits, ideals, bonds, and flaws | |
| - **Portrait Generation**: AI-generated character portraits using DALL-E 3 or HuggingFace | |
| - **Character Export**: Export to Markdown, JSON, or HTML character sheets | |
| ### Campaign Management | |
| - **Campaign Synthesis**: AI creates complete campaigns tailored to your party composition | |
| - **Session Tracking**: Track campaign sessions and important events | |
| - **Character Integration**: Automatically weaves character backstories into campaign narrative | |
| - **Campaign Notes**: Detailed NPCs, locations, adventure hooks, and session outlines | |
| ### What Makes This Special | |
| The **Campaign Synthesis** feature analyzes your entire party (backstories, alignments, classes, personalities) and generates: | |
| - Custom adventure hooks that tie into each character's background | |
| - NPCs connected to party members | |
| - Locations relevant to the party's story | |
| - Session-by-session progression outlines | |
| - Character connections explaining how the party knows each other | |
| - Villains with personal stakes for each PC | |
| ## Configuration | |
| This app requires API keys for AI features. Set them as Hugging Face Space secrets: | |
| ### Required (choose one): | |
| - `OPENAI_API_KEY` - For OpenAI GPT-4 (recommended for best results) | |
| - `ANTHROPIC_API_KEY` - For Claude models | |
| ### Optional: | |
| - `HUGGINGFACE_TOKEN` - For HuggingFace image generation (fallback) | |
| - `GEMINI_API_KEY` - For Google Gemini models (optional alternative) | |
| ## How to Use | |
| 1. **Create Characters**: Go to "Create Character" tab and fill in the basic details | |
| 2. **Select Party**: In "Campaign Management" → "Synthesize from Characters", select multiple characters | |
| 3. **Generate Campaign**: Click "Synthesize Campaign" to create a custom campaign | |
| 4. **Track Progress**: Use "Session Tracking" to record events and progress | |
| ## Local Development | |
| ```bash | |
| # Clone the repository | |
| git clone <your-repo-url> | |
| cd dungeon-smasher-pro | |
| # Install dependencies | |
| pip install -r requirements.txt | |
| # Set up environment variables | |
| cp .env.example .env | |
| # Edit .env with your API keys | |
| # Run the app | |
| python3 app_v2.py | |
| ``` | |
| ## Tech Stack | |
| - **Gradio 5.38.2** - Web UI framework | |
| - **OpenAI GPT-4** - Character and campaign generation | |
| - **DALL-E 3** - Portrait generation | |
| - **SQLite** - Character and campaign storage | |
| - **Pydantic** - Data validation | |
| ## Architecture | |
| ``` | |
| src/ | |
| ├── agents/ # Business logic | |
| │ ├── character_agent.py | |
| │ └── campaign_agent.py | |
| ├── models/ # Pydantic data models | |
| │ ├── character.py | |
| │ └── campaign.py | |
| ├── ui/ # Gradio interface | |
| │ └── character_creator_ui.py | |
| └── utils/ # AI client utilities | |
| └── ai_client.py | |
| ``` | |
| ## Credits | |
| Built with ❤️ for D&D players and Dungeon Masters everywhere. | |
| ## License | |
| # Trigger rebuild to load secrets |