Skip to content

WorldLab Robotics Examples is the definitive resource for bridging the gap between Generative AI and Embodied Intelligence.

Notifications You must be signed in to change notification settings

pgeedh/WorldLab-RoboticsExamples

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

32 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ๐Ÿค– World Labs Robotics Examples

Hyper-realistic "Digital Twins" for robotics training generated via World Labs LWMs
Powered by World Labs

World Labs API License Python Status

๐Ÿ“š Documentation | ๐Ÿš€ Get Started | ๐Ÿ™ GitHub Repo


๐Ÿ“– About

WorldLab Robotics Examples bridges the gap between Generative AI and Embodied Intelligence. Traditional simulations are too sterile; real-world data is too expensive. We use World Labs' Large World Models (LWMs) to generate "Physically Grounded Digital Twins"โ€”chaotic, photorealistic, and 3D-consistent environments engineering-grade spatial reasoning.

Whether you are testing a quadruped on a construction site, a manipulator in a messy bedroom, or a social robot in a hotel lobby, this repository provides the "Digital Twin" blueprints you need. Physical intelligence requires physical data. This repository leverages the World Labs API to generate unlimited, photorealistic, and 3D-consistent environments ("Digital Twins") for robotics trainingโ€”ranging from domestic chores to complex industrial assembly.

๐Ÿ“ธ Visual Catalog & High-Fidelity Prompts

Below are the "Digital Twin" blueprints available in this repository. Each prompt is engineered for specific robotics vision and interaction tasks.

๐Ÿ  Domestic & Residential

Domestic Kitchen (Robotics Training)

Prompt: "A hyper-realistic, robot-centric digital twin of a modern domestic kitchen. Captured from a 1.2m height (robot eye level). Key interaction zones include a granite island with specific grasping targets..."

Domestic Kitchen ๐Ÿ‘‰ Click to Explore 3D World

Cluttered Bedroom (Manipulation)

Prompt: "A physically simulated messy bedroom for high-complexity manipulation training... A tangled pile of laundry (red t-shirt, blue jeans, white socks) rests on an unmade bed..."

Cluttered Bedroom ๐Ÿ‘‰ Click to Explore 3D World

Messy Airbnb (Housekeeping)

Prompt: "A 'lived-in' living room state for housekeeping robots. An open suitcase sits on a rug, spilling patterned clothing... The scene tests the robot's ability to distinguish between 'trash' and 'personal items'..."

Messy Airbnb ๐Ÿ‘‰ Click to Explore 3D World

๐Ÿญ Industrial & Logistics

Industrial Warehouse (Navigation)

Prompt: "A precision-mapped industrial warehouse aisle. High-contrast yellow safety lines painted on polished concrete floors. Metal racking units... Fiducial markers (QR codes) visible on shelf edges..."

Industrial Warehouse ๐Ÿ‘‰ Click to Explore 3D World

PCB Assembly Line (Fine Motor)

Prompt: "Macro-photography view of an electronics assembly workbench. A green PCB (Printed Circuit Board) is clamped in a holder... Nearby components: a tray of tiny 0402 resistors..."

PCB Assembly ๐Ÿ‘‰ Click to Explore 3D World

Data Center (Cable Maintenance)

Prompt: "System Role: Senior Simulation Engineer specializing in Deformable Linear Objects (DLOs)... Objective: Generate a high-fidelity 3D simulation environment for 'Data Center Cable Remediation'..."

Data Center ๐Ÿ‘‰ Click to Explore 3D World

Automotive Robotic Cell (Welding)

Prompt: "A heavy-industry automotive welding cell. A raw steel car chassis acts as the central workspace. Orange industrial robotic arms (KUKA-style)... Sparks from a spot welder are frozen in mid-air..."

Automotive Cell ๐Ÿ‘‰ Click to Explore 3D World

๐Ÿฅ Service & Commercial

Hotel Reception (Concierge)

Prompt: "A 5-star hotel lobby designed for social navigation. Polished marble floors reflecting the environment... The space is populated with 'ghost' proxies of people... Luggage carts with brass railings..."

Hotel Reception ๐Ÿ‘‰ Click to Explore 3D World

Restaurant Dining (Crowded Nav)

Prompt: "A dense restaurant dining floor layout. Round tables covered in white cloth... Chairs are pulled out at irregular angles, narrowing the navigation path to <60cm. Ambient lighting is dim/moody..."

Restaurant Dining ๐Ÿ‘‰ Click to Explore 3D World

Hospital Corridor (Delivery)

Prompt: "A sterile, bright hospital corridor. High-gloss vinyl flooring. Walls are white with color-coded wayfinding strips. Obstacles include a crash cart... Lighting is clinical fluorescent..."

Hospital Corridor ๐Ÿ‘‰ Click to Explore 3D World

Supermarket Shelves (Inventory)

Prompt: "A planogram-compliant supermarket aisle. Shelves are fully stocked with colorful cereal boxes... Several items are intentionally missing (out-of-stock) to test gap detection. Price tags on the shelf edge are legible..."

Supermarket ๐Ÿ‘‰ Click to Explore 3D World

๐Ÿšง Outdoor & Unstructured

City Sidewalk (Delivery Rover)

Prompt: "First-person view from a delivery rover on a city sidewalk. Paved concrete slabs with cracks and chewing gum stains. A fire hydrant (red) and a parking meter (gray) act as static obstacles..."

City Sidewalk ๐Ÿ‘‰ Click to Explore 3D World

Construction Site (Quadruped Locomotion)

Prompt: "An active chaotic construction site. Ground is uneven, covered in loose gravel and sand. Piles of red bricks and wooden pallets create traversability barriers. Exposed steel rebar acts as a snagging hazard..."

Construction Site ๐Ÿ‘‰ Click to Explore 3D World

Disaster Zone (Search & Rescue)

Prompt: "A simulated post-earthquake rubble pile. Broken slabs of concrete, twisted rebar, and shattered glass... Atmospheric dust/haze reduces visibility to 80%. Lighting is low-angle, simulating dusk..."

Disaster Zone ๐Ÿ‘‰ Click to Explore 3D World

Agricultural Field (Perception)

Prompt: "A robotic agriculture perception dataset. Parallel rows of green corn crops, approximately 1.5m high. The inter-row path is dirt with random weeds. Sunlight is directly overhead (noon)..."

Agricultural Field ๐Ÿ‘‰ Click to Explore 3D World


๐Ÿ“‚ Repository Structure

  • scripts/:
    • generate_with_api.py: (Core Tool) A powerful script pre-loaded with 15+ robotics scenarios to generate 3D worlds on demand.
  • prompts/:
    • core_collection.json: Structured JSON tasks linked to specific environments (e.g., "Plug in ethernet cable" -> "Data Center").
  • worlds/:
    • api_renders/: The output directory where your generated world thumbnails and assets are saved.

โšก Quick Start

1. Prerequisite

You need a World Labs Platform account and API key.

  1. Create a .env file:
    cp .env.example .env
  2. Add your key:
    WLT_API_KEY=wl_...
    

2. Generate Worlds

We have automated the creation of reference environments. Run the script to generate verified scenarios:

# Generates all configured scenarios using the World Labs API
python3 scripts/generation/generate_with_api.py

Note: This utilizes the Marble 0.1-mini model for speed and efficiency.

3. Use the Prompts

Load our structured prompts to test your robot's reasoning against these worlds.

import json
with open("prompts/core_collection.json", "r") as f:
    tasks = json.load(f)

# Example: Get a task for the Data Center environment
cable_task = [t for t in tasks[1]["prompts"] if t["id"] == "manip_cable_01"][0]
print(f"Task: {cable_task['task']}")

๐Ÿ“š Tutorials & Integrations

๐ŸŽฎ Sim-to-Real with NVIDIA Isaac Sim

Want to take these "Digital Twins" into a physics-based simulator? Check out our complete guide on exporting World Lab models: From Imagination to Simulation: A Complete Guide to Importing World Labs Marble Models into NVIDIA Isaac Sim

๐Ÿค Contributing

Have a new robotics use case?

  1. Fork the repo.
  2. Add your scenario to generate_with_api.py.
  3. Add a corresponding task to prompts/core_collection.json.
  4. Submit a Pull Request!

๐Ÿ“œ License

MIT License.


Made with โค๏ธ by Pruthvi Geedh

About

WorldLab Robotics Examples is the definitive resource for bridging the gap between Generative AI and Embodied Intelligence.

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages