whatisgithub

What is cameo?

cvlab-kaist/cameo — explained in plain English

Analysis updated 2026-07-25 · repo last pushed 2026-05-26

57PythonAudience · researcherComplexity · 5/5MaintainedSetup · hard

In one sentence

CAMEO improves AI image generators so they produce consistent multiple views of the same object, like showing a chair from different angles without it looking like a different chair. It trains the model's attention mechanism with known geometric relationships between viewpoints.

Mindmap

mindmap
  root((repo))
    What it does
      Consistent multi-view images
      Trains attention with geometry
      Halves training iterations
    Tech stack
      Python
      Diffusion models
      MVGenMaster base
    Use cases
      3D assets from photos
      Product multi-angle views
      Game prop generation
    Audience
      AI researchers
      3D engineers
      Game studios
    Data format
      Image sequences
      Camera intrinsics
      Camera extrinsics

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a full 3D model of a game prop from a single photograph.

USE CASE 2

Show an e-commerce product from every angle using one reference product shot.

USE CASE 3

Improve multi-view image consistency in custom diffusion model pipelines.

What is it built with?

PythonPyTorchDiffusion Models

How does it compare?

cvlab-kaist/cameodexmal/opendwhexsecteam/droidhunter
Stars575757
LanguagePythonPythonPython
Last pushed2026-05-26
MaintenanceMaintained
Setup difficultyhardhardhard
Complexity5/55/54/5
Audienceresearcherresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires a dataset of image sequences with camera intrinsics and extrinsics, plus the MVGenMaster codebase and GPU resources for training diffusion models.

The explanation does not mention a license, so it is unclear what permissions apply to using this code.

So what is it?

CAMEO is a research project that helps AI image generators produce more consistent results when creating multiple views of the same object or scene. If you have ever seen an AI generate an image of a chair from the front, then try to show the same chair from the side, only to have it look like a completely different chair, this project tackles that exact problem. When AI models generate multiple viewpoints, they use an internal mechanism called "attention" to figure out which parts of a new view should correspond to parts of the reference image. The researchers behind this project discovered that this attention mechanism naturally learns some of these correspondences during training, but it is imperfect and breaks down when the angle between views gets large. This project improves the process by directly training that attention mechanism with known geometric correspondences, teaching it more precisely how points in one view relate to points in another. The main audience is researchers and engineers working on multi-view image generation or 3D asset creation from 2D images. A game studio wanting to automatically generate a full 3D model of a prop from a single photograph, or an e-commerce platform showing a product from every angle based on one product shot, would benefit from the improved view consistency this approach provides. What makes this approach notable is its efficiency. Supervising just a single attention layer is enough to guide the entire model toward learning precise correspondences. This halves the number of training iterations needed to converge while still achieving better results at the same number of steps. The technique is also model-agnostic, meaning it can be applied to essentially any multi-view diffusion model, not just one specific architecture. The code is built on top of an existing project called MVGenMaster, and the dataset format expects sequences of images paired with camera information like intrinsics and extrinsics, ordered from reference frames to target frames.

Copy-paste prompts

Prompt 1
How can I use CAMEO to improve view consistency in my multi-view diffusion model so that generated objects look the same from different angles?
Prompt 2
Help me set up the CAMEO training pipeline using image sequences with camera intrinsics and extrinsics in the MVGenMaster dataset format.
Prompt 3
What is the minimal change I need to make to apply CAMEO's attention supervision technique to my existing multi-view diffusion model?
Prompt 4
Explain how CAMEO trains a single attention layer with geometric correspondences and why this halves the number of training iterations needed.

Frequently asked questions

What is cameo?

CAMEO improves AI image generators so they produce consistent multiple views of the same object, like showing a chair from different angles without it looking like a different chair. It trains the model's attention mechanism with known geometric relationships between viewpoints.

What language is cameo written in?

Mainly Python. The stack also includes Python, PyTorch, Diffusion Models.

Is cameo actively maintained?

Maintained — commit in last 6 months (last push 2026-05-26).

What license does cameo use?

The explanation does not mention a license, so it is unclear what permissions apply to using this code.

How hard is cameo to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is cameo for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.