Skip to content

SJMakin/acererak

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

81 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Acererak

Acererak

Named after the legendary demilich, Acererak is an AI Dungeon Master that weaves intricate tales through an interactive graph-based storytelling system.

Overview

Acererak transforms the D&D storytelling experience by combining the power of AI with dynamic visual story mapping. Watch your choices branch out before you as you navigate through AI-generated narratives, each decision spawning new paths and possibilities.

Features

  • 🧙‍♂️ AI-powered Dungeon Master using OpenRouter AI models
  • 📊 Dynamic graph visualization of story progression
  • 🌳 Branching narrative paths based on player choices
  • 🎭 Rich story generation with D&D theming
  • 📜 Story summaries and detailed content views
  • 🎯 Interactive node-based navigation

Getting Started

  1. Clone the repository:
git clone https://github.com/username/acererak.git
cd acererak
  1. Install dependencies:
npm install
  1. Start your adventure:
npm run dev

API Keys

Acererak now uses OpenRouter for AI capabilities. Users need to:

  1. Create an account at OpenRouter
  2. Generate an API key from the OpenRouter Keys page

The app will prompt users to enter their API key, which will be securely stored in their browser's local storage.

Why OpenRouter?

OpenRouter provides access to multiple AI models, offering:

  • Higher quality storytelling
  • More consistent responses
  • Support for structured output

Deployment

See DEPLOYMENT.md for detailed instructions on how to deploy Acererak on a VPS with nginx.

Project Architecture

  • /src
    • /components - React components including the story graph
    • /contexts - Game state and narrative progression
    • /services - AI integration and story generation
    • /types - TypeScript definitions

Development

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

Roadmap

  • 📝 Character creation and progression
  • 🎲 Skill checks and saving throws
  • 💾 Save/load functionality
  • 🌐 Campaign sharing
  • 🎮 Enhanced graph interactions

Contributing

Contributions are welcome! Feel free to:

  • 🐛 Report bugs
  • 💡 Suggest features
  • 🛠️ Submit pull requests

License

MIT © [Your Name]


"Life is short. Undeath is eternal." - Acererak

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •