Repolode
camenduru

camenduru/OpenCartridge

A local-first AI game asset suite: a canvas for images, sprite sheets, animation, audio and 3D, driven by ComfyUI workers on your own GPU.

Stars
26
Forks
3
Open issues
0
Last commit
yesterday

What is it?

OpenCartridge is a browser-based workspace for making game assets with generative AI models. It provides a layered canvas with transforms, undo/redo and export to PNG, MP4, WebM and GLB, and each model is packaged as a "cartridge" that can be downloaded, started and deleted from the UI. The cartridges run as Docker containers hosting ComfyUI-based workers, so the models execute on the user's own machine.

The whole stack ships as a single Docker image that includes a MinIO object store, so generated renders and uploaded inputs persist in a Docker volume without extra setup. The interface includes a GLB viewer for 3D models and a waveform overlay for audio. It is built on camenduru's TostUI and currently offers cartridges for sprite sheets, pixel-art restyling, alpha matting, single-image 3D generation, rigging, music and text-to-speech.

The app has no authentication and publishes its storage port, so it is intended for use on a trusted network. Running the bundled workers requires an NVIDIA GPU, with about 24 GB of VRAM cited as sufficient for the current set.

Key features

  • 01Layered canvas with transforms, undo/redo and export to PNG, MP4, WebM and GLB.
  • 02One-click cartridges that pull, create and start ComfyUI worker containers from the UI.
  • 03Built-in MinIO object storage shipped inside the single container.
  • 04GLB preview and orbiting 3D viewer, plus a waveform overlay for audio.
  • 05Self-updating interface that pulls the latest source and rebuilds from the Global Configuration panel.

Use cases

  • Generating 3x3 isometric sprite sheets from a single character reference.
  • Restyling characters into pixel art and extracting clean alpha mattes from video.
  • Creating 3D models with rigging from single images for game prototypes.
  • Producing music and voice lines for game audio on a local GPU.

Quick start

  1. 1

    Install Docker Desktop (Windows AMD64) and wait until it reports that Docker is running

  2. 2

    Start OpenCartridge on Linux or macOS

    docker run -d --name opencartridge --restart unless-stopped --add-host=host.docker.internal:host-gateway -p 3000:3000 -p 9000:9000 -p 9001:9001 -v opencartridge-data:/content/data -v /var/run/docker.sock:/var/run/docker.sock camenduru/opencartridge
  3. 3

    Open http://localhost:3000 in your browser

Things to know

  • Requires an NVIDIA GPU, with about 24 GB VRAM suggested for the current workers.
  • The app has no authentication, so ports 3000 and 9000 should stay on a trusted network.
  • Worker images are a few GB each and the first job loads its models, so the first run is slow.

In collections

Topics

FAQ

What is OpenCartridge?
A local-first AI game asset suite: a canvas for images, sprite sheets, animation, audio and 3D, driven by ComfyUI workers on your own GPU. OpenCartridge is a browser-based workspace for making game assets with generative AI models. It provides a layered canvas with transforms, undo/redo and export to PNG, MP4, WebM and GLB, and each model is packaged as a "cartridge" that can be downloaded, started and deleted from the UI. The cartridges run as Docker containers hosting ComfyUI-based workers, so the models execute on the user's own machine.
Is OpenCartridge free to use? What license does it have?
OpenCartridge is open source under the MIT license. Check the license terms before using it in commercial products.
Is OpenCartridge still maintained?
Actively maintained. The last commit to OpenCartridge was on Nov 6, 2026.
What can I use OpenCartridge for?
Generating 3x3 isometric sprite sheets from a single character reference. Restyling characters into pixel art and extracting clean alpha mattes from video. Creating 3D models with rigging from single images for game prototypes. Producing music and voice lines for game audio on a local GPU.
How do I install OpenCartridge?
Install Docker Desktop (Windows AMD64) and wait until it reports that Docker is running Start OpenCartridge on Linux or macOS: docker run -d --name opencartridge --restart unless-stopped --add-host=host.docker.internal:host-gateway -p 3000:3000 -p 9000:9000 -p 9001:9001 -v opencartridge-data:/content/data -v /var/run/docker.sock:/var/run/docker.sock camenduru/opencartridge Open http://localhost:3000 in your browser
Where can I get OpenCartridge?
The source code and installation instructions are on GitHub: https://github.com/camenduru/OpenCartridge

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects