Skip to content

Essam-Khawaja/Masse

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧙 AI Dungeon Master – Masse

An AI-powered Dungeon Master that crafts dynamic fantasy RPG adventures. Built for the Agentic AI Hackathon.

The website: https://ai-dm-fkr0.onrender.com/

Features

  • Generate 3-act fantasy campaigns using Gemini API
  • Let players interact freely with the story
  • Beautiful, markdown-enhanced storytelling

Tech Stack

  • Frontend: Next.js 15
  • Backend: FastAPI (Python)
  • LLM: Gemini 2.5 Flash
  • State: Local JSON for plan memory

Setup Instructions

1. Clone the repo

git clone https://github.com/Essam-Khawaja/Masse
cd Masse

2. Backend Setup

  • Create a .env file:
GEMENI_API_KEY=your_gemini_key
  • Run the backend:
pip install -r requirements.txt
uvicorn main:app --reload

3. Frontend Setup

cd frontend
npm install
npm run build
npm run start

About

This is a standardized starter repository for the Agentic AI App Hackathon, providing teams with a ready-to-use folder structure, reproducible environment spec,and documentation placeholders to streamline submissions and judging

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 45.3%
  • TypeScript 39.4%
  • CSS 10.4%
  • JavaScript 4.9%