Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (infinite-realms) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Infinite Realms

AI-powered solo Dungeons & Dragons 5th Edition experience.

Features

AI Dungeon Master - GPT-4 powered DM with tool-calling for game mechanics
Character Management - Create and manage D&D 5e characters
D&D Beyond Sync - Import and sync characters from D&D Beyond
Combat System - Initiative tracking, HP management, turn order
Quest & NPC Tracking - Automatic tracking of encountered NPCs and quests
Scene Image Generation - DALL-E 3 generated scene images
Text-to-Speech - Browser-based voice narration for DM responses
Rules Enforcement - Configurable RAW enforcement levels

Tech Stack

Framework: Next.js 15 (App Router)
Frontend: React 19, Tailwind CSS, Radix UI
AI: OpenAI GPT-4o, DALL-E 3 (via Vercel AI SDK)
Database: PostgreSQL
Language: TypeScript

Getting Started

Prerequisites

Node.js 18+
PostgreSQL 15+
OpenAI API key

Installation (via CLI)

You can install Infinite Realms globally and run it directly:

# Using npm
npm install -g infinite-realms

# Using yarn
yarn global add infinite-realms

Then start the application from anywhere:

infinite-realms

Manual Installation (Development)

Clone and install dependencies:

git clone https://github.com/your-username/infinite-realms.git
cd infinite-realms
npm install

Set up environment variables:
```
cp .env.example .env.local
```
Edit .env.local with your database URL and optionally your OpenAI API key.

Set up the database:

# Create the database
createdb dndsolo

# Run the app and hit the "Setup DB" button, or:
npm run db:schema

Start the development server:
```
npm run dev
```
Open http://localhost:3000

License

Infinite Realms is licensed under a custom agreement. It is free to use and we welcome contributions. However, modification for redistribution and direct redistribution of the software are not permitted. Infinite Realms reserves the exclusive right to provide hosted versions of the software.

See the LICENSE file for the full terms.