Open source

Teach an idea in 3D. Share it where everyone can use it.

A growing library of interactive biology, built in HTML and javascript. Reviewed and edited by humans.

How to contribute GitHub AGPL-3.0 · no build step · no account · free for everyone

Our component library

exist already, spanning molecules to cells to graphs. The whole library →

How to Contribute

Code or no code

AI agents have made coding 3D graphics accessible. We value human review and insight on science, comprehension, and design.

Start

Hand this to your agent

Starter prompt. It clones the repo, reads the docs and builds. Replace the one line that says what you want. Opus, Fable, and Asta are especially good at 3D work.

Clone https://github.com/rhymeandreason/Kodolab and read
demos/CLAUDE.md, then the one doc its "What to read" table names for this
task.

TASK: <one sentence: what to add, and what it should teach>

Start the dev server with node demos/tools/dev-server.js, run the checkers,
then give me the link and tell me exactly what to click to see whether it is right.
Run it yourself

If you would rather drive

Getting started by hand. You can also open any html page on its own.

  1. Fork, then clone your fork

    git clone https://github.com/YOUR-USERNAME/Kodolab.git
cd Kodolab

  2. Start the dev server

    Node only. No install, no build. Open http://localhost:8817/. Saving a file reloads just the pages that use it, and a CSS change swaps in place, so a scene keeps its camera while you tune it.

    node demos/tools/dev-server.js

  3. Optional: the checkers

    Only needed for molecules. Installs RDKit for the handedness check. The offline checkers are run by hand with node tools/check.js. The pages still need nothing.

    cd demos && npm i
node check-molecules.js        # geometry, bond angles, stereo claims
node tools/check-pages.js      # every page still loads what it needs

The code

AGPL-3.0. Anything built on this stays open, including a hosted copy. A classroom should be able to take a lesson apart, and the next classroom should get that back.

The kodolab content

CC BY-NC 4.0. Lesson copy, rendered stills, 3D models. Teach with them and remix them for your class, presentations, or papers, with credit (include a link). Selling them is a conversation, so ask.

Data Credit

Protein and nucleic structures come from the Protein Data Bank, credited to the labs that deposited them. Molecular data from PubChem.

Questions

Say hello to Mary Huang at mary@kodolab.org. If you teach this material, I would love to hear from you! What are the things your students get stuck on?

Start here

Pick one concept you wish you had seen

What confused you in first-year biology is still confusing someone this term. Build that one.

Fork the repo →

Not ready to build? Tell us what is missing, or email mary@kodolab.org.