Instructions to use Overworld/Waypoint-1-Small with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use Overworld/Waypoint-1-Small with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("Overworld/Waypoint-1-Small", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
| # Copyright (C) 2025 Hugging Face Team and Overworld | |
| # | |
| # This program is free software: you can redistribute it and/or modify | |
| # it under the terms of the GNU General Public License as published by | |
| # the Free Software Foundation, either version 3 of the License, or | |
| # (at your option) any later version. | |
| # | |
| # This program is distributed in the hope that it will be useful, | |
| # but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| # GNU General Public License for more details. | |
| # | |
| # You should have received a copy of the GNU General Public License | |
| # along with this program. If not, see <https://www.gnu.org/licenses/>. | |
| """ | |
| WorldEngine Modular Pipeline | |
| A Diffusers-compatible modular pipeline for frame-by-frame world model generation. | |
| Supports text and controller (mouse + button + scroll) conditioning. | |
| """ | |
| from .modular_blocks import WorldEngineBlocks, AUTO_BLOCKS | |
| from .encoders import WorldEngineTextEncoderStep, WorldEngineControllerEncoderStep | |
| from .before_denoise import ( | |
| WorldEngineBeforeDenoiseStep, | |
| WorldEngineSetTimestepsStep, | |
| WorldEnginePrepareLatentsStep, | |
| WorldEngineSetupKVCacheStep, | |
| StaticKVCache, | |
| LayerKVCache, | |
| ) | |
| from .denoise import WorldEngineDenoiseLoop | |
| from .decoders import WorldEngineDecodeStep | |
| from .vae import WorldEngineVAE | |
| __version__ = "0.1.0" | |
| __all__ = [ | |
| # Main pipeline blocks | |
| "WorldEngineBlocks", | |
| "AUTO_BLOCKS", | |
| # Encoder blocks | |
| "WorldEngineTextEncoderStep", | |
| "WorldEngineControllerEncoderStep", | |
| # Before denoise blocks | |
| "WorldEngineBeforeDenoiseStep", | |
| "WorldEngineSetTimestepsStep", | |
| "WorldEnginePrepareLatentsStep", | |
| "WorldEngineSetupKVCacheStep", | |
| # Denoise block | |
| "WorldEngineDenoiseLoop", | |
| # Decoder blocks | |
| "WorldEngineDecodeStep", | |
| # Models | |
| "WorldModel", | |
| "WorldEngineVAE", | |
| # KV Cache | |
| "StaticKVCache", | |
| "LayerKVCache", | |
| ] | |