Skip to content

Hypurl/Open-ParallaxPro

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

118 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Follow on X Join Discord YouTube Instagram

Turn prompts into playable games

ParallaxPro

LLMs can generate games, but without a real game engine behind them, those games hit a wall fast -- no real physics, no efficient rendering, no entity-component system, no shadow maps, no collision detection. The AI ends up writing hundreds of lines of hacky code to approximate what any game engine gives you for free.

ParallaxPro is a browser-based 3D game engine where AI generates games that run on a real engine with real infrastructure -- WebGPU rendering, rigid body physics, skeletal animation, and an ECS architecture. The AI doesn't need to reinvent the wheel. It just places entities, attaches scripts, and the engine handles the rest.

  • Fully open source -- engine, editor, AI prompts, game templates, everything. No hidden black boxes.
  • Royalty free -- games you make are 100% yours. No revenue share, no attribution required, no strings attached.
  • No vendor lock-in -- bring your own LLM (Groq, OpenRouter, Ollama, or any OpenAI-compatible API). Host it yourself or use our cloud.
  • Transparent AI -- even the system prompts and LLM compiler are open source. See exactly how the AI builds your games.

Try It Online

The easiest way to use ParallaxPro is at parallaxpro.ai -- no setup required. You get the AI assistant, 5000+ 3D assets, game publishing, and everything else out of the box.

teaser.mp4

Run Locally

Prerequisites: Node.js 20+, npm

1. Clone the repo

git clone https://github.com/ParallaxPro-AI/Open-ParallaxPro.git
cd Open-ParallaxPro

2. Set up the backend

cd engine/backend
cp .env.example .env

Edit .env and add your LLM API key. Any OpenAI-compatible API works:

Provider AI_BASE_URL Example AI_MODEL
Groq (free) https://api.groq.com/openai/v1 llama-3.3-70b-versatile
OpenRouter https://openrouter.ai/api/v1 meta-llama/llama-3.3-70b-instruct
Local (Ollama) http://localhost:11434/v1 llama3.3

The game fixer is a powerful feature that uses a CLI coding agent to read, analyze, and edit your game's scripts and scenes. It needs a CLI agent installed to work -- without one, everything else still works but the fixer won't be available.

Currently supported:

Coming soon:

To set up Claude Code:

npm install -g @anthropic-ai/claude-code
claude  # Follow auth prompts

Then set FIXER_CLI=claude in your .env.

Install dependencies and start the backend:

npm install
npx tsx src/server.ts

The backend will start on http://localhost:3003.

3. Set up the frontend

In a new terminal:

cd engine/frontend/editor
npm install
npm run dev

The editor will open at http://localhost:5174.

4. Start building games

Open http://localhost:5174 in your browser (Chrome/Edge recommended for WebGPU). Type a game name like "chess" or "racing game" in the chat and the AI will build it for you.

How It Works

  1. You type a game prompt (e.g. "chess", "platformer", "fps shooter")
  2. The AI selects the best matching template from 10+ game templates
  3. The engine assembles the game: entities, scripts, UI, physics, FSM logic
  4. You can play immediately, then ask the AI to fix bugs or add features
  5. The fixer agent reads your game code, edits scripts, and validates changes

Creating New Game Templates

The best way to generate a completely new game from scratch is to open a CLI coding agent (like Claude Code) in the repo and ask it to create a new template:

engine/backend/src/ws/services/pipeline/reusable_game_components/
  game_templates/v0.1/   -- game templates (4-file format: flow, entities, worlds, systems)
  behaviors/v0.1/        -- per-entity behavior scripts (movement, combat, AI, etc.)
  systems/v0.1/          -- multi-entity system scripts (game managers, level logic)
  ui/v0.1/               -- HTML UI overlays (HUD, menus, panels)

Ask the agent to study the existing templates (like chess/ or fps_shooter/), then create a new one with its own behaviors, systems, and UI. Once the template is created, open the editor and type the template name in the chat to see it assembled and running.

3D Assets

The hosted version at parallaxpro.ai includes 5000+ 3D models, textures, and audio files from Kenney, Poly Haven, and more.

When running locally, assets are automatically loaded from the ParallaxPro CDN. The asset browser and 3D models work out of the box with no additional downloads.

To use your own local assets, set ASSETS_DIR in your .env to a directory containing your 3D models (.glb), textures (.png, .jpg), and audio (.ogg, .mp3).

Publishing Games

Game publishing is available on the hosted version at parallaxpro.ai. Published games appear at parallaxpro.ai/games. We are working on direct publishing from self-hosted instances.

License

Apache License 2.0. See LICENSE.

About

Turn your ideas into real video games

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 89.6%
  • HTML 7.0%
  • CSS 2.5%
  • Shell 0.9%