Murea-Labs/InWorld

选用指南

AI 根据 README 整理 · 2026/11/1 17:21:18

适用场景

适合生成带音效的多角色场景视频、从最后帧延续片段、多人合作叙事，以及通过API集成到其他应用。

查看 README 依据

<!-- <img src="docs/assets/reference.gif" width="100%"> --> <b>🖼️ Film a scene from references</b><br> Two characters and a place, one prompt, a clip with dialogue and sound. <a href="inference/README.md#multi-reference-generation">Murea-Fast</a> </td> <td width="50%" valign="top"> <!-- <img src="docs/assets/continuation.gif" width="100%"> --> <b>🔄 Continue a clip</b><br> Pick up from the last frames and keep the action going. <a href="inference/README.md#continuation">Murea-Fast</a> </td> </tr> <tr>

<td width="50%" valign="top"> <!-- <img src="docs/assets/agent.gif" width="100%"> --> <b>🎭 Play a story</b><br> Type an action, watch it happen, choose what comes next. <a href="agent/README.md#quick-start">Murea-Mind</a> </td> <td width="50%" valign="top"> <!-- <img src="docs/assets/coop.gif" width="100%"> --> <b>👥 Play with friends</b><br> A shared room, one clip per round, with optional AI teammates. <a href="agent/README.md#co-op-mode">Co-op mode</a> </td> </tr> </table> <a name="how-it-fits-together"></a>

使用方式

通过命令行或 HTTP API 使用Murea-Fast生成视频，通过Web UI或Python API使用Murea-Mind进行交互式故事创作。

查看 README 依据

## 🧭 Where to start | I want to… | Start here | | --- | --- | | Play a story in the browser | [Murea-Mind quick start](agent/README.md#quick-start) | | Play with friends | [Co-op mode](agent/README.md#co-op-mode) | | Generate or continue a clip from the command line | [Murea-Fast quick start](inference/README.md#quick-start) | | Call the model from my own code | [API reference](inference/docs/api.md) | | Run the service on my GPUs | [Deployment](inference/docs/deployment.md) | | Know how fast it is and how much memory it needs | [Performance](inference/docs/performance.md) |

| Interface | HTTP API, command line | Web UI, terminal, Python API | <a name="quick-start"></a> ## 🚀 Quick start **1. Start Murea-Fast on a GPU machine.** Install the environment and the LTX-2.5 base components as described in [Deployment](inference/docs/deployment.md), download the [murea-fast.safetensors checkpoint](https://huggingface.co/MureaLabs/InWorld/blob/main/murea-fast.safetensors), and set the four paths in `inference/configs/single-gpu.json`. Set `checkpoint` to the absolute path of the downloaded file. Then: ```bash cd inference

部署要求

Murea-Fast需要Linux和NVIDIA GPU（支持CUDA），并在H20上验证；Murea-Mind需要Python 3.12、uv、语言和图像模型API密钥以及Murea-Fast服务。

查看 README 依据

| Contribute | [CONTRIBUTING.md](CONTRIBUTING.md) | <a name="components"></a> ## ⚙️ Components | | [Murea-Fast](inference/README.md) | [Murea-Mind](agent/README.md) | | --- | --- | --- | | What it is | Inference service for an 8-step distilled derivative of LTX-2.5, on a pinned SGLang | Web app and Python package: a language-model director, deterministic checks, world memory and a critic | | Runs on | Linux and NVIDIA GPUs with CUDA. Verified on one H20 and on four H20s | Any machine with Python 3.12; needs a language and image model API key and a Murea-Fast service |

bash scripts/murea-fast prepare --config configs/single-gpu.json bash scripts/murea-fast start --config configs/single-gpu.json curl --fail http://127.0.0.1:30260/health ``` **2. Run Murea-Mind on any machine.** It needs [uv](https://docs.astral.sh/uv/) and a key for text and images (Gemini, any OpenAI-compatible server, or DashScope): ```bash git clone https://github.com/Murea-Labs/InWorld.git Murea-InWorld && cd Murea-InWorld/agent cp .env.example .env # set GEMINI_API_KEY and MUREA_URL=http://<gpu-host>:30260 ./run.sh # then open http://127.0.0.1:8080 ```

已知限制

推理服务和智能体均无认证机制，部署在共享网络时需注意安全。项目依赖第三方API，其条款适用。

查看 README 依据

│ └── vendor/sglang/ pinned SGLang with the model implementation └── agent/ Murea-Mind ├── murea_agent/ the agent (Python package) ├── app/ FastAPI server ├── frontend/ React UI (prebuilt in frontend/dist) ├── docs/ co-op mode design notes └── tests/ ``` <a name="security"></a> ## 🔒 Security Neither the inference service nor the agent has authentication. Read [SECURITY.md](SECURITY.md) before deploying them on a shared network. <a name="contributing"></a> ## 🤝 Contributing

see [Provenance](inference/docs/provenance.md) for details. The agent calls third-party language and image model APIs, which have their own terms. <a name="citation"></a> ## 📚 Citation ```bibtex @misc{murea_inworld2026, title = {InWorld: From Imagination to Living Worlds with Agents and Fast Video Generation}, author = {{Murea Labs}}, year = {2026}, url = {https://murea.ai/page/paper/InWorld-technical-report.pdf} } ``` <a name="contact"></a> ## ✉️ Contact Email: [labs@murea.ai](mailto:labs@murea.ai)