LLM 🎲 GM Practice

A Deno-powered web application that demonstrates how to use an LLMs in your Deno project.

Quick Start

Prerequisites

• Deno installed on your system
• API keys for OpenAI or Anthropic for real LLM responses

Local Development

1. Clone and setup:

   cd your-project-directory

2. Set up environment variables (optional):

   # For real LLM responses, set one of these:
   export OPENAI_API_KEY="your-openai-key-here"
   # OR
   export ANTHROPIC_API_KEY="your-anthropic-key-here"

3. Run the development server:

   deno task dev

4. Open your browser to http://localhost:8000

How to Play

1. Start a New Game: Enter a scenario in the GM prompt box
2. Watch the Magic: AI characters will introduce themselves
3. Guide the Adventure: Add new prompts as the GM
4. Enjoy the Story: Watch as characters interact and respond creatively

Example Scenarios

• "You find yourselves in a tavern when a mysterious hooded figure approaches your table..."
• "A dragon has been terrorizing the nearby village. The mayor offers a reward for its defeat."
• "You discover an ancient dungeon entrance hidden behind a waterfall."

Project Structure

├── main.ts                 # Main server entry point
├── main_test.ts            # Test file
├── deno.json               # Deno configuration
├── .env                    # Copy the example env file provided
├── src/
│   ├── config/
│   │   ├── characters.ts   # Character configurations and presets
│   │   └── scenarios.ts    # Pre-defined scenario templates
│   ├── game/
│   │   ├── GameManager.ts  # Core game logic and state management
│   │   └── Character.ts    # AI character implementation
│   ├── llm/
│   │   └── LLMProvider.ts  # LLM integration layer (OpenAI/Anthropic)
│   └── server/
│       └── WebSocketHandler.ts # Real-time communication
└── static/
    ├── index.html         # Web interface
    ├── styles.css         # Application styling
    └── example-opening.txt # Sample scenario text

LLM Configuration

The application supports multiple LLM providers:

Mock Mode (Default)

• No API keys required
• Great for testing and demonstrations
• Provides contextual responses based on character personalities

OpenAI Integration

// Set environment variable
export OPENAI_API_KEY="your-key-here"

Anthropic Integration

// Set environment variable
export ANTHROPIC_API_KEY="your-key-here"

Deployment to Deno Deploy

1. Prepare your project:

   # Ensure all dependencies are properly configured in deno.json

2. Deploy to Deno Deploy:

   • Push your code to GitHub
   • Connect your repository to Deno Deploy
   • Set environment variables in the Deno Deploy dashboard
   • Deploy with entry point: main.ts

3. Set Environment Variables in Deno Deploy dashboard:

   • OPENAI_API_KEY (if using OpenAI)
   • ANTHROPIC_API_KEY (if using Anthropic)

Default Characters

The application comes with three pre-configured characters:

• Tharin (Fighter): Brave and loyal, always ready to protect allies
• Lyra (Wizard): Curious and analytical, loves solving puzzles
• Finn (Rogue): Witty and sneaky, prefers clever solutions

Development Commands

# Start development server with file watching
deno task dev

# Start production server
deno task start

# Run tests
deno task test

# Type check
deno check main.ts

Customization

Adding New Characters

Modify the character configuration in main.ts:

characters: [
  { name: "YourCharacter", class: "YourClass", personality: "Your personality description" },
  // ... more characters
]

Changing LLM Behavior

Edit the system prompts in Character.ts to adjust how characters respond.

Styling the Interface

Customize the application's appearance by editing static/styles.css and static/index.html for your preferred look and functionality.

API Endpoints

• GET / - Web interface
• POST /api/game/start - Start a new game
• GET /api/game/status?gameId={id} - Get game status
• WebSocket /ws - Real-time game communication

Example Usage

// Starting a new game
const response = await fetch('/api/game/start', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    gmPrompt: "You enter a mysterious forest...",
    characters: [
      { name: "Hero", class: "Paladin", personality: "Noble and just" }
    ]
  })
});

Example opening scenario

You awake to find yourself in a dark room, you can see only as far as your hand in front of your face. You can smell damp in the air and feel cold flagstones beneath your hands as you try to get up. You can hear others around you doing the same.

Contributing

This project demonstrates modern Deno development practices:

• TypeScript throughout
• Standard library usage
• WebSocket real-time communication
• Modular architecture
• Cloud deployment ready

Feel free to extend it with:

• More LLM providers
• Enhanced character AI
• Persistent game storage
• Multi-room support
• Voice integration

License

This project is open source and available under the MIT License.

---

Built with ❤️ and Deno for the modern web!