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/>. | |
| """Block registry for WorldEngine modular pipeline.""" | |
| from diffusers.utils import logging | |
| from diffusers.modular_pipelines import SequentialPipelineBlocks | |
| from diffusers.modular_pipelines.modular_pipeline_utils import InsertableDict | |
| from .encoders import WorldEngineTextEncoderStep, WorldEngineControllerEncoderStep | |
| from .before_denoise import WorldEngineBeforeDenoiseStep | |
| from .denoise import WorldEngineDenoiseLoop | |
| from .decoders import WorldEngineDecodeStep | |
| logger = logging.get_logger(__name__) | |
| AUTO_BLOCKS = InsertableDict( | |
| [ | |
| ("text_encoder", WorldEngineTextEncoderStep), | |
| ("controller_encoder", WorldEngineControllerEncoderStep), | |
| ("before_denoise", WorldEngineBeforeDenoiseStep), | |
| ("denoise", WorldEngineDenoiseLoop), | |
| ("decode", WorldEngineDecodeStep), | |
| ] | |
| ) | |
| class WorldEngineBlocks(SequentialPipelineBlocks): | |
| """Sequential pipeline blocks for WorldEngine frame generation.""" | |
| block_classes = list(AUTO_BLOCKS.copy().values()) | |
| block_names = list(AUTO_BLOCKS.copy().keys()) | |