Illustrations in your workflow
Install, sync and colour-override entire illustration sets from your terminal. Zero UI friction — just npx artifisio and go.
CLI first
One command to browse, download and update illustration sets directly into your project's public folder.
Always up to date
Run artifisio update to pull the latest version of any installed set — palette changes included.
SVG colour overrides
Remap any colour slot at download time so illustrations match your brand with zero post-processing.
Private sets
Generate your own custom illustration style and access it privately through the API with your personal key.
CDN ready
Pass --cdn to get jsDelivr URLs instead of downloading files — perfect for headless setups.
Project config
Settings are persisted to .artifisiorc.json so your team always installs the same sets and colours.
Get started in 3 steps
From zero to styled illustrations in under a minute.
Install the CLI
Run via npx without installing, or add it to your project dev dependencies.
Generate & save your API key
Head to your Profile → Developer API Keys to create a key. Keys start with artf_ and are shown only once — store them safely.
Key format
Each key is artf_ followed by 64 hex characters. Keys are hashed server-side; only the prefix is stored. You cannot recover a lost key — revoke and regenerate if needed.
Add illustrations to your project
Browse available sets, then pull them into your project. SVGs land in ./public/illustrations/<slug> by default.
Command reference
Every command the CLI exposes.
artifisio listList all public illustration sets available in the registry. Shows slug, tags, description, and illustration count.
artifisio add <set>Download an illustration set into your project and persist settings to .artifisiorc.json.
--cdnPrint CDN URLs instead of downloading--privateFetch a private set (requires saved API key)--dir <path>Override the output directory--colors <map>Colour overrides, e.g. primary=#FF5733,secondary=#3366FFartifisio update <set>Re-download an already-installed illustration set at the latest version, applying any saved colour overrides.
artifisio auth <api-key>Save your Artifisio API key to ~/.artifisio/config.json (mode 0600). Required for private sets.
artifisio whoamiDisplay the currently stored API key in masked form (first 12 chars + … + last 4 chars).
Colour overrides
Every SVG in a set uses named colour slots. Pass a comma-separated map to remap any slot at download time.
{
"outputDir": "./public/illustrations",
"sets": {
"open-doodles": {
"source": "registry",
"addedAt": "2025-01-15T10:32:00Z",
"colors": {
"primary": "#6366F1",
"secondary": "#EC4899"
}
}
}
}Colour mappings are persisted to .artifisiorc.json so artifisio update re-applies them automatically.
Managing API keys
Create, list, and revoke keys from your profile or via the REST API.
GET/api/dev/keysList all your API keys (prefix + metadata, never the raw key).
POST/api/dev/keysCreate a new key. Pass { name } in the JSON body. Returns the raw key once.
DELETE/api/dev/keys?id=<id>Revoke a key by its database ID. Immediate effect.
curl -X POST https://artifisio.com/api/dev/keys \
-H "Content-Type: application/json" \
-H "Cookie: <your-session-cookie>" \
-d '{"name": "ci-pipeline"}'
# Response (key shown once — save it immediately)
{
"id": "6823a1f…",
"name": "ci-pipeline",
"prefix": "artf_yourkeyh",
"key": "artf_yourkeyhere…"
}The raw API key is shown only once at creation. We store a SHA-256 hash server-side and cannot recover the original. If a key is lost, revoke it and create a new one from your profile.
Ready to ship?
Generate an API key, install your first set and start building — all in under 60 seconds.