whatisgithub

What is model-codex?

jfcantu/model-codex — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

A browsable reference site that explains which text encoders, VAEs, and image models are compatible with each other in ComfyUI.

Mindmap

mindmap
  root((Model Codex))
    What it does
      Explains model compatibility
      Lists text encoders and VAEs
      Shows model family tree
    Tech stack
      React
      Vite
      YAML data
    Use cases
      Look up model requirements
      Check compatibility
      Browse model lineage
    Audience
      ComfyUI users
      Vibe coders

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

Look up which text encoder and VAE a specific image generation model needs before downloading it.

USE CASE 2

Check whether a VAE or LoRA from one model family will work with a different diffusion model.

USE CASE 3

Browse a visual family tree to see how finetuned models descend from their base models.

USE CASE 4

Contribute a correction or a new model entry by editing the project's YAML data files.

What is it built with?

TypeScriptReactViteYAML

How does it compare?

jfcantu/model-codex0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencevibe coderdeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

No backend or database is needed, npm install and npm run dev start a local static site.

The app code is free to use, modify, and distribute for any purpose including commercial use, as long as the copyright notice is kept, the data is dedicated to the public domain with no restrictions at all.

So what is it?

Model Codex is a browsable reference site for people who use ComfyUI, a tool for running AI image generation models. Image models like Flux or Stable Diffusion XL often need extra companion files to actually work, such as text encoders that turn a written prompt into something the model understands, and VAEs that turn the model's internal output into a final image. Figuring out which companion files go with which model, and whether two models are compatible with each other, can be confusing, and this project exists to answer exactly that question in plain language. The site itself is static, meaning it has no backend server or database. All the actual knowledge lives in hand editable YAML files, and a React and Vite based front end reads those files and renders them as pages. There is a Quickstart page for common tasks, a Browse page split into diffusion models, text encoders, and VAEs, a Model Tree page showing how models descend from one another, a Compatibility checker where you pick a VAE, a model family, and a diffusion model and get a plain language answer of yes, probably, maybe, or no, and a Glossary explaining terms used throughout the site. Under the hood, every model is treated as a node in a family tree, and a model that does not declare its own required files simply inherits them from its nearest ancestor. Compatibility exceptions and additions are recorded separately, since the checker already assumes sensible defaults based on a model's family and lineage. The project's author is upfront that this was built quickly with AI assistance and that both the code and the compatibility data should be treated as a helpful starting point rather than a guaranteed source of truth, with unverified entries marked as such. This project is aimed at people already using ComfyUI who want a quick, understandable way to check what a model needs or whether two files will work together. The application code is released under the MIT license, while the curated data itself is placed in the public domain under CC0, so both can be reused freely without needing permission.

Copy-paste prompts

Prompt 1
Explain what a text encoder and a VAE are using the Glossary page's definitions from this project.
Prompt 2
Walk me through adding a new model to data/models.yaml, including when to set basedOn and requires.
Prompt 3
How does requirement inheritance work when a model like Illustrious does not declare its own requires block?
Prompt 4
Show me how to run npm run validate to check the YAML data for broken references.
Prompt 5
Help me understand the difference between an addition and an exception in compatibilities.yaml.

Frequently asked questions

What is model-codex?

A browsable reference site that explains which text encoders, VAEs, and image models are compatible with each other in ComfyUI.

What language is model-codex written in?

Mainly TypeScript. The stack also includes TypeScript, React, Vite.

What license does model-codex use?

The app code is free to use, modify, and distribute for any purpose including commercial use, as long as the copyright notice is kept, the data is dedicated to the public domain with no restrictions at all.

How hard is model-codex to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is model-codex for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.