Shumai — это открытая платформа для креативной работы, которая работает с медиафайлами, AI-ассистентом и управлением контентом. По сути, это готовый бэкенд для студий, продюсерских центров или команд, работающих с видео и изображениями.
Из коробки Shumai предлагает S3-совместимое хранилище — можно использовать локальную файловую систему, AWS S3, Cloudflare R2 или MinIO. Есть покадровые аннотации и комментарии с привязкой к времени, безопасные публичные ссылки и коллекции для клиентов, а также гибкое управление доступом на уровне команд и проектов.
Видео кодируется в фоне — за это отвечает распределённый transcoding на Temporal. Можно добавлять кастомные метаданные для своих пайплайнов. AI-агент работает прямо в проектном пространстве, поддерживает написанные пользователем скрипты и тулзы, которые выполняются в изолированном sandbox-окружении. Метаданные автоматически заполняются через Google Gemini. Поиск — семантический, по векторным эмбеддингам.
Установка. Самый быстрый способ — Docker Compose. Нужно создать папку, скачать docker-compose.yaml из репозитория и запустить. Для удалённых серверов (AWS EC2, VPS) потребуется указать публичный IP в переменной AWS_ENDPOINT_URL_S3.
Второй вариант — установка глобально через NPM, PNPM или Bun. Сначала запускается PostgreSQL с расширением pgvector в Docker. Затем создаётся рабочая папка, устанавливаются системные зависимости: ffmpeg, bubblewrap, socat, ripgrep. На Ubuntu 24.04 придётся отключить ограничения на user namespaces через sysctl, иначе sandbox не заработает. После этого ставится сам пакет @shumai-one/shumai, настраивается .env с DATABASE_URL, STORAGE_BACKEND=local и портом 3000. Если используется Bun и пакет запускается через глобальную команду, нужно явно указывать bun run --bun shumai.
Третий вариант — разработка из исходников: клонировать репозиторий, установить зависимости bun install, поднять pgvector, скопировать .env, накатить миграции и запустить dev-сервер.
У Shumai есть CLI для управления проектами, папками и ассетами прямо из терминала. Все детали — в документации на сайте.