Repolode
Submit
shumaiOne

shumaiOne/shumai

Open-source, self-hosted Frame.io alternative for reviewing, annotating and sharing video, image and other creative media with teams.

Open-source alternative to:Frame.io

View on GitHubWebsite
Stars
257
Forks
31
Open issues
18
Last commit
20 hours ago

What is it?

Shumai is a self-hosted platform for creative teams to upload, review and share media such as video, images, audio and documents. Reviewers can leave timestamped comments and frame-specific drawings on video and image assets, and teams can share assets through private links or curated collections, with optional watermarks on shared media.

Storage can be the local filesystem or any S3-compatible service such as AWS S3, Cloudflare R2 or MinIO. Videos are transcoded into proxies with scrubbing sprites and preview clips, 3D models get turntable previews, and Office documents can be converted to PDF proxies through Gotenberg. Projects support team and project-level role-based access, custom metadata fields, and semantic search based on vector embeddings.

The project also includes an AI agent that can be @mentioned in comments or chatted with privately, with MCP server support, sandboxed script execution and usage quotas. AI features are optional, and a built-in Kanban board supports task tracking. It runs via Docker Compose or Kubernetes, and the code is in TypeScript on Bun.

Key features

  • 01Timestamped comments and frame-level drawing annotations on video and images
  • 02Storage on local filesystem or any S3-compatible service
  • 03Private share links, collections and customizable watermarks
  • 04Team and project-level role-based access control
  • 05Video transcoding that can scale across multiple worker instances
  • 06Optional AI agent with MCP server and CLI support

Use cases

  • Collecting client feedback on video cuts and image drafts with timestamped comments
  • Sharing watermarked previews of unreleased footage with external stakeholders
  • Hosting a private, self-managed review system on your own S3 bucket or server
  • Previewing 3D models and Office documents in the browser for production teams

Quick start

  1. 1

    Create and enter a directory for config and data

    mkdir shumai && cd shumai
  2. 2

    Download the Lite docker-compose.yaml (needs about 2 GB RAM)

    curl -o docker-compose.yaml https://raw.githubusercontent.com/shumaiOne/shumai/main/docker-compose/local/docker-compose.yaml
  3. 3

    Start the services in detached mode

    docker compose up -d
  4. 4

    Open http://localhost:3000 in your browser

Things to know

  • Experimental features include the Premiere Pro plugin and NLE export.
  • The agentic Kanban is a work in progress, and agents cannot yet act on tasks.
  • Self-hosting needs setup, and remote or production deployments require configuring BETTER_AUTH_URL and storage settings.

In collections

Self-hosted apps

Topics

#video-review#filmmaking#media-management#self-hosted#s3#collaboration#docker#typescript#adobe#aifilmmaking

FAQ

What is shumai?
Open-source, self-hosted Frame.io alternative for reviewing, annotating and sharing video, image and other creative media with teams. Shumai is a self-hosted platform for creative teams to upload, review and share media such as video, images, audio and documents. Reviewers can leave timestamped comments and frame-specific drawings on video and image assets, and teams can share assets through private links or curated collections, with optional watermarks on shared media.
Is shumai free to use? What license does it have?
shumai is open source under the MIT license. Check the license terms before using it in commercial products.
Is shumai still maintained?
Actively maintained. The last commit to shumai was on Nov 6, 2026.
What can I use shumai for?
Collecting client feedback on video cuts and image drafts with timestamped comments Sharing watermarked previews of unreleased footage with external stakeholders Hosting a private, self-managed review system on your own S3 bucket or server Previewing 3D models and Office documents in the browser for production teams
How do I install shumai?
Create and enter a directory for config and data: mkdir shumai && cd shumai Download the Lite docker-compose.yaml (needs about 2 GB RAM): curl -o docker-compose.yaml https://raw.githubusercontent.com/shumaiOne/shumai/main/docker-compose/local/docker-compose.yaml Start the services in detached mode: docker compose up -d Open http://localhost:3000 in your browser
Where can I get shumai?
The source code and installation instructions are on GitHub: https://github.com/shumaiOne/shumai

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects