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)

Searching Database…

这是什么?OhMyGame 是一款开源桌面应用,相当于一个人的游戏工作室:AI 智能体编写设计文档、生成美术、视频和 3D 素材、编写游戏代码、试玩测试,并发布可分享的链接,全部在一个画布上完成。
这是桌面应用、库,还是网络服务?它是一款可下载的 macOS 和 Windows 原生桌面应用,基于开源的 Pi 智能体框架构建并带有自己的 GUI;在其中制作的游戏是普通的 web 项目,可以用任何编辑器打开。
怎么让它跑起来?从 Releases 下载安装程序,打开 Settings > Providers & Models 连接一个模型(OpenRouter 是只需一个密钥的最快入门方式),然后在主屏幕的提示框里描述你想做的游戏。
我需要自己的 API 密钥吗?需要。它是自带密钥模式:你通过 Pi 连接 40 多家提供商(Anthropic、OpenAI、DeepSeek、Qwen 等)的编程模型,可用订阅或 API 密钥;如果想要生成图片、视频或 3D,还要单独连接一个媒体提供商(OpenAI、OpenRouter、火山引擎 Ark 或 Meshy)。
目前安装有什么坑或不完善的地方吗?项目还处于 beta 阶段,难免有不完善之处;Windows 版本尚未做代码签名,安装时 SmartScreen 会发出警告;Intel Mac 和 Linux 版本也还没有(已列入路线图)。
我的密钥和项目数据会到哪里去?项目和密钥留在你的机器上,绝不会进入智能体的工作区或渲染器;提示词直接发送给你选择的提供商;只有发布版构建(不是源码构建)会发送匿名的使用情况和崩溃遥测。
用它到底能做什么类型的游戏?可以用 Three.js、React Three Fiber 或 Phaser 制作 2D 或 3D 网页游戏,还能制作由故事图上相互连接的分支画面组成的互动电影和视觉小说。
发布做好的游戏是怎样的流程?你登录后点击发布;OhMyGame 会构建游戏并给你一个可分享的浏览器链接,重新发布时更新的是同一个链接,已发布的游戏会出现在应用内的 Community 中。
我可以用 ChatGPT 或 Copilot 订阅代替 API 密钥吗?可以。你可以用现有的订阅(如 ChatGPT Plus/Pro 或 GitHub Copilot)登录,也可以改为粘贴 API 密钥。
驱动它的「Pi」智能体是什么?Pi 是 OhMyGame 所运行的底层编程智能体工具集,会话可持久保持;它还让智能体能够使用 MCP 服务器以及你现有的 Codex 或 Claude Code 插件。
Size
26.9 MB
Stars
918
Updated
CommitOct 16
Age
2mo
Commits · 90 Days