✦ Lumina AI — Desktop App

3D Game Creator using Hunter-Alpha (OpenRouter BYOK)

A desktop app that generates fresh, playable 3D games (self-contained Three.js HTML) by calling the Hunter-Alpha model via OpenRouter. You bring your own OpenRouter API key; nothing is pre-baked.

🚀 Quick Start (Run from Source)

Prerequisites

• Node.js v18 or higher
• An OpenRouter API key from https://openrouter.ai

Steps

# 1. Navigate to this folder
cd LuminaAI

# 2. Install dependencies
npm install

# 3. Launch the app
npm start

On launch, open Settings, paste your OpenRouter API key, then open 3D Game Creator, describe a game, and Lumina will ask Hunter-Alpha to generate a unique playable game with live preview.

📦 Build a Distributable App

macOS (.dmg)

npm run build:mac
# Output: dist/Lumina AI-1.0.0.dmg

Windows (.exe installer)

npm run build:win
# Output: dist/Lumina AI Setup 1.0.0.exe

Linux (.AppImage)

npm run build:linux
# Output: dist/Lumina AI-1.0.0.AppImage

🎮 Features

• 3D Game Creator — describe a game, get a complete playable Three.js game generated by Hunter-Alpha
• Live Preview — run the generated game instantly in-app
• Save Games — download generated games as standalone .html files

⌨️ Shortcuts

| Action | Shortcut | |--------|----------| | Send message | Enter | | New line | Shift + Enter | | New chat | Sidebar button |

🛠 Tech Stack

• Electron — cross-platform desktop shell
• OpenRouter / Hunter-Alpha — AI backbone for game generation
• Three.js — 3D game rendering (loaded in-game)
• Vanilla JS + CSS — zero frontend framework overhead

Made with ✦ by Lumina AI