ohmygame README

The project's README from github.com/WhiteTowerAI/ohmygame. As one markdown file: README.md.

OhMyGame — the open-source studio for making games with AI

Your own one-person game studio. Everything you need to make games with AI, in one app. Bring your own key.

Download for macOS Download for Windows

Built on Pi 40+ model providers, BYOK License Apache 2.0 Join Discord

https://github.com/user-attachments/assets/4d5805fe-92a2-40b4-a232-c7452f9a796a

[!NOTE] 🚧 OhMyGame is in beta. Expect rough edges. Join us and let's build it together!

What it is

Making a game takes design docs, 2D art, 3D models, video, code, and somewhere to put it when it's done. Today those live in five or six different tools. OhMyGame puts them in one app: describe your game, and the agent designs it, makes the assets, builds it, plays it to check it works, and publishes it to a link you can share.

Two core design ideas shape it:

  1. Everything lives on a canvas. Design docs, concept art, 3D models, and video sit side by side on one board. One character sketch can grow into more art, a video, or a rigged 3D model, and everything is ready to use in your game.
  2. The agent does the work. It drives the canvas the way you would: drafting the design doc, turning a character sketch into a rigged 3D model, writing the code, and playtesting the result.

It's open source and works with 40+ model providers through Pi, from Anthropic and OpenAI to DeepSeek and Qwen. Your keys stay on your machine, there are no per-run credits, and what you make is yours.

Features

🤖 Agent: drives the canvas, builds and plays the game

The agent works the canvas the way you would: it drafts the design doc, lays out boards, and generates assets on them. Then it reads the design doc, writes the code, and runs the game in a live preview. Then it opens the game in a window you can watch and plays it, including real-time canvas and WebGL games. When it finds a problem, it tries a fix and plays again. Along the way it can generate images, video, and 3D models, search the web, and use MCP servers or the Codex and Claude Code plugins you already have.

▶ The agent playtesting a new item feature on desktop and mobile, then reporting what it found (sped up 4×).

https://github.com/user-attachments/assets/3cb982e8-a4a8-4715-bf3c-df4e41e7855b

🎨 Canvas: design docs, art, video, and 3D on one board

Every game project has a design space: a main design doc plus boards where the doc, images, video, and 3D models sit side by side. Nodes can use each other as references, so one character design can lead to more images, a video, or a rigged and animated 3D model. Results go into a shared Asset Library that your games can use.

https://github.com/user-attachments/assets/5a35964d-87b3-4153-8b1b-fc6deced5bb3

Sign in and publish: OhMyGame builds your game and gives it a link anyone can play in the browser. Republishing updates the same link. Published games are listed in the in-app Community, where you can play what others have made.

What you can make

Three games our team made with OhMyGame:

Interactive film made with OhMyGame: a monkey warrior dodges a sword strike Island builder made with OhMyGame: building a workshop on a floating dock Deckbuilding roguelike made with OhMyGame: playing cards in a gothic battle
Interactive film Island builder Deckbuilding roguelike

🎮 Web games

2D and 3D games for the browser, built with Three.js, React Three Fiber, or Phaser. The project is a normal web project you can open in any editor.

🎬 Interactive stories

Interactive films, visual novels, and story games. Each screen is a free web page with its own images, video, and code: a main menu, a case archive, a dialogue, a puzzle. You connect them on a graph, and the runtime handles state, saves, and navigation. The architecture and authoring model are documented in Playable Nodes.

How it's built

The idea that holds this together: one agent drives every part of the studio.

1 · A full Pi agent with a GUI. OhMyGame runs Pi with its full toolset and persistent sessions, in a GUI built for watching results rather than reading diffs. Close the app, come back, and the project, conversation, and context are still there. You describe, review, and steer; editing by hand is always possible, but it is not the main path.

2 · Every workspace is files. A web game is a normal web project. A design doc is Markdown, and boards and the Asset Canvas share one JSON node model. An interactive story is a node graph on disk. Each comes with an AGENTS.md and JSON schemas, so the agent edits them the same way it edits code, and the visual editors read and write the same files.

3 · Games are tool calls. Playing the game (game_use), generating media, and checking story nodes are ordinary Pi tools, next to its coding tools. That is why the agent can chain them: draft a design, make the art, write the code, and play the result in one conversation.

Any model, your keys

OhMyGame does not lock you into one model or charge per run.

Keys stay in the local daemon. They never reach the agent's workspace, your game, or the renderer.

Quick start

Download

Grab the installer from the buttons at the top or from Releases. Builds are available for macOS (Apple silicon) and Windows (x64). The Windows build is not code-signed yet, so Windows may show a SmartScreen warning during install.

First run

OhMyGame ships without a model. Connect one before your first prompt:

  1. Open Settings → Providers & Models and connect a provider for the agent. Sign in with a subscription you already have, such as ChatGPT Plus/Pro or Anthropic, or paste an API key. OpenRouter is the quickest start: one key covers language, image, and video models.

  2. Add media providers if you want them. The agent can design and build a game with only a language model. Generating art, video, or 3D needs its own provider:

    To make Connect
    Design docs, code, playtests Any language model provider
    Images and sprites OpenAI (API key), OpenRouter, or Volcengine Ark / BytePlus ModelArk
    Video OpenRouter, or Volcengine Ark / BytePlus ModelArk
    3D models, rigging, animation Meshy

    Signing in with ChatGPT does not cover image generation. To use GPT Image, connect OpenAI with an API key.

  3. Pick a model and describe your game. Choose the model in the prompt box on the home screen, then describe what you want to make.

Web search works without setup. Sign in under Account only when you want to publish a game; making games locally needs no account.

Run from source

Requires Bun 1.4.2 or newer for the toolchain and Node.js 22.19+ for the daemon.

git clone https://github.com/WhiteTowerAI/ohmygame.git
cd ohmygame
bun install --frozen-lockfile
bun run dev            # web renderer + local daemon
# or
bun run dev:desktop    # Electron app

See CONTRIBUTING.md for configuration.

Design and Asset Canvas share boards, Markdown documents, and local media under canvas/. See Canvas workspace for the file contract and offline migration instructions.

Privacy

Your projects and keys stay on your machine. Prompts and generation requests go directly to the model providers you choose. Publishing requires an OhMyGame account and uploads only your game's static build. Release builds check for updates and send anonymous usage events (PostHog, no session recording) and crash reports (Sentry, no personal data). Builds from source send no telemetry.

Roadmap

We're working on first-run setup, plain-language playtest reports, remixing games from the Community, and Intel Mac / Linux builds. See Issues for what's next, and vote with 👍 on what matters to you. Want to help? Look for help wanted issues.

Contributing

Issues and PRs are welcome. See CONTRIBUTING.md for setup, checks, and PR conventions, and SECURITY.md for reporting security issues.

License

Apache-2.0. The OhMyGame name and logo are not covered by the license.

ohmygame (WhiteTowerAI/ohmygame)

gamedev
Searching Database…

918 ·GitHub
Ohmygame
What is this?OhMyGame is an open-source desktop app that acts as a one-person game studio: an AI agent writes the design doc, generates art, video and 3D assets, codes the game, playtests it, and publishes a shareable link, all from one canvas.
Is this a desktop app, a library, or a web service?It's a downloadable native desktop app for macOS and Windows, built on the open-source Pi agent framework with its own GUI; games produced inside it are normal web projects you can open in any editor.
How do I get it running?Download the installer from Releases, open Settings > Providers & Models to connect a model (OpenRouter is the quickest single-key start), then describe your game in the home screen's prompt box.
Do I need my own API key?Yes, it's bring-your-own-key: you connect a coding model through Pi from 40+ providers (Anthropic, OpenAI, DeepSeek, Qwen, etc.) via subscription or API key, and separately a media provider (OpenAI, OpenRouter, Volcengine Ark, or Meshy) if you want generated images, video or 3D.
Any install pitfalls or rough edges right now?The project is in beta so expect rough edges, the Windows build isn't code-signed yet so SmartScreen will warn during install, and Intel Mac / Linux builds aren't available yet (listed on the roadmap).
Where do my keys and project data go?Projects and keys stay on your machine and never reach the agent's workspace or renderer; prompts go directly to the providers you chose, and only release builds (not source builds) send anonymous usage and crash telemetry.
What kinds of games can I actually make with it?2D or 3D browser games built with Three.js, React Three Fiber or Phaser, plus interactive films and visual novels made of branching screens connected on a story graph.
How does publishing a finished game work?You sign in and publish; OhMyGame builds the game and gives you a shareable browser link, republishing updates the same link, and published games appear in the in-app Community.
Can I use a ChatGPT or Copilot subscription instead of an API key?Yes, you can sign in with an existing subscription like ChatGPT Plus/Pro or GitHub Copilot, or paste an API key instead.
What is the 'Pi' agent that powers this?Pi is the underlying coding-agent toolset OhMyGame runs with persistent sessions; it also lets the agent use MCP servers and your existing Codex or Claude Code plugins.
What are similar projects?casbin-gateway, open-design, qwen-code, skills, Orbital, get-it, mixdog, easy-stock
Which topics is it in?game-ai, phaser, game-assets, pi-agent, ai-coding-agent, ai-video, byok, gamedev, threejs, canvas, ai-coding, game-development
Creator
WhiteTowerAI
Size
26.9 MB
Stars
918
Updated
CommitOct 16
Age
2mo
Commits · 90 Days