Shumai

What is Shumai?

Shumai is a self-hostable, open source platform for creative teams to review, annotate, and approve video and image assets — built as a privacy-friendly alternative to Frame.io. It lets filmmakers, editors, agencies, and brand teams centralize their media libraries, leave frame-accurate comments, and run approval workflows without uploading sensitive footage to a third-party SaaS.

Key features

• Frame-by-frame annotations and timestamped comments on video and image assets, with precise drawing tools for visual feedback.
• S3-compatible and local storage — store media on your own filesystem or any S3-compatible provider (AWS S3, Cloudflare R2, MinIO, etc.).
• Secure public share links and curated collections for client review and stakeholder distribution.
• Granular access control with team-level and project-level role-based permissions.
• Distributed video transcoding via Temporal worker pools, so heavy media processing doesn't block the web server.
• Custom asset metadata — define and customize dynamic metadata fields tailored to your production pipeline.
• Built-in AI agent that can chat about your assets, autofill metadata using Google Gemini, run sandboxed scripts, and perform semantic search via vector embeddings.

Why self-host Shumai?

Unlike Frame.io, which requires uploading creative work-in-progress to Adobe's cloud, Shumai runs entirely on infrastructure you control. It's distributed as @shumai-one/shumai on npm, deployable via Docker Compose in minutes, and built on a modern stack (Bun, TypeScript, React, PostgreSQL with pgvector, Prisma, and Tailwind CSS).