矩阵游戏

Skywork AI

🔥🔥🔥 新闻！！

• 2026年3月27日：🔥 我们发布了Matrix-Game-3.0。这是一个具有长时记忆的实时流式交互世界模型。
• 2025年8月12日：🔥 我们发布了Matrix-Game-2.0。这是一个用于实时长视频生成的交互式世界基础模型。
• 2025年5月12日：🔥 我们发布了Matrix-Game-1.0。这是Skywork AI矩阵游戏系列世界模型的首次开源发布。

📝 概述

Matrix-Game 是由Skywork AI推出的一系列开源世界模型。

本仓库提供了Matrix-Game-1.0、Matrix-Game-2.0和Matrix-Game-3.0的官方实现。

https://github.com/user-attachments/assets/f5387c64-1d18-414a-935f-00a1f6eec8de

📄 许可证

本项目采用MIT许可证授权——详情请参阅LICENSE文件。

Matrix-Game 快速上手指南

Matrix-Game 是由 Skywork AI 推出的一系列开源世界模型，涵盖从基础视频生成到具备长时记忆的实时流式交互世界模型（最新为 Matrix-Game-3.0）。本指南将帮助您快速搭建环境并运行模型。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: Linux (推荐 Ubuntu 20.04/22.04) 或 macOS
• Python 版本: Python 3.9 或更高版本
• GPU 支持: 推荐使用 NVIDIA GPU，并安装对应的 CUDA 驱动 (CUDA 11.8 或 12.1+)
• 前置依赖:
  • Git
  • pip (包管理工具)
  • FFmpeg (用于视频处理)

提示：国内开发者建议使用国内镜像源加速 Python 包下载，例如阿里云或清华大学镜像源。

安装步骤

1. 克隆项目仓库

首先，从 GitHub 克隆 Matrix-Game 源代码。您可以根据需要选择特定版本（此处以最新的 3.0 版本为例）：

git clone https://github.com/SkyworkAI/Matrix-Game.git
cd Matrix-Game/Matrix-Game-3

2. 创建虚拟环境

建议创建一个独立的 Python 虚拟环境以避免依赖冲突：

python -m venv venv
source venv/bin/activate  # Windows 用户请使用: venv\Scripts\activate

3. 安装依赖库

使用 pip 安装所需依赖。国内用户推荐添加镜像源参数以加速下载：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

如果项目中包含可编辑安装的本地包，请执行：

pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple

基本使用

安装完成后，您可以使用提供的脚本进行简单的推理测试。以下是一个生成短视频或启动交互会话的最简示例。

运行推理示例

假设您想使用预训练权重生成一段视频，可以使用如下命令（具体参数请参考各版本目录下的 examples 文件夹）：

python infer.py --config configs/matrix_game_3.yaml --prompt "A futuristic city with flying cars" --output_dir ./outputs

启动交互式世界模型 (Matrix-Game-3.0)

对于支持实时流式交互的版本，可以启动服务进行互动：

python app.py --model_path checkpoints/matrix-game-3.0 --port 8080

启动后，在浏览器中访问 http://localhost:8080 即可体验实时交互功能。

注意：首次运行时，脚本可能会自动下载预训练模型权重。如果下载缓慢，请检查项目文档中是否提供了具体的国内网盘链接或手动下载路径。