# Satori — card for AI agents

Library that converts HTML/JSX and CSS to SVG (lays out with flexbox); commonly used to generate Open Graph and social card images, PNG via Sharp or Resvg.

Category: Favicons and social preview images · maker Vercel · checked 2026-10-21

## Price
- Price: Free
- Free tier: Open source.

## License
MPL-2.0 — https://raw.githubusercontent.com/vercel/satori/main/LICENSE

- commercial: **yes** (Commercial use OK)
  > You may create and distribute a Larger Work under terms of Your choice
  (https://raw.githubusercontent.com/vercel/satori/main/LICENSE)
- in app: **yes** (Can ship inside your app)
  > You may create and distribute a Larger Work under terms of Your choice
  (https://raw.githubusercontent.com/vercel/satori/main/LICENSE)

## Rules to follow
- MPL-2.0: modifications to Satori's own files must be shared under MPL; your own code can stay under your terms.
- Fonts must be passed as ArrayBuffer/Buffer; text will not render without a font.

## How an agent gets files
- npm i satori; call satori(element, {width, height, fonts}) to get an SVG string; convert to PNG with Sharp or Resvg. (sign-in: none)
- Formats: svg, png
- Not allowed: Flexbox and a subset of CSS only
- Not allowed: You must supply font data

## Node.js (official example, https://github.com/vercel/satori)

```
import satori from 'satori'

const svg = await satori(
  <div style={{ color: 'black' }}>hello, world</div>,
  {
    width: 600,
    height: 400,
    fonts: [
      {
        name: 'Roboto',
        // Use `fs` (Node.js only) or `fetch` to read the font as Buffer/ArrayBuffer and provide `data` here.
        data: robotoArrayBuffer,
        weight: 400,
        style: 'normal',
      },
    ],
  },
)
```

## How to connect
- Package (npm/PyPI)
- npm: `npm install satori`
- Repository: https://github.com/vercel/satori
- Website: https://github.com/vercel/satori

## Notes
npm latest 0.63.2 (registry).

## Numbers (AgentGid data)
- Gid Score: 55.5
- GitHub stars: 14,124
- Downloads last week: 2,842,555
- Used in 17 public projects set up for AI coding agents

## Lines to paste into your prompt or AGENTS.md

```
- Satori (Favicons and social preview images). Library that converts HTML/JSX and CSS to SVG (lays out with flexbox); commonly used to generate Open Graph and social card images, PNG via Sharp or Resvg. Price: free; commercial use OK.
  Connect: npm satori.
  Get files: npm i satori; call satori(element, {width, height, fonts}) to get an SVG string; convert to PNG with Sharp or Resvg (svg, png).
  Not allowed: Flexbox and a subset of CSS only
  Not allowed: You must supply font data
  Rule: MPL-2.0: modifications to Satori's own files must be shared under MPL; your own code can stay under your terms.
  Rule: Fonts must be passed as ArrayBuffer/Buffer; text will not render without a font.
  License: https://raw.githubusercontent.com/vercel/satori/main/LICENSE (checked 2026-10-21; details: https://agentgid.com/assets/satori/)
```

Not verified: Release dates not read (npm time block truncated); repo shows 533 commits and 14.1k stars.

## Links
- AgentGid page: https://agentgid.com/assets/satori/
- Is it free for commercial use? https://agentgid.com/assets/satori/commercial-use/
- Source: https://github.com/vercel/satori
- Source: https://raw.githubusercontent.com/vercel/satori/main/LICENSE
- Source: https://registry.npmjs.org/satori

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.