Skip to main content
The eaia website embeds public binary assets — Rerun .rrd recordings, manim mp4s, demo previews — from https://artifacts.aegeanai.com, a public Cloudflare R2 bucket (auraison-artifacts) with a custom domain binding.

​
Canonical setup + automation

The full bucket setup (custom domain, CORS, Cloudflare Access bypass, API tokens) and the production upload helper live in the auraison repo. Don’t re-derive them here.
  • Serve Rerun recordings publicly with Cloudflare R2 — 8-step bucket setup
  • auraison/data-plane/lakehouse/artifacts.py — upload_artifact() for lakehouse-registered, lineage-tracked uploads (archival MinIO + R2 + DuckLake catalog in one call)
  • R2 credentials are in auraison/data-plane/.env as R2_ENDPOINT, R2_ACCESS_KEY, R2_SECRET_KEY, R2_PUBLIC_DOMAIN
For Cloudflare-aware Claude Code sessions, install the official skill package: 
/plugin install cloudflare@cloudflare
That gives Claude the cloudflare and wrangler skills — covering R2 buckets, Workers, KV, D1, and the wrangler r2 object put upload path.

​
One-off uploads of website media (manim mp4s, preview images)

For media that’s purely a docs-site asset (no lakehouse lineage needed), use wrangler directly: 
wrangler r2 object put auraison-artifacts/manim/brownian-motion/BrownianMotion.mp4 \
  --file ./videos/BrownianMotion.mp4 \
  --content-type video/mp4 \
  --remote
The --remote flag is required to write to the real bucket (without it, wrangler writes to a local simulator).

​
Key-naming convention

Public URL is https://artifacts.aegeanai.com/<key>. Keep the <type>/<topic>/<filename> shape:
PrefixPurposeExample key
rerun/<demo>/Rerun recordings (.rrd)rerun/visdrone/uav0000009_03358_v.rrd
manim/<topic>/Manim mp4 outputsmanim/brownian-motion/BrownianMotion.mp4
demos/<demo>/Static demo assetsdemos/sports-analytics/clip-01.mp4
images/<demo>/Demo thumbnails / previewsimages/sports-analytics/preview.jpg
Lowercase, kebab-case for path segments. Filenames may follow the generator’s convention (PascalCase manim Scene class names, etc.).

​
Embedding in MDX

​
Manim mp4

<video
  src="https://artifacts.aegeanai.com/manim/brownian-motion/BrownianMotion.mp4"
  controls
  loop
  muted
  playsInline
  width="100%"
  style={{ borderRadius: 8 }}
/>
muted + playsInline are required for any mobile-browser auto-play. Drop both for narrated full-frame demos.

​
Rerun recording

<iframe
  src="https://app.rerun.io/version/0.29.2/index.html?url=https%3A%2F%2Fartifacts.aegeanai.com%2Frerun%2Fvisdrone%2Fuav0000009_03358_v.rrd"
  width="100%"
  height="600px"
  style={{ border: "none", borderRadius: 8 }}
  allow="fullscreen"
  loading="lazy"
/>
Pin the viewer version (/version/0.29.2/) to the Rerun SDK that wrote the recording — newer .rrd files won’t load in older viewers (lz4 decode error). See the auraison doc Step 7 for the exact symptom and fix.

​
Cache invalidation

Wrangler defaults set R2 objects with a long max-age. Treat artifacts as content-addressed: re-rendering a manim scene should land under a new key (version suffix or new topic) rather than overwriting. The Cloudflare edge will keep stale copies of overwritten keys for hours-to-a-day. If you must overwrite, follow up with a cache purge from the Cloudflare dashboard or wrangler cache purge.
Edit this page on GitHub or file an issue.