Skip to content
/ dndbot Public

The opd-ai/dndbot project is an innovative bot that creates D&D adventure series using Claude, delivering endless adventure possibilities for enthusiasts. It ensures a seamless and immersive experience, making it a must-have tool for Dungeons & Dragons fans.

License

Notifications You must be signed in to change notification settings

opd-ai/dndbot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ae302cb Β· Jan 18, 2025
Dec 18, 2024
Jan 18, 2025
Dec 23, 2024
Dec 19, 2024
Dec 18, 2024
Dec 16, 2024
Dec 18, 2024
Dec 23, 2024
Dec 23, 2024
Dec 23, 2024
Dec 18, 2024
Dec 23, 2024
Dec 17, 2024
Dec 23, 2024

Repository files navigation

Adventure Forge 🎲✨

An AI-powered D&D adventure generator that creates complete, playable RPG content using Claude AI. Generate professional-grade adventures in minutes, complete with illustrations, maps, and organized documentation.

Core Features

  • Real-Time Adventure Generation

    • Complete D&D adventure modules
    • Rich narrative content
    • System-agnostic design
    • Copyright-compliant material
  • Advanced Content Pipeline

    • Table of contents generation
    • Cover pages and artwork
    • Dungeon design and mapping
    • Adventure content expansion
    • Illustration prompts
    • Content review and validation
  • Professional Output

    • Structured markdown formatting
    • ZIP file packaging
    • PDF compilation
    • Organized file hierarchy

Installation

  1. Prerequisites
- Go 1.21.3 or higher
- Make
  1. Environment Setup
# Clone the repository
git clone https://github.com/your-org/dndbot.git
cd dndbot

# Copy and edit configuration
cp config.mk.example config.mk
  1. Required Environment Variables
export CLAUDE_API_KEY="your-api-key"
export HORDE_API_KEY="your-horde-key"  # Optional for image generation
export SD_WEBUI_URL="your-sd-url"      # Optional for local image generation

Usage

Running the Server

# Build and run with default settings
make run

# Run with custom arguments
make run args="-port 3000 -domain localhost"

Docker Deployment

# Build Docker image
make docker

# Run container
make docker-run

Configuration Options

Server configuration flags:

-paywall    Enable payment requirements
-tls        Enable TLS/HTTPS
-mail       Email for certificates
-domain     Server domain name
-port       Server port number

API Documentation

See API.md for detailed API documentation.

Development

Project Structure

dndbot/
β”œβ”€β”€ cmd/          # Command line tools
β”œβ”€β”€ srv/          # Server implementation
β”‚   β”œβ”€β”€ ui/       # Web interface
β”‚   └── generator/# Core generation logic
β”œβ”€β”€ src/          # Core library
└── static/       # Web assets

Building from Source

# Format code
make fmt

# Build binary
make build

# Clean build artifacts
make clean

Testing

# Run test suite
go test ./...

# Run with Firefox profile
make fox

Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit changes with clear messages
  4. Push to your branch
  5. Create a Pull Request

License

GNU Affero General Public License v3.0 - See LICENSE.md

Security Considerations

  • Rate limiting implemented
  • CORS protection enabled
  • Security headers configured
  • TLS support available

Technical Stack

  • Backend: Go
  • API: Claude AI (Anthropic)
  • Image Generation: Stable Diffusion
  • Web Interface: HTML/CSS/JavaScript
  • Storage: File-based + In-memory cache

Support

If you find this project useful, consider supporting the developer:

Monero Address: `43H3Uqnc9rfEsJjUXZYmam45MbtWmREFSANAWY5hijY4aht8cqYaT2BCNhfBhua5XwNdx9Tb6BEdt4tjUHJDwNW5H7mTiwe`
Bitcoin Address: `bc1qew5kx0srtp8c4hlpw8ax0gllhnpsnp9ylthpas`

Acknowledgements

  • Claude AI by Anthropic
  • Stable Diffusion
  • Go Chi router
  • Contributors and maintainers

About

The opd-ai/dndbot project is an innovative bot that creates D&D adventure series using Claude, delivering endless adventure possibilities for enthusiasts. It ensures a seamless and immersive experience, making it a must-have tool for Dungeons & Dragons fans.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published