pwnera/artbucket

[ ][Live brand page]
----
**Your brand's source of truth, open source.**
Which logo is current? What colors should an agent use? Is this photo cleared
for paid social in Germany?
Artbucket keeps a brand's assets, rules, rights and releases together, and
gives the same answer to people, AI agents and code. People read it in the web
app and on portals, agents query it over MCP, code consumes it through the API,
the CLI and Git.
**Web app · MCP · REST API · CLI · Git**
[Try Artbucket Cloud][Artbucket Cloud] · [Live brand page] · [Docs] · Run it yourself
----
Your brand is an API
Find the asset, ask whether it may run, get it at the size you need:
Agents make the same calls over MCP (search_assets, check_use,
rendition_url), and code over the [REST API] (/api/v1, with an OpenAPI
spec). The web app is a client of that API, with zero private endpoints, so
everything it does, you can script. See [May I use this?][check] and the [CLI].
Connect an AI agent
/api/v1/mcp is an MCP server. Give the URL to any agent: it opens a consent
screen where you pick what it may do (Suggest, Read or Edit), and the agent
gets a key bound to you, never more than you can do.
That is [Artbucket Cloud]; on your own server, use its URL. Then ask: *"Give me
the approved logo for a dark background."* The agent checks the use and gets
the brand's dark-background variant, as a URL at the size it needs.
The Claude Code plugin adds a skill that teaches the workflow (brand rules
first, a use check before publishing, provenance on anything generated):
/plugin marketplace add pwnera/artbucket, then
/plugin install artbucket@artbucket (Cloud; on your own server, start Claude
Code with ARTBUCKET_URL set to its URL). Other agents: npx skills add pwnera/artbucket.
See [MCP].
Run it yourself
The whole core is here, free to self-host on Postgres and an S3-compatible
bucket. Nothing held back, nothing to unlock, no telemetry. You need Node 22+,
pnpm and Docker:
Open http://localhost:3000 and make the first account: it is the admin of
everything. No Node on the machine? Set BETTER_AUTH_SECRET in .env
(openssl rand -base64 32) and run the published image with
docker compose --profile app up -d. The [quick start] takes it from there.
To put it on a server, follow the guide for [Render], [Docker Compose],
[Docker], [Fly], [Kubernetes], [Coolify] or a [plain VPS]. Any S3-compatible
storage works: AWS S3, Cloudflare R2, Backblaze B2, MinIO, Garage, SeaweedFS.
What Artbucket manages
- **Catalog: the governance and context layer.** Every brand, rule, guideline
page, collection, asset and portal of an organization in one catalog, each
with an address (acme/corporate/asset/logo-primary@4), one search across
all of it, lineage (what it comes from, what uses it, what a change
reaches), who can reach it and through which grant, and what happened to
it. People govern it in the app; agents and code read the same context over
MCP, the API and the CLI ([catalog]).
- **Assets: what exists.** The library: search in milliseconds at 100,000
assets, and any size or format from one original as a URL,
/a/{id}/w_1200,f_webp, with no export and no duplicate.
- **Rules: how to use it.** Colors, type, logo rules and don'ts as typed
records with history, tied to the assets; guideline pages and design tokens
are drawn from them.
- **Rights: where it may run.** License, channels, territories, embargo and
last day of use on each asset. Ask before it runs: yes, or why not and what