anidoodle README

The project's README from github.com/alexgreensh/anidoodle. As one markdown file: README.md.

anidoodle: an artist's table of code-drawn doodles, with the name writing itself in calligraphy

https://github.com/user-attachments/assets/1cf7f75c-b040-4c00-bf0c-cf1885f8b8da

The launch film, 77 seconds. Every frame and every sound in it was made with anidoodle, in code.

anidoodle

Hand-drawn art, written as code.

Illustrations, drawing timelapses, films, explainers and interactive web art in 32 styles.
Every mark is a function and every score is written, so the same source
redraws the same picture on every machine, at every size, for good.

Latest release Apache 2.0 Made of pure code Every render identical

Works in Claude Code · Codex · Grok Build · and any agent that reads skills. Install

English · 日本語 · 简体中文 · 한국어 · Français · Español

Styles · Drawing films · Music · What you can make · What it packs · Motion · Get started

32 styles to choose from

32 illustrations, each in its own style, from pencil and watercolour, marker comic and risograph to pixel art, toy brick, woodcut, sumi-e, scratchboard, embroidery, painted oil and a folk-tale storybook

Each style is its own way of making a mark: the taper of a nib, the bleed of a wash, the scumble of chalk on slate, the torn edge of cut paper, the halftone of a risograph drum, one engraved line spiralling out to become a moon. The subject changes shape in each hand, the way it would for 32 different illustrators. Every style also ships a film of its picture being drawn, mark by mark, in the order an artist in that medium works. Pick one for your brand and every picture after it arrives in the same hand. Every plate above, and the contact sheet itself, is drawn by code in this repo.

All 32 styles, and how each one is made
Style How it's made
Ballpoint One biro; tone from where hatching sits
Broken colour Separate dabs of unmixed colour, impressionist
Chalkboard Side-of-chalk scumble with dust
Charcoal erasure Charcoal drawn, erased and redrawn, ghosts kept
Coloured pencil Directional pencil hatching on toothy cream paper
Crayon Waxy scribble fills that skip the paper's valleys
Cut-paper collage Torn and cut paper, no drawn lines
Cyanotype blueprint Ruling-pen drafting on a cyanotype sheet
Dream glaze Thin resin-oil glazes, no visible stroke, every edge hard
Embroidery Thread stitched through linen in a hoop
Flat vector Crisp geometric shapes with grain and long shadows
Folk-tale storybook Painted foreground dissolving into pencil line on cream paper
Ink & line-wash Washes first, then a flexible nib
Isometric A 2:1 isometric cutaway in flat-shaded planes
Low-poly 3D Flat-shaded triangles, drawn in code
Marker comic Flat cel fills and one heavy contour
Mid-century gouache Opaque matte shapes, dry-brush edges, loose line
Newsprint halftone One black screen plus a spot colour on newsprint
Painted oil Bristle strokes and impasto on a toned canvas
Paper-craft Layered cut paper and painted cut-outs, on twos
Pencil & watercolour Washes that never quite fill their pencil line
Pixel art A fixed 16-colour palette on a low-res grid
Risograph Ink drums overprinting through registration
Rubber-hose 1930s cartoon ink with bendy limbs and film grain
Scratchboard White lines scratched out of black clay
Single-line engraving One unbroken spiral whose width is the tone
Stipple Pen dots whose density is the tone
Storybook Pencil and watercolour for characters
Sumi-e One loaded brush on absorbent paper
Toy brick Studded plastic bricks, built layer by layer
Vintage scrapbook Engravings, cut-letter titles and taped cards on aged paper
Woodcut / ukiyo-e A carved keyblock and colour blocks on washi

Every style draws itself

Four pictures drawing themselves at once: a coloured-pencil robot at a workbench, a woodblock print of herons on a bridge in the rain, a pixel-art cat leaping for fireflies, and sumi-e bamboo with a sparrow

Every style ships the finished picture and, from the same source, a film of it being made in the order an artist in that medium works. Watercolour lays in pencil, then washes light to dark. A woodblock prints the keyblock, then each colour block. Pixel art blocks in flat shapes, then shades clusters. Nothing fades in: every stroke grows, every wash spreads from where the brush touched, and the film's last frame is the still, pixel for pixel. It is the timelapse, the making-of and the explainer diagram in one.

Music, composed in code

The notes are written as data and the engine makes the sound. Nothing in this repository is a recording. A music style is a vocabulary the model composes from, never a preset: 21 of them, from lo-fi electronic, house and synthwave to orchestral, jazz, folk and solo piano. Each gives the sound, the grooves and the harmony language; the chords, the motif and the form are written new, so every film gets its own score.

Install the optional sound pack and eight acoustic instruments play recordings of real ones: a Steinway grand and an upright, concert harp, marimba, vibraphone, glockenspiel, tubular bells and timpani, in three recorded rooms. Synths, lo-fi colour, electronic drums and sound effects stay in code. Without the pack every score still plays, unchanged.

node <skill>/engine/tools/soundfetch.mjs list    # the install directory and what is installed
node <skill>/engine/tools/soundfetch.mjs get all # download (373 MB), verify by hash, unpack; your agent asks you first

node tools/music.mjs check clears a score before anyone listens: key and mode, loudness, masking, the balance of every part, and novelty, which fails a score that sounds like a known one or quotes it.

Listen
A nocturne in A-flat 45 s, piano: it builds, peaks, then falls to a hush
The piano, played · the same notes, played flat the difference is the performance: voicing, phrasing, pedal
Cinematic, awe · Lo-fi · Marimba · Electronic more moods and instruments
The nocturne's theme in 15 seconds the composer picks the form that fits the length

Also in the box: a sound-effects kit, fourteen layered, seeded effects cued to the exact frame, the score ducking under each one (sound design). How a score is composed: compose.md · every vocabulary.

Web pages that notice you

A sign-up form with a hand-drawn robot beside it that watches the typing, covers its eyes at the password field, and cheers on success

Interactive illustrations for real sites: a mascot that follows the cursor and reacts to buttons, a hero that draws itself as the page scrolls, a form companion that covers its eyes at the password field. One small ES module and a <ani-doodle> element, no framework, with reduced-motion and keyboard paths. Each frame is still a fact, given the input that led to it.

Launch your product, drawn in code

The film at the top of this page was made with anidoodle, and the kit it was made with ships with it. launch.mjs new <name> gives you a spec to fill: your product's name, the prompts a user would type, the answers (a drawn picture, your product's own screens, or a film), a few words and your install lines. It cuts a launch film on the beat: a chat that types itself, answers that bloom open, full-frame lettering, and an end card that holds your install lines long enough to copy.

It wears your product's look: your fonts, your colours, your chat window's shape, or a brand file imported straight from Figma. Start from drawn ink or a clean UI-first canvas, at 30 or 60 fps, with motion blur matched to each frame's speed. And before you see the finished film, anidoodle checks it on its own the way a picky editor would: text held long enough to read, no slide-deck cuts, no blurred exits, sound mastered for the feed, and every claim on screen sourced.

The rules come from four cuts of our own launch and from the craft of the best ones out there: say what it is within five seconds, never put words over the art, cut on the downbeat, make the first frame the thumbnail. → launch-video.md · the kit

Bring your own image

Learn to draw

How to draw an owl in nine steps: from two circles through construction, outline, eyes, shadows and feathers, to the rest of the owl The owl drawing itself, step by step, with captions

Watch the full lesson with captions (mp4, 95 s)

Ask how to draw something, or bring a drawing, and anidoodle rebuilds it as a lesson: a step sheet and a captioned timelapse, each step with what to look for, how to do it, and the common mistake.

What you can make

For You get
Your website A hero illustration, spot art for each feature, empty states and a 404, all in one hand. Transparent PNGs at any size from one source, so retina and print come free.
Explainers and reports How-it-works diagrams, cutaways and animated infographics, labelled in drafted lettering. Chalkboard, blueprint and ballpoint suit the serious ones. An idea can become a working machine that plays, takes itself apart and folds back, drawn in any style.
Your brand A logo that draws itself on, a title sequence, a social card template that stays on brand for every post.
Social and chat Endless loops, GIFs and transparent animated stickers, sized for the feed.
Decks and docs A family of section illustrations from one program. A new seed gives a sister image in the same style.
Stories Storyboards and animatics that grow into a finished film of any length, with an original score.
Your own image Bring a picture and get its style on a new subject, or bring a photo and get it recreated in any of the 32 hands, every mark drawn in code.
Web pages Interactive illustrations that watch the cursor, react to clicks and forms, or draw themselves as the page scrolls. Hero art and spots that sit beside your headline on your page's own colour and brand, light or dark.
Learning Drawing lessons: step sheets and timelapses that teach how a picture is built, with what to look for and the common mistakes.
Characters One character, built once and kept identical across shots, poses and styles.
Your launch A launch film for your product from a template: your prompts, your pictures, your words and your install lines, cut to a score.
3D and motion graphics 3D scenes, extruded type and title sequences rendered with three.js, on the same frame-exact timeline as everything else.
Narration A voice-over timed to the picture, with subtitles that follow each word, so the film reads with the sound off.

Ask in plain words, "a risograph lighthouse for our careers page, 1600×900" or "a chalkboard explainer of how our pricing tiers stack up", and anidoodle routes it to the right workflow and style recipe, asking only for what the request leaves open.

What it packs

The engine is the easy half. The craft is the part anidoodle carries for you, six lessons, each one earned by getting a piece wrong first and written down so you start where the last project ended:

Every format ships from the same source: PNG, MP4 with its score, GIF, WebM and animated PNG with transparency, and one self-contained HTML file. → formats.md

It draws, then it moves

A cyanotype blueprint plate drawing itself, line by line A clockwork butterfly comes to life in watercolour and flits between ranunculus
Marks are made, in the order a hand would make them. The blueprint wakes in watercolour and flies off into its meadow.

▶ The full 47-second film, sound on. 1080×1080 with an original score, every frame and sample generated in code:

https://github.com/user-attachments/assets/019d46d3-536a-4843-9f68-8e8f5f5c3401

One pure function paints each frame, so a finished illustration is that function called once, a sticker is the same function on a loop, and a film is it with a story and a score. The same guarantees hold for all three.

Pay once, draw forever

A picture model spends tokens and compute on every frame of every render, and it draws something new each time. Code spends them once. The 47-second film is a single program: written one time, it renders all 1,410 frames and a full stereo score, at any size, on any machine, free every time it runs. That works out to about sixty tokens of code per frame on the first pass, and zero on every pass after. A still is a few hundred lines. A whole family of images is a list of seeds.

Get started

Claude Code:

/plugin marketplace add alexgreensh/anidoodle
/plugin install anidoodle@alexgreensh-anidoodle

Codex:

codex plugin marketplace add alexgreensh/anidoodle

Then in the Codex TUI: /plugins and install anidoodle.

Grok Build:

grok plugin marketplace add alexgreensh/anidoodle
grok plugin install anidoodle --trust

--trust confirms the install; without it, Grok shows what the plugin can run and stops. You can also install it from the Marketplace tab in /plugins.

Any other agent: anidoodle is a standard skill folder (skills/anidoodle/SKILL.md), so it can be copied into any harness that reads skills.

Then ask for what you want: "draw a pencil & watercolour pear for our recipes page". To drive the engine yourself:

node <anidoodle>/engine/tools/scaffold.mjs ~/art --still hero --film intro --format 9x16 --duration 60
cd ~/art && npm install && npx playwright-core install chromium

node tools/still.mjs  hero  --out out/hero.png --scale 2   # a finished illustration, print size
node tools/render.mjs intro --out out/intro.gif            # a loop; also .mp4 with score, .webm with alpha
node tools/emit.mjs   intro --out out/intro.html           # the whole piece as one offline file
node tools/gate.mjs   hero                                 # determinism, contract and dead air in one pass
node tools/verify-export.mjs intro --file out/intro.mp4   # the file you ship, decoded and checked
node tools/music.mjs check score.ts#myScore                # your score: key, loudness, balance, novelty
node tools/launch.mjs new myLaunch                         # a launch film spec; then: launch.mjs ship myLaunch

Node 20 or newer. Stills need only the browser above; anything that moves also uses ffmpeg.

emit writes one HTML file, around 100 KB, that plays the piece with sound on a double-click, offline. It carries the recipe and draws everything again from scratch every time you open it. Attach it to an email and you have shipped a studio.

Four backends share one art core, and the core stays blissfully unaware of which one is drawing: playwright, html-player, remotion, hyperframes.

The example film

skills/anidoodle/example/ holds Mechanical Lepidoptera: 1,410 frames, 47 seconds, a clockwork butterfly that drafts itself, comes alive in watercolour, and leaves its blueprint in the grass. It is the whole engine in one piece: control points placed by hand over real anatomy, a cache key that names every input a pixel depends on, a score composed for it, and one unbroken move from built to alive. The style plates sit beside the engine in skills/anidoodle/engine/src/canvas-core/, each with its recipe written at the top. Open any of them, change a number, and watch what moves.

Honest by design

Sound and motion earn their claims. Every statement about the score or the movement carries a measurement or a human's eye behind it, and a green checkmark counts once it has been re-run. That discipline is why the same piece comes back byte for byte, every time, on every machine.


Licensed under the Apache License 2.0. Copyright 2026 Alex Greenshpun.

Built with anidoodle, which learned everything it knows by drawing the butterfly a few honest times.

anidoodle (alexgreensh/anidoodle)

Searching Database…

What is this?anidoodle is a set of agent skills that draws illustrations, drawing timelapses, films, explainers and interactive web art from code, in 32 hand-drawn styles. The same source redraws the same picture every time.
Is it a library I import, or a plugin for my coding agent?It is mainly a plugin and skill set for coding agents, not a library you import into your own app. You describe the picture in plain words and the agent draws it.
How do I get it running?Install it as a plugin or skill in your agent by following the Install section of the README, then ask for a picture in plain words. Install links are provided in several languages.
Which coding agents are supported?Claude Code, Codex and Grok Build are named, plus any agent that reads skills. The optional sound pack adds recordings of real instruments, but without it every score still plays.
Any catches I should know about?Music is composed in code, so real recorded instruments need the separate optional sound pack. Without it, scores still play, but the piano, harp and other acoustic parts are not recordings.
How does one prompt give the same picture every time?Every mark is a function and every score is written as data, so the same source redraws the same picture on every machine, at every size.
Can I use my own picture or photo as a starting point?Yes. Show it a picture you like and it copies the style on a new subject, or give it a photo and it is recreated in one of the 32 styles, with every mark drawn in code.
How many drawing styles are there, and do they animate?There are 32 styles, from ballpoint and woodcut to risograph and pixel art. Each style also ships a film of its picture being drawn in the order an artist in that medium would work.
Can it make a launch video for my product?Yes. launch.mjs takes a spec with your product name, prompts and install lines, cuts a launch film to a score, and checks the file before you deliver it.
Size
47.6 MB
Stars
1.8K
Age
1mo
Commits · 90 Days