thicken

Photos in. Out comes the object: its 3D model and its metadata.

thicken turns photos of a real object into a GLB model at its real sizeand its metadata as JSON, read off the object by vision models and lookedup in public catalogs. What it knows about each kind of object lives in aprofile: a few come with thicken, and you can add your own.

_{In each, the photos going in and the model coming out, with its metadata, like the one below. The logo above is a thicken model too, made by its lettering profile: thicken lettering thicken.}

The other half: its metadata. Part of the first one's, a graded Giannis Antetokounmpo card:

{
  "profile": "slab",
  "holder": "cgc",
  "grader": "cgc",
  "cert": "6072896005",
  "widthMm": 80.5, "heightMm": 135, "depthMm": 7.5,
  "read": {
    "grade": "9", "gradeName": "MINT",
    "autoGrade": "10", "autoGradeName": "AUTO",
    "signed": "G. ANTETOKOUNMPO, 8/2/25",
    "name": "Giannis Antetokounmpo", "year": "2024-25", "maker": "Panini",
    "set": "Court Kings Basketball", "number": "#5", "variant": "Blank Slate"
  },
  "readBy": { "grade": "agreed", "autoGrade": "agreed", "set": "disputed" },
  "inside": {
    "card": { "widthMm": 63.5, "heightMm": 88.9, "corners": "square", "foil": "none" },
    "label": { "widthMm": 66.4, "heightMm": 26.9 }
  }
}

The grader and certificate number come from the label's QR code; the visionmodels read the rest off the slab. What each profile records is inthe table of profiles, and every field is described inUSAGE.md.

Contents

• Try it · From an AI agent · How it works · The thicken object · What it makes
• In detail (USAGE.md): batch · photos ·vision · video · training mode ·review · the sidecar · previews ·inputs · sizes
• What leaves your machine · Adding a profile · Security ·Built on · Development · License

Try it

npm install -g thicken                      # Node 22.18 or later; or npx thicken …
thicken photo.jpg                           # it works out what it is: a code on it, or the vision models
thicken book cover.heic back.heic spine.heic
thicken --isbn 9780061120084                # no photo: the cover and size from Open Library
thicken slab front.jpg back.jpg
thicken card front.jpg back.jpg --pt 130    # a thick patch card
thicken badge badge.png --width 50          # cut-out artwork, extruded
thicken lettering thicken                   # the logo
thicken batch ~/Pictures/books --preview    # a model per photo, PDF, video or folder

Each run writes <name>.glb and <name>.json beside the first picture, andwith --preview a picture of both sides. Photos straight on and cropped workas they are; uncropped photos, angled shots and video need a vision roster,any OpenAI-compatible endpoint (Vision). As alibrary: import { thicken } from 'thicken', then thicken(files, options)gives the GLB's bytes and the sidecar.

From an AI agent

thicken is an MCP server too (thicken mcp), with an Agent Skill that tellsthe agent when and how to use it: ask for a model of the book on your desk,and the agent makes it. In Claude Code:

/plugin marketplace add bikemeardsley/thicken
/plugin install thicken@thicken

Or for any MCP client, npx -y thicken mcp on stdio. Codex, Copilot,Cursor, Gemini CLI and the rest are in USAGE.md.

How it works

What thicken knows about a kind of object lives in its profile: how torecognize it, its faces, what to read off it, and how to build it at its realsize. A code on the object picks the profile (an ISBN barcode, a grader's QRcode), or the vision models say which it is. thicken is not a photogrammetrytool: everything it handles is close to a box or a flat outline, so it buildsthe geometry from known sizes and maps your photos onto it.

The thicken object

What thicken makes is more than a 3D shape. Each run writes a thickenobject: the model (a GLB at the object's real size, in millimeters) and,beside it, its metadata (the JSON sidecar), which knows what the object is, inits profile's own terms. For the profiles that come with thicken, forexample:

• A book: its ISBN, its catalog record (title, authors, publishers,dates, subjects, Dewey and Library of Congress classes, pages), and how surethe match is when it was found by title.
• A graded slab: its grader, cert number and verification link, itsholder, and the card and label inside it, each sized and placed. Withvision, the label read: the card's grade (its number and words, "9 MINT",any qualifier and subgrades), an autograph's own grade when the labelgrades one apart from the card ("AUTO 10"), who signed it and when, andthe card as the grader names it.
• A raw card: its size, its thickness in points for a thick card, itscorners and its foil. With vision, what's printed on it: player orcharacter, team, year, maker, set, number, parallel.
• A box: with vision, its name, brand, edition, rating and year.
• A badge: with vision, what it names, who issued it, its level,subject, date, any credential number, and every other word on it.
• Every object: what the vision models read off it, and how sure;which faces are your photos and which are stand-ins,how each fact was found, what is still worth photographing, and what eachvision model answered.

An app shows the model and reads the sidecar: a library shelf of your books,a vault of your slabs. The fields are underWhat the sidecar records.

What it makes

thicken makes the 3D object; what it knows about kinds of object lives inprofiles, one file each in src/profiles. Anyone can add one(CONTRIBUTING.md). Every profile there today:

What each one records in its sidecar, beside what every model has (its size and where it came from, its faces andpictures, its codes, what the vision models read and how sure, what's worth a second look: all inUSAGE.md):

Name the profile, or leave it out and thicken picks one:

• An ISBN barcode on any picture, or --isbn, means a book.
• A QR code pointing at a grader's site (psacard.com, beckett.com,cgccards.com, gosgc.com, taggrading.com) means a slab, and says whose.The sidecar keeps the grader, the cert number from the link, and the linkitself (verifyUrl).
• So does an older label's Code 128 cert barcode, but only on a photo shapedlike a holder. The grader is then the one the vision models read off thelabel; with no vision, a PSA-size holder is assumed, with a warning.
• Artwork with transparency around a shape that isn't just a rectangle meansa badge.
• Otherwise, with vision, the models are shown theprofiles and say which it is, and roughly how big: two agreeing settle it,as with faces, and box takes anything box-shaped the others don't cover.
• Anything still unknown is refused with a request to name the profile.Other barcodes don't count: books carry UPCs, QR codes and librarystickers.

The sidecar's identifiedBy.profile says which way it was chosen: given,recognized (codes or the artwork), or vision.

Adding a profile is one file in src/profiles, found by itself, nothingelse to change: its name; a few words on what it is and on each of its faces,which is all the vision models are told; what to read off it (more is better:the sidecar is for apps to take what they want from); optionally how its codesor pictures give it away unaided; and how to build it from the photos placedon its faces. Generic profiles are named for the shape they build (box, andlater perhaps flat or cylinder), not "unknown": a shape thicken can'tbuild is refused rather than forced into one it can. Contributions welcome:CONTRIBUTING.md says how.

Pictures are placed on faces by what they show (seePhotos). With no front, Open Library's cover stands in,marked for review, so one photo of the back is enough to start a book.

What leaves your machine

With THICKEN_VISION_URL set, the photosthemselves (re-encoded, so without their EXIF) go to that host. A LAN serveryou control still forwards each photo to the model's provider; a hostedendpoint sees every photo. The only other calls out are a book's cataloglookups (Open Library, the Library of Congress, Google Books), which send itsISBN, or the title and author the models read off it; never a photo.

Nothing else is sent anywhere, and nothing is fetched at run time but thoselookups: previews draw with model-viewer served from your own disk.

Adding a profile

A profile is one file, found by itself: what the object is, its faces, whatto read off it, and how to build it. Make your own while you use thicken, orimprove one of its own, and offer it back:

thicken profile new vinyl          # from the template, in ~/.thicken/profiles: used at once
thicken profile check vinyl        # what thicken's CI will check
thicken profile contribute vinyl   # forks, branches, checks and opens the pull request

The template, templates/profile.ts, works as it is (abox at the size you give) and says on every field what goes there, therecords it writes included. CONTRIBUTING.md has the rest.The table above is made from the profiles themselves.

Security

Report a vulnerability privately, as SECURITY.md says. It alsolists what thicken touches: files, the network, and the programs it runs.

Built on

For refractor and holo effects in a viewer, simeydotme/pokemon-cards-css isa reference only. It is GPL-3.0, so read it and don't copy it.

Development

TypeScript on Node 22.18+, with sharp for images. From a clone it runsdirectly (Node strips the types). The npm package is JavaScript built intodist (npm run build, run by npm pack and npm publish), because Nodewon't strip types inside node_modules. Every push installs the packedpackage on Windows, macOS and Linux and runs it.

From a clone: npm install, then node src/cli.ts … in place ofthicken …; npm test, npm run check, and npm run readme afterchanging a profile.

License

MIT. See LICENSE.

The lettering font, Titan One, is under the SIL Open Font License 1.1(fonts/OFL.txt).