About Takumi

Takumi renders a layout you describe in JSX, HTML, or a plain node tree, then writes it out as PNG, WebP, AVIF, JPEG, SVG, or PDF. The layout, text shaping, and painting all happen in Rust. There is no headless Chrome to install, keep warm, or pay for.

What it is for

People use Takumi for open graph images, social cards, certificates, receipts, invoices, reports, and tickets. It runs on a server that generates a card per request, and it runs in a build step that generates thousands at once. The same template also compiles to PDF, so one component can produce both the preview image and the printable document.

Where it runs

The engine ships as a Rust crate, as a native Node addon, and as a WebAssembly module. That covers Node, Bun, Deno, Cloudflare Workers, and the browser. The playground runs the WebAssembly build inside your tab, which is the same code path a Worker uses.

Who maintains it

Takumi is written and maintained by Kane Wang in Taiwan, with help from contributors on GitHub. The source lives at github.com/kane50613/takumi and is licensed under MIT or Apache-2.0, at your option. Issues, feature requests, and pull requests are all handled in that repository.

For agents

The documentation is published as Markdown as well as HTML. Read /llms.txt for an outline, /llms-full.txt for the whole thing in one file, and /openapi.json for the endpoints this site serves. Any documentation URL returns Markdown when the request asks for text/markdown.