一个适用于您所有创意工作的开源平台。网站 | 文档 | 演示特点 S3 兼容和本地存储：使用本地文件系统或任何 S3 兼容的云存储（如 AWS S3、Cloudflare R2、MinIO 等）安全地存储和服务您的创意资产。逐帧注释和评论：使用针对特定帧的绘图工具和带时间戳的评论直接对视频和图像资产提供精准反馈。安全分享和集合：创建安全的公共分享链接和策划的媒体集合，与客户和利益相关者进行协作。细粒度访问控制：使用基于团队和项目的角色访问控制管理工作区权限。通过 Temporal 进行分布式转码：将资源密集型视频转码任务卸载到由 Temporal 协调的后台工作池。自定义资产元数据：定义和自定义适合您生产流程的动态元数据字段。Shumai 代理协作 AI 聊天：直接在项目工作区与具备上下文意识的 AI 代理进行对话。自定义技能和工具：通过注册自定义脚本、工具和自动化技能来扩展代理的能力。隔离的沙箱执行：在沙箱环境中安全地运行代理提交的脚本。AI 驱动的元数据自动填充：使用 Google Gemini 自动生成新资产的标签、描述和自定义元数据。语义搜索：基于视觉或概念搜索查询，使用向量嵌入瞬时查找到资产。安装以下是运行 Shumai 的快速入门指南，使用本地存储。有关高级配置选项（包括 S3 兼容存储和 Temporal 工作流编排），请参见我们的文档。选项 1：使用 Docker Compose Docker Compose 是启动 Shumai 的最快方式。您无需手动克隆代码库或安装软件包。确保您已安装 Docker 和 Docker Compose，然后按照以下步骤操作：为您的配置和数据卷创建并导航至一个新目录：mkdir shumai && cd shumai 下载 docker-compose.yaml 文件：curl -o docker-compose.yaml https://raw.githubusercontent.com/shumaiOne/shumai/main/docker-compose/local/docker-compose.yaml 配置环境变量（仅限远程部署）：如果将 Shumai 部署到远程服务器（如 AWS EC2、VPS），请编辑 docker-compose.yaml 文件并在环境部分下添加 AWS_ENDPOINT_URL_S3，设置为您服务器的公共 IP 地址或域名（例如 http://12.34.56.78）。以分离模式启动服务：docker compose up -d 打开浏览器并访问 Shumai，网址为 http://localhost:3000（或 http://<your-server-ip>:3000，适用于远程部署）。选项 2：通过 NPM / 包管理器安装 Shumai 在 NPM 上发布为 @shumai-one/shumai。此选项允许您全局或本地运行 Shumai。步骤 1：启动带有 pgvector 的 PostgreSQL Shumai 需要 PostgreSQL 和 pgvector 扩展。使用 Docker 启动一个预配置的数据库容器：docker run --name shumai_postgres -e POSTGRES_USER=shumai -e POSTGRES_PASSWORD=shumai_password -e POSTGRES_DB=shumai_db -p 5432:5432 -d pgvector/pgvector:pg18 步骤 2：创建工作区文件夹 创建一个专用目录以存储您的环境配置和媒体文件（默认保存在 ./data 目录中）：mkdir shumai && cd shumai 步骤 3：安装平台特定依赖项 确保在安装 Shumai 之前，您的主机上安装了以下系统依赖项：软件包描述 Ubuntu/Debian Fedora Arch macOS ffmpeg 媒体转码和元数据提取 sudo apt install -y ffmpeg sudo dnf install -y ffmpeg sudo pacman -S --noconfirm ffmpeg brew install ffmpeg bubblewrap 用于安全 AI 代理执行的沙箱环境 sudo apt install -y bubblewrap sudo dnf install -y bubblewrap sudo pacman -S --noconfirm bubblewrap NOT REQUIRED socat 双向套接字中继，用于沙箱网络桥接 sudo apt install -y socat sudo dnf install -y socat sudo pacman -S --noconfirm socat brew install socat ripgrep 工作区安全策略的快速搜索工具 sudo apt install -y ripgrep sudo dnf install -y ripgrep sudo pacman -S --noconfirm ripgrep brew install ripgrep 注意：Ubuntu 24.04+ 注意：这些版本默认限制非特权用户命名空间。为了使 bubblewrap 和沙箱隔离层能够工作，请禁用此限制：sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0 或者，配置一个 AppArmor 配置文件，授予相关二进制文件创建用户命名空间的权限（userns）。步骤 4：全局安装 Shumai 使用您喜欢的包管理器全局安装 Shumai：# NPM npm install -g @shumai-one/shumai # PNPM pnpm add -g @shumai-one/shumai # Bun bun add -g @shumai-one/shumai 步骤 5：配置环境变量 在您的工作区文件夹中（shumai/）创建一个 .env 文件，并添加以下配置：DATABASE_URL = postgresql://shumai:shumai_password@localhost:5432/shumai_db