From a26215bb99a04443d06e642bf736dc50e6f6a49d Mon Sep 17 00:00:00 2001
From: paularamo <pjramg@gmail.com>
Date: Mon, 15 Jun 2026 14:04:48 -0400
Subject: [PATCH 1/4] Improve CONTRIBUTING.md with cookbook structure, quality
 requirements, and recipe templates

Replaces the generic contributing guide with a structured document that
reflects the actual cookbooks/cosmos3/ directory layout and establishes
clear quality requirements for community-contributed cookbooks:

- Cookbook structure section with routing table (reasoner, generator/audiovisual,
  generator/action, generator/transfer)
- Five quality requirements: open-access data, results/expected output,
  canonical setup, one-click runnable, naming convention
- Cookbook README template ready for contributors to copy
- Contribution areas table with clear accept/reject criteria
- Testing checklist for pre-submission validation

(cherry picked from commit 57d2fa422e535155f625b68fbf1a3a58f8713338)
---
 CONTRIBUTING.md | 256 +++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 219 insertions(+), 37 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index fd6ad5e3..59669a89 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,81 +1,263 @@
 # Contributing to NVIDIA Cosmos
 
-Thank you for your interest in contributing to NVIDIA Cosmos. This document provides guidelines and instructions for contributing.
+Thank you for your interest in contributing to NVIDIA Cosmos. This guide covers how to propose changes, add new cookbooks, and maintain the quality bar we hold for community-facing content.
 
 ## Code of Conduct
 
 This project adheres to the [NVIDIA Open Source Code of Conduct](https://github.com/NVIDIA/cosmos/blob/main/CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior by filing an issue or contacting [cosmos-license@nvidia.com](mailto:cosmos-license@nvidia.com).
 
+---
+
 ## How to Contribute
 
 ### Reporting Issues
 
-If you encounter a bug or have a feature request, please open an issue on the [GitHub Issues](https://github.com/NVIDIA/cosmos/issues) page. When filing an issue, include:
+Open an issue on [GitHub Issues](https://github.com/NVIDIA/cosmos/issues) with:
 
-- A clear and descriptive title
-- Steps to reproduce the problem (if applicable)
-- Expected behavior vs. actual behavior
-- Your environment details (OS, CUDA version, GPU model, Python version)
+- A clear, descriptive title
+- Steps to reproduce (if applicable)
+- Expected vs. actual behavior
+- Environment details: OS, CUDA version, GPU model, Python version, `uv` version
 - Relevant logs or error messages
 
-### Submitting Changes
+### Contribution Workflow
 
-1. **Fork the repository** and create a new branch from `main`:
+1. **Fork** the repository and create a branch from `main`:
 
-   ```shell
-   git checkout -b your-branch-name
+   ```bash
+   git checkout -b cookbook/descriptive-name   # or docs/, fix/, benchmark/
    ```
 
-2. **Make your changes.** Ensure your changes follow the project conventions and do not introduce regressions.
+2. **Make your changes** following the guidelines below.
 
-3. **Test your changes.** Verify that existing cookbooks and examples still work correctly with your modifications.
+3. **Test your changes.** Run your notebook end-to-end on the target GPU. Verify existing cookbooks are unaffected.
 
-4. **Commit your changes** with a clear, descriptive commit message:
+4. **Commit** with a clear message:
 
-   ```shell
-   git commit -m "Brief description of the change"
+   ```bash
+   git commit -m "Add worker-safety Reasoner cookbook with vLLM backend"
    ```
 
-5. **Push to your fork** and open a Pull Request against the `main` branch of the upstream repository.
+5. **Push and open a Pull Request** against `main`.
 
 ### Pull Request Guidelines
 
 - Provide a clear description of what your PR does and why
-- Reference any related issues (e.g., `Fixes #123`)
-- Keep PRs focused: one logical change per PR
-- Ensure your branch is up to date with `main` before submitting
-- Be responsive to review feedback
+- Reference related issues (e.g., `Fixes #123`)
+- One logical change per PR
+- Ensure your branch is up to date with `main`
+- Respond to review feedback promptly
+
+---
+
+## Cookbook Structure
+
+The `cookbooks/` directory is organized by **model generation → tower → capability**. Each cookbook is a self-contained directory with a README, one or more runnable notebooks, and supporting assets.
+
+```
+cookbooks/
+└── cosmos3/
+    ├── README.md                          # Shared setup (all backends)
+    ├── cosmos3-model-architecture.png
+    │
+    ├── reasoner/                          # Reasoner Tower
+    │   ├── README.md                      # Reasoner overview + backend table
+    │   ├── reasoner_prompt_guide.md       # Prompt engineering reference
+    │   ├── run_with_vllm.ipynb            # Cookbook: vLLM backend
+    │   ├── run_with_nim.ipynb             # Cookbook: NIM backend
+    │   ├── run_with_cosmos_framework.ipynb # Cookbook: Framework backend
+    │   └── assets/                        # Images, videos, sample outputs
+    │
+    └── generator/
+        ├── audiovisual/                   # Generator: T2I, T2V, I2V, audio
+        │   ├── README.md
+        │   ├── run_with_diffusers.ipynb
+        │   ├── run_with_vllm_omni.ipynb
+        │   ├── run_with_cosmos_framework.ipynb
+        │   └── assets/
+        │
+        ├── action/                        # Generator: policy, FDM, IDM
+        │   ├── README.md
+        │   ├── run_fd_with_cosmos_framework.ipynb
+        │   ├── run_fd_with_vllm.ipynb
+        │   ├── run_id_with_cosmos_framework.ipynb
+        │   ├── run_id_with_vllm.ipynb
+        │   ├── run_policy_with_cosmos_framework.md
+        │   └── assets/
+        │
+        └── transfer/                      # Generator: video-to-video transfer
+            ├── README.md
+            ├── run_video_transfer_with_cosmos_framework.ipynb
+            ├── preview_helpers.py
+            ├── specs/
+            └── assets/
+```
+
+### Where Does My Cookbook Go?
+
+| Your cookbook does... | Place it under |
+|----------------------|---------------|
+| Image/video understanding, VLM, reasoning, grounding | `cookbooks/cosmos3/reasoner/` |
+| Text-to-image, text-to-video, image-to-video, audio | `cookbooks/cosmos3/generator/audiovisual/` |
+| Robotics policy, forward/inverse dynamics | `cookbooks/cosmos3/generator/action/` |
+| Video-to-video style transfer, edge-guided generation | `cookbooks/cosmos3/generator/transfer/` |
+
+If your cookbook spans multiple towers (e.g., Reasoner analysis → Generator synthesis), create a new directory under `cookbooks/cosmos3/` with a clear name (e.g., `cookbooks/cosmos3/end2end/`).
+
+---
+
+## Cookbook Quality Requirements
+
+Every cookbook merged into this repo must meet these requirements. Reviewers will check each item.
+
+### 1. Open-Access Data Only
+
+- All datasets must be **publicly downloadable** without NVIDIA-internal credentials
+- Acceptable sources: HuggingFace Hub (public or gated with free access), public URLs, synthetic data generated in the notebook
+- If working with partners, request a **small public subset** for the cookbook example
+- Include the dataset license in your README
+
+**Not acceptable:** Internal S3 buckets, VPN-only URLs, private NFS mounts, datasets requiring paid partner agreements
+
+### 2. Results / Expected Output
+
+Every cookbook must include a **Results** section showing what a successful run looks like:
+
+- **Inference cookbooks:** Sample generated images/videos, text outputs, or action trajectories saved to `assets/`
+- **Post-training cookbooks:** Training loss curves, before/after comparison, evaluation metrics
+- **Timing benchmarks:** Wall-clock time on the target GPU (e.g., "Cosmos3-Nano T2V: 45s on 1× A100")
+
+This lets developers validate their own runs against a known-good baseline.
+
+### 3. Canonical Setup (No Hidden Dependencies)
+
+- **Do not duplicate setup instructions.** Link to the shared [`cookbooks/cosmos3/README.md`](cookbooks/cosmos3/README.md) for backend installation (Cosmos Framework, Diffusers, vLLM, NIM)
+- Your README should only document **cookbook-specific** dependencies beyond the shared setup
+- All dependencies must be installable via `uv pip install` or `apt-get` — no manual builds
+- Pin specific versions of critical packages when they affect reproducibility
+
+### 4. One-Click Runnable
+
+- Each notebook should run **top-to-bottom without manual intervention**
+- Use environment variables for configurable paths (`HF_TOKEN`, `COSMOS3_MEDIA_ROOT`, etc.)
+- Default to the smallest model size (Cosmos3-Nano) so the widest set of GPUs can run it
+- If a cookbook requires a running server (vLLM, NIM), provide the exact launch command in the README and automate the health check in the notebook
+
+### 5. Naming Convention
+
+Follow the existing pattern:
+
+```
+run_<task>_with_<backend>.ipynb
+```
+
+Examples:
+- `run_with_vllm.ipynb` — generic Reasoner inference via vLLM
+- `run_fd_with_cosmos_framework.ipynb` — forward dynamics via Cosmos Framework
+- `run_video_transfer_with_cosmos_framework.ipynb` — video transfer via Cosmos Framework
+
+For markdown-only guides (no notebook): `run_<task>_with_<backend>.md`
+
+---
+
+## Cookbook README Template
+
+Each cookbook directory needs a `README.md`. Use this structure:
+
+```markdown
+# [Cookbook Title]
+
+One-paragraph description of what this cookbook demonstrates and why it matters.
+
+## What You'll Build
+
+- Bullet list of concrete outputs (e.g., "Generate a 480p video from a text prompt")
+
+## Prerequisites
+
+- Link to [shared setup](../README.md#backend-name) for backend installation
+- Any additional cookbook-specific requirements
+
+## Backends
+
+| Backend | Notebook | GPU Requirement |
+|---------|----------|----------------|
+| vLLM    | [`run_with_vllm.ipynb`](run_with_vllm.ipynb) | 1× A100 (80 GB) |
+| NIM     | [`run_with_nim.ipynb`](run_with_nim.ipynb) | 1× A100 (80 GB) |
+
+## Quick Start
+
+Minimal steps to go from clone to first result:
+
+    1. Set up the backend (link)
+    2. Run the notebook
+    3. Check your outputs in `assets/`
+
+## Results / Expected Output
+
+Sample outputs, metrics, and timing benchmarks from a successful run.
+
+## Dataset
+
+| Name | Source | License | Size |
+|------|--------|---------|------|
+| Dataset Name | [HuggingFace link](...) | Apache 2.0 | ~2 GB |
+```
+
+---
+
+## Contribution Areas
+
+We welcome contributions in these areas:
+
+| Area | Examples |
+|------|---------|
+| **New cookbooks** | Domain-specific applications (robotics, AV, healthcare, manufacturing) |
+| **New backends** | Additional serving/inference backends for existing cookbooks |
+| **Documentation** | README improvements, prompt guides, architecture explanations |
+| **Bug fixes** | Notebook fixes, broken links, version compatibility issues |
+| **Benchmarks** | Inference timing across GPU configurations (A100, H100, L40S, RTX 4090) |
+| **Post-training recipes** | SFT, LoRA, domain adaptation examples with open datasets |
+
+### What We Won't Merge
+
+- Cookbooks that depend on internal/proprietary datasets
+- Notebooks that require manual mid-run intervention
+- Changes that break existing cookbook functionality
+- Generated binary files (model weights, large media) — use HuggingFace/external links instead
+
+---
 
 ## Development Setup
 
 ### Prerequisites
 
 - Python 3.10 or later
-- CUDA 12.8 or 13.x (see [Troubleshooting](README.md#troubleshooting) for version matching)
+- CUDA 12.8 or 13.x (see [Troubleshooting](README.md#troubleshooting))
 - An NVIDIA GPU with sufficient VRAM for your target workflow
-- `uv` >= 0.11.3 (install from [astral.sh/uv](https://astral.sh/uv))
+- `uv` >= 0.11.3 ([astral.sh/uv](https://astral.sh/uv))
+- `git-lfs` installed (`apt-get install git-lfs`)
 
 ### Getting Started
 
-1. Clone the repository:
+```bash
+git clone https://github.com/NVIDIA/cosmos.git
+cd cosmos
+```
 
-   ```shell
-   git clone https://github.com/NVIDIA/cosmos.git
-   cd cosmos
-   ```
-
-2. Set up your environment following the instructions in the [README](README.md).
+Follow [cookbooks/cosmos3/README.md](cookbooks/cosmos3/README.md) to set up the backend(s) your cookbook uses.
 
-3. Explore the [cookbooks](cookbooks/) for end-to-end examples of Generator and Reasoner workflows.
+### Testing Your Cookbook
 
-## Contribution Areas
+Before submitting:
 
-We welcome contributions in the following areas:
+1. **Clean run:** Restart your kernel and run all cells top-to-bottom
+2. **Minimal GPU:** Test on the smallest supported GPU configuration
+3. **No secrets:** Verify no API keys, tokens, or internal paths are committed
+4. **Output cells:** Clear large output cells but keep the Results section outputs
+5. **File sizes:** Ensure no single file exceeds 10 MB (use git-lfs for larger assets or link externally)
 
-- **Cookbooks and examples:** New notebooks demonstrating Cosmos 3 capabilities
-- **Documentation:** Improvements to README, cookbook READMEs, or inline documentation
-- **Bug fixes:** Fixes for issues in existing code or documentation
-- **Benchmarks:** Additional inference benchmark results across different hardware configurations
+---
 
 ## License
 
@@ -83,4 +265,4 @@ By contributing to this project, you agree that your contributions will be licen
 
 ## Questions?
 
-If you have questions about contributing, feel free to open an issue or reach out at [cosmos-license@nvidia.com](mailto:cosmos-license@nvidia.com).
+If you have questions about contributing, open an issue or reach out at [cosmos-license@nvidia.com](mailto:cosmos-license@nvidia.com).

From 8818044aff5b6a7f56ff43d110bbbc4c7b54b296 Mon Sep 17 00:00:00 2001
From: paularamo <pjramg@gmail.com>
Date: Mon, 15 Jun 2026 14:18:49 -0400
Subject: [PATCH 2/4] Restructure cookbooks into basic_examples/ to prepare for
 community contributions

Move all existing notebooks, assets, specs, and helpers into basic_examples/
subdirectories under each tower (reasoner, generator/audiovisual, generator/action,
generator/transfer). This creates clean top-level directories ready to receive
community-contributed cookbooks as sibling folders alongside basic_examples/.

- reasoner/basic_examples/: 3 notebooks + prompt guide + 15 media assets
- generator/audiovisual/basic_examples/: 3 notebooks + prompts/images
- generator/action/basic_examples/: 5 notebooks + action/robot assets
- generator/transfer/basic_examples/: 1 notebook + specs + control videos
- Updated all 4 tower READMEs with basic_examples/ cookbook tables and paths
- Updated CONTRIBUTING.md directory tree to show contribution placement

(cherry picked from commit cd95eccceb30733b1a5b0493fe947f2963c4e119)
---
 CONTRIBUTING.md                               |  49 +++++++++++-------
 cookbooks/cosmos3/generator/action/README.md  |  40 +++++++++-----
 .../assets/actions/av_traj_forward.json       |   0
 .../assets/actions/av_traj_left.json          |   0
 .../assets/actions/av_traj_right.json         |   0
 .../assets/actions/umi.json                   |   0
 .../data/chunk-000/file-000.parquet           | Bin
 .../meta/episodes/chunk-000/file-000.parquet  | Bin
 .../droid_lerobot_example/meta/info.json      |   0
 .../droid_lerobot_example/meta/tasks.parquet  | Bin
 .../chunk-000/file-000.mp4                    | Bin
 .../chunk-000/file-000.mp4                    | Bin
 .../chunk-000/file-000.mp4                    | Bin
 .../assets/images/av_0.jpg                    | Bin
 .../assets/images/av_1.jpg                    | Bin
 .../assets/images/umi.png                     | Bin
 .../assets/videos/av_0.mp4                    | Bin
 .../assets/videos/av_1.mp4                    | Bin
 .../assets/videos/robolab_example_rollout.mp4 | Bin
 .../assets/videos/umi.mp4                     | Bin
 .../run_fd_with_cosmos_framework.ipynb        |   0
 .../run_fd_with_vllm.ipynb                    |   0
 .../run_id_with_cosmos_framework.ipynb        |   0
 .../run_id_with_vllm.ipynb                    |   0
 .../run_policy_with_cosmos_framework.md       |   0
 .../cosmos3/generator/audiovisual/README.md   |  36 ++++++++-----
 .../assets/images/image2video/car_driving.jpg | Bin
 .../images/image2video/coastal_road_audio.jpg | Bin
 .../images/image2video/humanoid_robot.jpg     | Bin
 .../image2video/neg_prompt.json               |   0
 .../text2video/neg_prompt.json                |   0
 .../prompts/image2video/car_driving.json      |   0
 .../image2video/coastal_road_audio.json       |   0
 .../prompts/image2video/humanoid_robot.json   |   0
 .../prompts/text2image/robot_draping.json     |   0
 .../prompts/text2video/car_colliding.json     |   0
 .../prompts/text2video/robot_kitchen.json     |   0
 .../text2video/robot_pouring_water_audio.json |   0
 .../run_with_cosmos_framework.ipynb           |   0
 .../run_with_diffusers.ipynb                  |   0
 .../run_with_vllm_omni.ipynb                  |   0
 .../cosmos3/generator/transfer/README.md      |  46 ++++++++++------
 .../assets/blur/control_blur.mp4              | Bin
 .../assets/blur/prompt.json                   |   0
 .../assets/depth/control_depth.mp4            | Bin
 .../assets/depth/prompt.json                  |   0
 .../assets/edge/control_edge.mp4              | Bin
 .../assets/edge/prompt.json                   |   0
 .../assets/negative_prompt.json               |   0
 .../assets/seg/control_seg.mp4                | Bin
 .../assets/seg/prompt.json                    |   0
 .../assets/wsm/control_wsm.mp4                | Bin
 .../assets/wsm/prompt.json                    |   0
 .../{ => basic_examples}/preview_helpers.py   |   0
 ...video_transfer_with_cosmos_framework.ipynb |   0
 .../{ => basic_examples}/specs/blur.json      |   0
 .../{ => basic_examples}/specs/depth.json     |   0
 .../{ => basic_examples}/specs/edge.json      |   0
 .../{ => basic_examples}/specs/seg.json       |   0
 .../{ => basic_examples}/specs/wsm.json       |   0
 cookbooks/cosmos3/reasoner/README.md          |  33 ++++++++----
 .../assets/action_cot_driving_scene.mp4       | Bin
 .../assets/action_cot_trajectory.png          | Bin
 .../assets/assisted_task_next_action.mp4      | Bin
 .../assets/common_sense_reasoning.mp4         | Bin
 .../assets/describe_anything.png              | Bin
 .../assets/drive_scene_next_action.mp4        | Bin
 .../assets/grounding_2d.png                   | Bin
 .../assets/physical_plausibility.mp4          | Bin
 .../{ => basic_examples}/assets/robot_153.jpg | Bin
 .../assets/robot_planning.png                 | Bin
 .../assets/robotics_next_action.mp4           | Bin
 .../assets/situation_understanding.mp4        | Bin
 .../assets/temporal_localization_1.mp4        | Bin
 .../assets/temporal_localization_2.mp4        | Bin
 .../assets/video_caption.mp4                  | Bin
 .../reasoner_prompt_guide.md                  |   0
 .../run_with_cosmos_framework.ipynb           |   0
 .../{ => basic_examples}/run_with_nim.ipynb   |   0
 .../{ => basic_examples}/run_with_vllm.ipynb  |   0
 80 files changed, 134 insertions(+), 70 deletions(-)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/actions/av_traj_forward.json (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/actions/av_traj_left.json (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/actions/av_traj_right.json (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/actions/umi.json (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/droid_lerobot_example/data/chunk-000/file-000.parquet (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/droid_lerobot_example/meta/episodes/chunk-000/file-000.parquet (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/droid_lerobot_example/meta/info.json (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/droid_lerobot_example/meta/tasks.parquet (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/droid_lerobot_example/videos/observation.image.exterior_image_1_left/chunk-000/file-000.mp4 (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/droid_lerobot_example/videos/observation.image.exterior_image_2_left/chunk-000/file-000.mp4 (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/droid_lerobot_example/videos/observation.image.wrist_image_left/chunk-000/file-000.mp4 (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/images/av_0.jpg (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/images/av_1.jpg (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/images/umi.png (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/videos/av_0.mp4 (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/videos/av_1.mp4 (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/videos/robolab_example_rollout.mp4 (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/assets/videos/umi.mp4 (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/run_fd_with_cosmos_framework.ipynb (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/run_fd_with_vllm.ipynb (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/run_id_with_cosmos_framework.ipynb (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/run_id_with_vllm.ipynb (100%)
 rename cookbooks/cosmos3/generator/action/{ => basic_examples}/run_policy_with_cosmos_framework.md (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/images/image2video/car_driving.jpg (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/images/image2video/coastal_road_audio.jpg (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/images/image2video/humanoid_robot.jpg (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/negative_prompts/image2video/neg_prompt.json (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/negative_prompts/text2video/neg_prompt.json (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/prompts/image2video/car_driving.json (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/prompts/image2video/coastal_road_audio.json (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/prompts/image2video/humanoid_robot.json (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/prompts/text2image/robot_draping.json (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/prompts/text2video/car_colliding.json (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/prompts/text2video/robot_kitchen.json (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/assets/prompts/text2video/robot_pouring_water_audio.json (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/run_with_cosmos_framework.ipynb (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/run_with_diffusers.ipynb (100%)
 rename cookbooks/cosmos3/generator/audiovisual/{ => basic_examples}/run_with_vllm_omni.ipynb (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/blur/control_blur.mp4 (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/blur/prompt.json (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/depth/control_depth.mp4 (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/depth/prompt.json (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/edge/control_edge.mp4 (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/edge/prompt.json (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/negative_prompt.json (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/seg/control_seg.mp4 (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/seg/prompt.json (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/wsm/control_wsm.mp4 (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/assets/wsm/prompt.json (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/preview_helpers.py (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/run_video_transfer_with_cosmos_framework.ipynb (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/specs/blur.json (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/specs/depth.json (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/specs/edge.json (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/specs/seg.json (100%)
 rename cookbooks/cosmos3/generator/transfer/{ => basic_examples}/specs/wsm.json (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/action_cot_driving_scene.mp4 (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/action_cot_trajectory.png (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/assisted_task_next_action.mp4 (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/common_sense_reasoning.mp4 (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/describe_anything.png (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/drive_scene_next_action.mp4 (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/grounding_2d.png (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/physical_plausibility.mp4 (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/robot_153.jpg (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/robot_planning.png (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/robotics_next_action.mp4 (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/situation_understanding.mp4 (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/temporal_localization_1.mp4 (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/temporal_localization_2.mp4 (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/assets/video_caption.mp4 (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/reasoner_prompt_guide.md (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/run_with_cosmos_framework.ipynb (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/run_with_nim.ipynb (100%)
 rename cookbooks/cosmos3/reasoner/{ => basic_examples}/run_with_vllm.ipynb (100%)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 59669a89..48c67c1b 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -62,35 +62,46 @@ cookbooks/
     │
     ├── reasoner/                          # Reasoner Tower
     │   ├── README.md                      # Reasoner overview + backend table
-    │   ├── reasoner_prompt_guide.md       # Prompt engineering reference
-    │   ├── run_with_vllm.ipynb            # Cookbook: vLLM backend
-    │   ├── run_with_nim.ipynb             # Cookbook: NIM backend
-    │   ├── run_with_cosmos_framework.ipynb # Cookbook: Framework backend
-    │   └── assets/                        # Images, videos, sample outputs
+    │   ├── basic_examples/                # Shipped starter cookbooks
+    │   │   ├── reasoner_prompt_guide.md
+    │   │   ├── run_with_vllm.ipynb
+    │   │   ├── run_with_nim.ipynb
+    │   │   ├── run_with_cosmos_framework.ipynb
+    │   │   └── assets/
+    │   └── <your-cookbook>/                # ← Community contributions go here
+    │       ├── README.md
+    │       ├── run_<task>_with_<backend>.ipynb
+    │       └── assets/
     │
     └── generator/
         ├── audiovisual/                   # Generator: T2I, T2V, I2V, audio
         │   ├── README.md
-        │   ├── run_with_diffusers.ipynb
-        │   ├── run_with_vllm_omni.ipynb
-        │   ├── run_with_cosmos_framework.ipynb
-        │   └── assets/
+        │   ├── basic_examples/            # Shipped starter cookbooks
+        │   │   ├── run_with_diffusers.ipynb
+        │   │   ├── run_with_vllm_omni.ipynb
+        │   │   ├── run_with_cosmos_framework.ipynb
+        │   │   └── assets/
+        │   └── <your-cookbook>/            # ← Community contributions go here
         │
         ├── action/                        # Generator: policy, FDM, IDM
         │   ├── README.md
-        │   ├── run_fd_with_cosmos_framework.ipynb
-        │   ├── run_fd_with_vllm.ipynb
-        │   ├── run_id_with_cosmos_framework.ipynb
-        │   ├── run_id_with_vllm.ipynb
-        │   ├── run_policy_with_cosmos_framework.md
-        │   └── assets/
+        │   ├── basic_examples/            # Shipped starter cookbooks
+        │   │   ├── run_fd_with_cosmos_framework.ipynb
+        │   │   ├── run_fd_with_vllm.ipynb
+        │   │   ├── run_id_with_cosmos_framework.ipynb
+        │   │   ├── run_id_with_vllm.ipynb
+        │   │   ├── run_policy_with_cosmos_framework.md
+        │   │   └── assets/
+        │   └── <your-cookbook>/            # ← Community contributions go here
         │
         └── transfer/                      # Generator: video-to-video transfer
             ├── README.md
-            ├── run_video_transfer_with_cosmos_framework.ipynb
-            ├── preview_helpers.py
-            ├── specs/
-            └── assets/
+            ├── basic_examples/            # Shipped starter cookbooks
+            │   ├── run_video_transfer_with_cosmos_framework.ipynb
+            │   ├── preview_helpers.py
+            │   ├── specs/
+            │   └── assets/
+            └── <your-cookbook>/            # ← Community contributions go here
 ```
 
 ### Where Does My Cookbook Go?
diff --git a/cookbooks/cosmos3/generator/action/README.md b/cookbooks/cosmos3/generator/action/README.md
index 6158764f..e289f7e5 100644
--- a/cookbooks/cosmos3/generator/action/README.md
+++ b/cookbooks/cosmos3/generator/action/README.md
@@ -1,8 +1,24 @@
-# Cosmos3 Generator Action Examples
+# Cosmos3 Generator Action Cookbooks
 
-Cosmos3-Nano action-generation examples across two inference backends — native
-PyTorch (Cosmos Framework) and vLLM-Omni. Both backends use the sample assets
-under [`assets/`](./assets) and cover two tasks:
+Cosmos3-Nano action-generation cookbooks across two inference backends — native
+PyTorch (Cosmos Framework) and vLLM-Omni.
+
+## Basic Examples
+
+The [`basic_examples/`](./basic_examples/) directory contains the shipped starter
+cookbooks and sample assets. Community-contributed cookbooks are added as sibling
+directories alongside `basic_examples/` — see the
+[Contributing Guide](../../../../CONTRIBUTING.md) for the recipe structure.
+
+| Cookbook | Backend | Notebook |
+|---------|---------|----------|
+| Forward dynamics (AV, DROID, UMI) | Cosmos Framework | [`basic_examples/run_fd_with_cosmos_framework.ipynb`](./basic_examples/run_fd_with_cosmos_framework.ipynb) |
+| Inverse dynamics (AV) | Cosmos Framework | [`basic_examples/run_id_with_cosmos_framework.ipynb`](./basic_examples/run_id_with_cosmos_framework.ipynb) |
+| Policy (DROID) | Cosmos Framework | [`basic_examples/run_policy_with_cosmos_framework.md`](./basic_examples/run_policy_with_cosmos_framework.md) |
+| Forward dynamics (AV, DROID, UMI) | vLLM-Omni | [`basic_examples/run_fd_with_vllm.ipynb`](./basic_examples/run_fd_with_vllm.ipynb) |
+| Inverse dynamics (AV) | vLLM-Omni | [`basic_examples/run_id_with_vllm.ipynb`](./basic_examples/run_id_with_vllm.ipynb) |
+
+Both backends use the sample assets under [`basic_examples/assets/`](./basic_examples/assets/) and cover two tasks:
 
 - **Forward dynamics (`fd`)** — predict future observations from a start image
   plus an action trajectory (AV, DROID, and UMI robotics examples) using the Cosmos3-Nano.
@@ -68,7 +84,7 @@ torchrun --nproc-per-node=1 \
 
 The input spec pairs a start image with an action trajectory. The notebooks
 assemble ready-to-run specs for AV, DROID, and UMI examples from the checked-in
-assets under [`assets/`](./assets). Outputs are written under the framework
+assets under [`basic_examples/assets/`](./basic_examples/assets/). Outputs are written under the framework
 checkout.
 
 ### Cosmos Framework Walkthrough
@@ -76,11 +92,11 @@ checkout.
 The Cosmos Framework build their input spec, run inference, and
 visualize the generated videos:
 
-- [`run_fd_with_cosmos_framework.ipynb`](./run_fd_with_cosmos_framework.ipynb) —
+- [`run_fd_with_cosmos_framework.ipynb`](./basic_examples/run_fd_with_cosmos_framework.ipynb) —
   forward dynamics for AV, DROID, and UMI robotics examples using Cosmos3-Nano.
-- [`run_id_with_cosmos_framework.ipynb`](./run_id_with_cosmos_framework.ipynb) —
+- [`run_id_with_cosmos_framework.ipynb`](./basic_examples/run_id_with_cosmos_framework.ipynb) —
   inverse dynamics, predicting ego-motion trajectories from input AV videos using Cosmos3-Nano.
-- [`run_policy_with_cosmos_framework.md`](./run_policy_with_cosmos_framework.md) - policy, predicting future observations and action trajectories for DROID robot using Cosmos3-Nano-Policy-DROID.
+- [`run_policy_with_cosmos_framework.md`](./basic_examples/run_policy_with_cosmos_framework.md) - policy, predicting future observations and action trajectories for DROID robot using Cosmos3-Nano-Policy-DROID.
 
 
 ## Run with vLLM-Omni
@@ -100,8 +116,8 @@ curl http://localhost:8001/v1/models
 Forward-dynamics requests are multipart `POST`s to `/v1/videos` — a start image
 under `files={"input_reference": ...}` plus an `extra_params` payload carrying the
 action trajectory. The vLLM notebooks use these diffusion defaults for action
-generation (see [`run_fd_with_vllm.ipynb`](./run_fd_with_vllm.ipynb) and
-[`run_id_with_vllm.ipynb`](./run_id_with_vllm.ipynb)):
+generation (see [`run_fd_with_vllm.ipynb`](./basic_examples/run_fd_with_vllm.ipynb) and
+[`run_id_with_vllm.ipynb`](./basic_examples/run_id_with_vllm.ipynb)):
 
 | Field | Value |
 | --- | --- |
@@ -117,9 +133,9 @@ including autoregressive chunked generation for the robotics examples.
 The vLLM-Omni notebooks send requests through the OpenAI-compatible video API and
 write outputs under `outputs/cosmos3_action_vllm/`:
 
-- [`run_fd_with_vllm.ipynb`](./run_fd_with_vllm.ipynb) — forward dynamics for AV,
+- [`run_fd_with_vllm.ipynb`](./basic_examples/run_fd_with_vllm.ipynb) — forward dynamics for AV,
   DROID, and UMI robotics examples.
-- [`run_id_with_vllm.ipynb`](./run_id_with_vllm.ipynb) — inverse dynamics,
+- [`run_id_with_vllm.ipynb`](./basic_examples/run_id_with_vllm.ipynb) — inverse dynamics,
   predicting ego-motion trajectories from input AV videos.
 
 
diff --git a/cookbooks/cosmos3/generator/action/assets/actions/av_traj_forward.json b/cookbooks/cosmos3/generator/action/basic_examples/assets/actions/av_traj_forward.json
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/actions/av_traj_forward.json
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/actions/av_traj_forward.json
diff --git a/cookbooks/cosmos3/generator/action/assets/actions/av_traj_left.json b/cookbooks/cosmos3/generator/action/basic_examples/assets/actions/av_traj_left.json
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/actions/av_traj_left.json
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/actions/av_traj_left.json
diff --git a/cookbooks/cosmos3/generator/action/assets/actions/av_traj_right.json b/cookbooks/cosmos3/generator/action/basic_examples/assets/actions/av_traj_right.json
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/actions/av_traj_right.json
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/actions/av_traj_right.json
diff --git a/cookbooks/cosmos3/generator/action/assets/actions/umi.json b/cookbooks/cosmos3/generator/action/basic_examples/assets/actions/umi.json
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/actions/umi.json
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/actions/umi.json
diff --git a/cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/data/chunk-000/file-000.parquet b/cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/data/chunk-000/file-000.parquet
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/data/chunk-000/file-000.parquet
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/data/chunk-000/file-000.parquet
diff --git a/cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/meta/episodes/chunk-000/file-000.parquet b/cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/meta/episodes/chunk-000/file-000.parquet
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/meta/episodes/chunk-000/file-000.parquet
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/meta/episodes/chunk-000/file-000.parquet
diff --git a/cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/meta/info.json b/cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/meta/info.json
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/meta/info.json
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/meta/info.json
diff --git a/cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/meta/tasks.parquet b/cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/meta/tasks.parquet
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/meta/tasks.parquet
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/meta/tasks.parquet
diff --git a/cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/videos/observation.image.exterior_image_1_left/chunk-000/file-000.mp4 b/cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/videos/observation.image.exterior_image_1_left/chunk-000/file-000.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/videos/observation.image.exterior_image_1_left/chunk-000/file-000.mp4
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/videos/observation.image.exterior_image_1_left/chunk-000/file-000.mp4
diff --git a/cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/videos/observation.image.exterior_image_2_left/chunk-000/file-000.mp4 b/cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/videos/observation.image.exterior_image_2_left/chunk-000/file-000.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/videos/observation.image.exterior_image_2_left/chunk-000/file-000.mp4
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/videos/observation.image.exterior_image_2_left/chunk-000/file-000.mp4
diff --git a/cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/videos/observation.image.wrist_image_left/chunk-000/file-000.mp4 b/cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/videos/observation.image.wrist_image_left/chunk-000/file-000.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/droid_lerobot_example/videos/observation.image.wrist_image_left/chunk-000/file-000.mp4
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/droid_lerobot_example/videos/observation.image.wrist_image_left/chunk-000/file-000.mp4
diff --git a/cookbooks/cosmos3/generator/action/assets/images/av_0.jpg b/cookbooks/cosmos3/generator/action/basic_examples/assets/images/av_0.jpg
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/images/av_0.jpg
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/images/av_0.jpg
diff --git a/cookbooks/cosmos3/generator/action/assets/images/av_1.jpg b/cookbooks/cosmos3/generator/action/basic_examples/assets/images/av_1.jpg
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/images/av_1.jpg
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/images/av_1.jpg
diff --git a/cookbooks/cosmos3/generator/action/assets/images/umi.png b/cookbooks/cosmos3/generator/action/basic_examples/assets/images/umi.png
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/images/umi.png
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/images/umi.png
diff --git a/cookbooks/cosmos3/generator/action/assets/videos/av_0.mp4 b/cookbooks/cosmos3/generator/action/basic_examples/assets/videos/av_0.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/videos/av_0.mp4
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/videos/av_0.mp4
diff --git a/cookbooks/cosmos3/generator/action/assets/videos/av_1.mp4 b/cookbooks/cosmos3/generator/action/basic_examples/assets/videos/av_1.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/videos/av_1.mp4
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/videos/av_1.mp4
diff --git a/cookbooks/cosmos3/generator/action/assets/videos/robolab_example_rollout.mp4 b/cookbooks/cosmos3/generator/action/basic_examples/assets/videos/robolab_example_rollout.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/videos/robolab_example_rollout.mp4
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/videos/robolab_example_rollout.mp4
diff --git a/cookbooks/cosmos3/generator/action/assets/videos/umi.mp4 b/cookbooks/cosmos3/generator/action/basic_examples/assets/videos/umi.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/action/assets/videos/umi.mp4
rename to cookbooks/cosmos3/generator/action/basic_examples/assets/videos/umi.mp4
diff --git a/cookbooks/cosmos3/generator/action/run_fd_with_cosmos_framework.ipynb b/cookbooks/cosmos3/generator/action/basic_examples/run_fd_with_cosmos_framework.ipynb
similarity index 100%
rename from cookbooks/cosmos3/generator/action/run_fd_with_cosmos_framework.ipynb
rename to cookbooks/cosmos3/generator/action/basic_examples/run_fd_with_cosmos_framework.ipynb
diff --git a/cookbooks/cosmos3/generator/action/run_fd_with_vllm.ipynb b/cookbooks/cosmos3/generator/action/basic_examples/run_fd_with_vllm.ipynb
similarity index 100%
rename from cookbooks/cosmos3/generator/action/run_fd_with_vllm.ipynb
rename to cookbooks/cosmos3/generator/action/basic_examples/run_fd_with_vllm.ipynb
diff --git a/cookbooks/cosmos3/generator/action/run_id_with_cosmos_framework.ipynb b/cookbooks/cosmos3/generator/action/basic_examples/run_id_with_cosmos_framework.ipynb
similarity index 100%
rename from cookbooks/cosmos3/generator/action/run_id_with_cosmos_framework.ipynb
rename to cookbooks/cosmos3/generator/action/basic_examples/run_id_with_cosmos_framework.ipynb
diff --git a/cookbooks/cosmos3/generator/action/run_id_with_vllm.ipynb b/cookbooks/cosmos3/generator/action/basic_examples/run_id_with_vllm.ipynb
similarity index 100%
rename from cookbooks/cosmos3/generator/action/run_id_with_vllm.ipynb
rename to cookbooks/cosmos3/generator/action/basic_examples/run_id_with_vllm.ipynb
diff --git a/cookbooks/cosmos3/generator/action/run_policy_with_cosmos_framework.md b/cookbooks/cosmos3/generator/action/basic_examples/run_policy_with_cosmos_framework.md
similarity index 100%
rename from cookbooks/cosmos3/generator/action/run_policy_with_cosmos_framework.md
rename to cookbooks/cosmos3/generator/action/basic_examples/run_policy_with_cosmos_framework.md
diff --git a/cookbooks/cosmos3/generator/audiovisual/README.md b/cookbooks/cosmos3/generator/audiovisual/README.md
index d80adad4..fbe388f4 100644
--- a/cookbooks/cosmos3/generator/audiovisual/README.md
+++ b/cookbooks/cosmos3/generator/audiovisual/README.md
@@ -1,14 +1,26 @@
-# Cosmos3 Generator Audiovisual Examples
+# Cosmos3 Generator Audiovisual Cookbooks
 
 Generate images and video (with optional audio) from text or image prompts with
-`Cosmos3-Nano` and `Cosmos3-Super`, across three inference backends. Sample
-prompts live under [`assets/`](./assets).
+`Cosmos3-Nano` and `Cosmos3-Super`, across three inference backends.
 
 Environment setup for every backend is centralized in the shared
 [Cosmos3 cookbooks environment setup](../../README.md) guide; each backend below
 links to the section you need. The quickstarts are minimal text-to-video examples
 to get one generation running per backend — run them from this folder.
 
+## Basic Examples
+
+The [`basic_examples/`](./basic_examples/) directory contains the shipped starter
+cookbooks and sample prompts. Community-contributed cookbooks are added as sibling
+directories alongside `basic_examples/` — see the
+[Contributing Guide](../../../../CONTRIBUTING.md) for the recipe structure.
+
+| Cookbook | Backend | Notebook |
+|---------|---------|----------|
+| T2I / T2V / I2V + audio | Cosmos Framework | [`basic_examples/run_with_cosmos_framework.ipynb`](./basic_examples/run_with_cosmos_framework.ipynb) |
+| T2I / T2V / I2V + audio | Diffusers | [`basic_examples/run_with_diffusers.ipynb`](./basic_examples/run_with_diffusers.ipynb) |
+| T2I / T2V / I2V + audio | vLLM-Omni | [`basic_examples/run_with_vllm_omni.ipynb`](./basic_examples/run_with_vllm_omni.ipynb) |
+
 Generator requires the Guardrail. Request access to the gated
 [nvidia/Cosmos-1.0-Guardrail](https://huggingface.co/nvidia/Cosmos-1.0-Guardrail)
 HF repository before running these examples. To disable the guardrail, set
@@ -31,12 +43,12 @@ import json
 from pathlib import Path
 
 prompt = json.dumps(
-    json.load(open("assets/prompts/text2video/robot_kitchen.json")),
+    json.load(open("basic_examples/assets/prompts/text2video/robot_kitchen.json")),
     ensure_ascii=True,
     separators=(",", ":"),
 )
 negative = json.dumps(
-    json.load(open("assets/negative_prompts/text2video/neg_prompt.json")),
+    json.load(open("basic_examples/assets/negative_prompts/text2video/neg_prompt.json")),
     ensure_ascii=True,
     separators=(",", ":"),
 )
@@ -72,7 +84,7 @@ more GPUs via `--nproc-per-node`.
 
 ### Notebook walkthrough
 
-[`run_with_cosmos_framework.ipynb`](./run_with_cosmos_framework.ipynb) is the full
+[`run_with_cosmos_framework.ipynb`](./basic_examples/run_with_cosmos_framework.ipynb) is the full
 tutorial for the native PyTorch backend: it covers every use case — text-to-image,
 text-to-video, image-to-video, with audio on or off — and includes the detailed,
 environment-aware setup and visualization for each generation.
@@ -91,8 +103,8 @@ from diffusers import Cosmos3OmniPipeline
 from diffusers.schedulers.scheduling_unipc_multistep import UniPCMultistepScheduler
 from diffusers.utils import export_to_video
 
-prompt = json.load(open("assets/prompts/text2video/robot_kitchen.json"))
-negative = json.load(open("assets/negative_prompts/text2video/neg_prompt.json"))
+prompt = json.load(open("basic_examples/assets/prompts/text2video/robot_kitchen.json"))
+negative = json.load(open("basic_examples/assets/negative_prompts/text2video/neg_prompt.json"))
 
 pipe = Cosmos3OmniPipeline.from_pretrained(
     "nvidia/Cosmos3-Nano", torch_dtype=torch.bfloat16, device_map="cuda"
@@ -122,7 +134,7 @@ To run **Cosmos3-Super** instead, load the larger checkpoint:
 
 ### Notebook walkthrough
 
-[`run_with_diffusers.ipynb`](./run_with_diffusers.ipynb) is the full tutorial for
+[`run_with_diffusers.ipynb`](./basic_examples/run_with_diffusers.ipynb) is the full tutorial for
 the Diffusers backend: it provisions a dedicated venv, then walks through
 text-to-image, text-to-video, and image-to-video generation (with and without
 audio) using `Cosmos3OmniPipeline`, including how to preview the generated media.
@@ -145,8 +157,8 @@ from pathlib import Path
 
 import requests
 
-prompt = json.load(open("assets/prompts/text2video/robot_kitchen.json"))
-negative = json.load(open("assets/negative_prompts/text2video/neg_prompt.json"))
+prompt = json.load(open("basic_examples/assets/prompts/text2video/robot_kitchen.json"))
+negative = json.load(open("basic_examples/assets/negative_prompts/text2video/neg_prompt.json"))
 
 response = requests.post(
     "http://localhost:8000/v1/videos/sync",
@@ -179,7 +191,7 @@ For image-to-video, post to the same endpoint with an image under
 
 ### Notebook walkthrough
 
-[`run_with_vllm_omni.ipynb`](./run_with_vllm_omni.ipynb) is the full tutorial for
+[`run_with_vllm_omni.ipynb`](./basic_examples/run_with_vllm_omni.ipynb) is the full tutorial for
 the vLLM-Omni backend: it walks through text-to-image, text-to-video, and
 image-to-video requests with audio on or off. Server launch options (Nano and
 Super, tensor parallelism, layerwise offload, and CFG-parallel variants) live in
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/images/image2video/car_driving.jpg b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/images/image2video/car_driving.jpg
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/images/image2video/car_driving.jpg
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/images/image2video/car_driving.jpg
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/images/image2video/coastal_road_audio.jpg b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/images/image2video/coastal_road_audio.jpg
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/images/image2video/coastal_road_audio.jpg
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/images/image2video/coastal_road_audio.jpg
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/images/image2video/humanoid_robot.jpg b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/images/image2video/humanoid_robot.jpg
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/images/image2video/humanoid_robot.jpg
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/images/image2video/humanoid_robot.jpg
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/negative_prompts/image2video/neg_prompt.json b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/negative_prompts/image2video/neg_prompt.json
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/negative_prompts/image2video/neg_prompt.json
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/negative_prompts/image2video/neg_prompt.json
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/negative_prompts/text2video/neg_prompt.json b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/negative_prompts/text2video/neg_prompt.json
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/negative_prompts/text2video/neg_prompt.json
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/negative_prompts/text2video/neg_prompt.json
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/prompts/image2video/car_driving.json b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/image2video/car_driving.json
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/prompts/image2video/car_driving.json
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/image2video/car_driving.json
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/prompts/image2video/coastal_road_audio.json b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/image2video/coastal_road_audio.json
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/prompts/image2video/coastal_road_audio.json
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/image2video/coastal_road_audio.json
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/prompts/image2video/humanoid_robot.json b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/image2video/humanoid_robot.json
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/prompts/image2video/humanoid_robot.json
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/image2video/humanoid_robot.json
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/prompts/text2image/robot_draping.json b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/text2image/robot_draping.json
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/prompts/text2image/robot_draping.json
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/text2image/robot_draping.json
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/prompts/text2video/car_colliding.json b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/text2video/car_colliding.json
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/prompts/text2video/car_colliding.json
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/text2video/car_colliding.json
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/prompts/text2video/robot_kitchen.json b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/text2video/robot_kitchen.json
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/prompts/text2video/robot_kitchen.json
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/text2video/robot_kitchen.json
diff --git a/cookbooks/cosmos3/generator/audiovisual/assets/prompts/text2video/robot_pouring_water_audio.json b/cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/text2video/robot_pouring_water_audio.json
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/assets/prompts/text2video/robot_pouring_water_audio.json
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/assets/prompts/text2video/robot_pouring_water_audio.json
diff --git a/cookbooks/cosmos3/generator/audiovisual/run_with_cosmos_framework.ipynb b/cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_cosmos_framework.ipynb
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/run_with_cosmos_framework.ipynb
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_cosmos_framework.ipynb
diff --git a/cookbooks/cosmos3/generator/audiovisual/run_with_diffusers.ipynb b/cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_diffusers.ipynb
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/run_with_diffusers.ipynb
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_diffusers.ipynb
diff --git a/cookbooks/cosmos3/generator/audiovisual/run_with_vllm_omni.ipynb b/cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_vllm_omni.ipynb
similarity index 100%
rename from cookbooks/cosmos3/generator/audiovisual/run_with_vllm_omni.ipynb
rename to cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_vllm_omni.ipynb
diff --git a/cookbooks/cosmos3/generator/transfer/README.md b/cookbooks/cosmos3/generator/transfer/README.md
index 0c477056..8c849185 100644
--- a/cookbooks/cosmos3/generator/transfer/README.md
+++ b/cookbooks/cosmos3/generator/transfer/README.md
@@ -1,7 +1,19 @@
-# Cosmos3 Generator Transfer Examples
+# Cosmos3 Generator Transfer Cookbooks
 
-Cosmos3-Nano video **transfer** examples on the native PyTorch (Cosmos Framework) path.
-Sample assets under [`assets/`](./assets) cover spatial control signals paired with
+Cosmos3-Nano video **transfer** cookbooks on the native PyTorch (Cosmos Framework) path.
+
+## Basic Examples
+
+The [`basic_examples/`](./basic_examples/) directory contains the shipped starter
+cookbook and sample assets. Community-contributed cookbooks are added as sibling
+directories alongside `basic_examples/` — see the
+[Contributing Guide](../../../../CONTRIBUTING.md) for the recipe structure.
+
+| Cookbook | Backend | Notebook |
+|---------|---------|----------|
+| Video transfer (edge, blur, depth, seg, wsm) | Cosmos Framework | [`basic_examples/run_video_transfer_with_cosmos_framework.ipynb`](./basic_examples/run_video_transfer_with_cosmos_framework.ipynb) |
+
+Sample assets under [`basic_examples/assets/`](./basic_examples/assets/) cover spatial control signals paired with
 `prompt.json` files:
 
 - **Edge (Canny)** — edge map control plus caption.
@@ -26,11 +38,11 @@ come from the control video; see the spec field reference for how `fps` and
 
 | Control | Asset folder | Inference input | Generation duration |
 | --- | --- | --- | --- |
-| Edge (Canny) | `assets/edge/` | `control_edge.mp4` + `prompt.json` | 121 frames @ 30 FPS |
-| Blur | `assets/blur/` | `control_blur.mp4` + `prompt.json` | 121 frames @ 30 FPS |
-| Depth | `assets/depth/` | `control_depth.mp4` + `prompt.json` | 121 frames @ 30 FPS |
-| Segmentation | `assets/seg/` | `control_seg.mp4` + `prompt.json` | 121 frames @ 30 FPS |
-| World scenario (WSM) | `assets/wsm/` | `control_wsm.mp4` + `prompt.json` | 101 frames @ 10 FPS |
+| Edge (Canny) | `basic_examples/assets/edge/` | `control_edge.mp4` + `prompt.json` | 121 frames @ 30 FPS |
+| Blur | `basic_examples/assets/blur/` | `control_blur.mp4` + `prompt.json` | 121 frames @ 30 FPS |
+| Depth | `basic_examples/assets/depth/` | `control_depth.mp4` + `prompt.json` | 121 frames @ 30 FPS |
+| Segmentation | `basic_examples/assets/seg/` | `control_seg.mp4` + `prompt.json` | 121 frames @ 30 FPS |
+| World scenario (WSM) | `basic_examples/assets/wsm/` | `control_wsm.mp4` + `prompt.json` | 101 frames @ 10 FPS |
 
 Transfer inference is selected automatically when any hint key is present in the spec.
 
@@ -40,7 +52,7 @@ Transfer inference is selected automatically when any hint key is present in the
 
 Set up the environment: [Cosmos Framework setup](../../README.md#cosmos-framework).
 Activate the framework venv, then run inference (checked-in `specs/*.json` use paths
-relative to `specs/`). Transfer on Nano looks like:
+relative to `basic_examples/specs/`). Transfer on Nano looks like:
 
 ```bash
 cd cookbooks/cosmos3/generator/transfer
@@ -49,7 +61,7 @@ cd cookbooks/cosmos3/generator/transfer
 torchrun --nproc-per-node=1 \
   -m cosmos_framework.scripts.inference \
   --parallelism-preset=latency \
-  -i specs/edge.json \
+  -i basic_examples/specs/edge.json \
   -o ./output/ \
   --checkpoint-path Cosmos3-Nano \
   --seed 2026
@@ -58,7 +70,7 @@ torchrun --nproc-per-node=1 \
 torchrun --nproc-per-node=1 \
   -m cosmos_framework.scripts.inference \
   --parallelism-preset=latency \
-  -i specs/blur.json \
+  -i basic_examples/specs/blur.json \
   -o ./output/ \
   --checkpoint-path Cosmos3-Nano \
   --seed 2026
@@ -67,7 +79,7 @@ torchrun --nproc-per-node=1 \
 torchrun --nproc-per-node=1 \
   -m cosmos_framework.scripts.inference \
   --parallelism-preset=latency \
-  -i specs/depth.json \
+  -i basic_examples/specs/depth.json \
   -o ./output/ \
   --checkpoint-path Cosmos3-Nano \
   --seed 2026
@@ -76,7 +88,7 @@ torchrun --nproc-per-node=1 \
 torchrun --nproc-per-node=1 \
   -m cosmos_framework.scripts.inference \
   --parallelism-preset=latency \
-  -i specs/seg.json \
+  -i basic_examples/specs/seg.json \
   -o ./output/ \
   --checkpoint-path Cosmos3-Nano \
   --seed 2026
@@ -85,14 +97,14 @@ torchrun --nproc-per-node=1 \
 torchrun --nproc-per-node=1 \
   -m cosmos_framework.scripts.inference \
   --parallelism-preset=latency \
-  -i specs/wsm.json \
+  -i basic_examples/specs/wsm.json \
   -o ./output/ \
   --checkpoint-path Cosmos3-Nano \
   --seed 2026
 ```
 
 The input spec sets `prompt_path` and a hint block with `control_path` pointing at the
-checked-in assets under [`assets/`](./assets) via paths relative to [`specs/`](./specs).
+checked-in assets under [`basic_examples/assets/`](./basic_examples/assets/) via paths relative to [`basic_examples/specs/`](./basic_examples/specs/).
 
 Outputs are written under the directory passed to `-o`, with one subdirectory per sample name,
 for example `output/transfer_edge/vision.mp4`. Batch size must be 1 for transfer.
@@ -137,10 +149,10 @@ Key fields:
 
 ### Cookbook entrypoints
 
-- [`run_video_transfer_with_cosmos_framework.ipynb`](./run_video_transfer_with_cosmos_framework.ipynb) —
+- [`run_video_transfer_with_cosmos_framework.ipynb`](./basic_examples/run_video_transfer_with_cosmos_framework.ipynb) —
   full tutorial on a **GPU host**: environment setup, `nvidia-smi` check, then five inference blocks
   (edge, blur, depth, seg, wsm) with previews. See [Cosmos3 environment setup](../../README.md).
-- [`specs/`](./specs) — checked-in Framework input JSON per control (paths relative to `specs/`).
+- [`basic_examples/specs/`](./basic_examples/specs/) — checked-in Framework input JSON per control (paths relative to `basic_examples/specs/`).
 
 ### Troubleshooting
 
diff --git a/cookbooks/cosmos3/generator/transfer/assets/blur/control_blur.mp4 b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/blur/control_blur.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/blur/control_blur.mp4
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/blur/control_blur.mp4
diff --git a/cookbooks/cosmos3/generator/transfer/assets/blur/prompt.json b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/blur/prompt.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/blur/prompt.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/blur/prompt.json
diff --git a/cookbooks/cosmos3/generator/transfer/assets/depth/control_depth.mp4 b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/depth/control_depth.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/depth/control_depth.mp4
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/depth/control_depth.mp4
diff --git a/cookbooks/cosmos3/generator/transfer/assets/depth/prompt.json b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/depth/prompt.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/depth/prompt.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/depth/prompt.json
diff --git a/cookbooks/cosmos3/generator/transfer/assets/edge/control_edge.mp4 b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/edge/control_edge.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/edge/control_edge.mp4
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/edge/control_edge.mp4
diff --git a/cookbooks/cosmos3/generator/transfer/assets/edge/prompt.json b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/edge/prompt.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/edge/prompt.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/edge/prompt.json
diff --git a/cookbooks/cosmos3/generator/transfer/assets/negative_prompt.json b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/negative_prompt.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/negative_prompt.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/negative_prompt.json
diff --git a/cookbooks/cosmos3/generator/transfer/assets/seg/control_seg.mp4 b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/seg/control_seg.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/seg/control_seg.mp4
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/seg/control_seg.mp4
diff --git a/cookbooks/cosmos3/generator/transfer/assets/seg/prompt.json b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/seg/prompt.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/seg/prompt.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/seg/prompt.json
diff --git a/cookbooks/cosmos3/generator/transfer/assets/wsm/control_wsm.mp4 b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/wsm/control_wsm.mp4
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/wsm/control_wsm.mp4
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/wsm/control_wsm.mp4
diff --git a/cookbooks/cosmos3/generator/transfer/assets/wsm/prompt.json b/cookbooks/cosmos3/generator/transfer/basic_examples/assets/wsm/prompt.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/assets/wsm/prompt.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/assets/wsm/prompt.json
diff --git a/cookbooks/cosmos3/generator/transfer/preview_helpers.py b/cookbooks/cosmos3/generator/transfer/basic_examples/preview_helpers.py
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/preview_helpers.py
rename to cookbooks/cosmos3/generator/transfer/basic_examples/preview_helpers.py
diff --git a/cookbooks/cosmos3/generator/transfer/run_video_transfer_with_cosmos_framework.ipynb b/cookbooks/cosmos3/generator/transfer/basic_examples/run_video_transfer_with_cosmos_framework.ipynb
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/run_video_transfer_with_cosmos_framework.ipynb
rename to cookbooks/cosmos3/generator/transfer/basic_examples/run_video_transfer_with_cosmos_framework.ipynb
diff --git a/cookbooks/cosmos3/generator/transfer/specs/blur.json b/cookbooks/cosmos3/generator/transfer/basic_examples/specs/blur.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/specs/blur.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/specs/blur.json
diff --git a/cookbooks/cosmos3/generator/transfer/specs/depth.json b/cookbooks/cosmos3/generator/transfer/basic_examples/specs/depth.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/specs/depth.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/specs/depth.json
diff --git a/cookbooks/cosmos3/generator/transfer/specs/edge.json b/cookbooks/cosmos3/generator/transfer/basic_examples/specs/edge.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/specs/edge.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/specs/edge.json
diff --git a/cookbooks/cosmos3/generator/transfer/specs/seg.json b/cookbooks/cosmos3/generator/transfer/basic_examples/specs/seg.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/specs/seg.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/specs/seg.json
diff --git a/cookbooks/cosmos3/generator/transfer/specs/wsm.json b/cookbooks/cosmos3/generator/transfer/basic_examples/specs/wsm.json
similarity index 100%
rename from cookbooks/cosmos3/generator/transfer/specs/wsm.json
rename to cookbooks/cosmos3/generator/transfer/basic_examples/specs/wsm.json
diff --git a/cookbooks/cosmos3/reasoner/README.md b/cookbooks/cosmos3/reasoner/README.md
index b3d3542d..3718e45a 100644
--- a/cookbooks/cosmos3/reasoner/README.md
+++ b/cookbooks/cosmos3/reasoner/README.md
@@ -1,15 +1,28 @@
-# Cosmos3 Reasoner Examples
+# Cosmos3 Reasoner Cookbooks
 
 Run the Cosmos3 Reasoner (vision-language reasoning over images and video) across
-multiple inference backends. Sample inputs live under [`assets/`](./assets).
+multiple inference backends.
 
 Environment setup for every backend is centralized in the shared
 [Cosmos3 cookbooks environment setup](../README.md) guide; each backend below
 links to the section you need.
 
+## Basic Examples
+
+The [`basic_examples/`](./basic_examples/) directory contains the shipped starter
+cookbooks and sample inputs. Community-contributed cookbooks are added as sibling
+directories alongside `basic_examples/` — see the
+[Contributing Guide](../../../CONTRIBUTING.md) for the recipe structure.
+
+| Cookbook | Backend | Notebook |
+|---------|---------|----------|
+| Reasoner inference | Cosmos Framework | [`basic_examples/run_with_cosmos_framework.ipynb`](./basic_examples/run_with_cosmos_framework.ipynb) |
+| Reasoner inference | vLLM | [`basic_examples/run_with_vllm.ipynb`](./basic_examples/run_with_vllm.ipynb) |
+| Reasoner inference | NIM | [`basic_examples/run_with_nim.ipynb`](./basic_examples/run_with_nim.ipynb) |
+
 ## Reasoner Prompt Guide
 
-See the [Reasoner Prompt Guide](./reasoner_prompt_guide.md).
+See the [Reasoner Prompt Guide](./basic_examples/reasoner_prompt_guide.md).
 
 ## Run with Cosmos Framework
 
@@ -29,7 +42,7 @@ cat > outputs/cookbooks/cosmos3/reasoner/inputs/robot_image.json <<'JSON'
   "model_mode": "reasoner",
   "name": "robot_image",
   "prompt": "Describe what is happening in this image in one sentence.",
-  "vision_path": "../../cookbooks/cosmos3/reasoner/assets/robot_153.jpg",
+  "vision_path": "../../cookbooks/cosmos3/reasoner/basic_examples/assets/robot_153.jpg",
   "enable_sound": false
 }
 JSON
@@ -54,7 +67,7 @@ The generated text is written to
 
 ### Notebook walkthrough
 
-[`run_with_cosmos_framework.ipynb`](./run_with_cosmos_framework.ipynb) is the full
+[`run_with_cosmos_framework.ipynb`](./basic_examples/run_with_cosmos_framework.ipynb) is the full
 tutorial. It writes text and image smoke tests, then walks through image
 capability sections — detailed captioning, robot task planning, 2D grounding,
 describe-anything, and action-trajectory prompts — rendering the prompt, media
@@ -73,7 +86,7 @@ Set up the environment and start the server:
 [Start the server](../README.md#start-the-server) (launch commands).
 
 The quickstart below uses **Cosmos3-Nano** on port 8000. The
-[`run_with_vllm.ipynb`](./run_with_vllm.ipynb) notebook defaults to
+[`run_with_vllm.ipynb`](./basic_examples/run_with_vllm.ipynb) notebook defaults to
 **Cosmos3-Super** on port **8001** — use that launch command from the env setup
 guide and point the client at `http://localhost:8001/v1`.
 
@@ -83,7 +96,7 @@ Once the server is ready, query it with the OpenAI client:
 from pathlib import Path
 import openai
 
-image_path = Path("assets/robot_153.jpg").resolve()
+image_path = Path("basic_examples/assets/robot_153.jpg").resolve()
 image_url = image_path.as_uri()
 
 client = openai.OpenAI(api_key="EMPTY", base_url="http://localhost:8000/v1")
@@ -108,7 +121,7 @@ print(response.choices[0].message.content)
 
 ### Notebook walkthrough
 
-[`run_with_vllm.ipynb`](./run_with_vllm.ipynb) uses the **Cosmos3-Super** launch
+[`run_with_vllm.ipynb`](./basic_examples/run_with_vllm.ipynb) uses the **Cosmos3-Super** launch
 from the [environment setup guide](../README.md#start-the-server) and walks
 through many more image and video examples: detailed captioning,
 VQA, temporal localization, embodied reasoning, common-sense reasoning, 2D
@@ -138,7 +151,7 @@ import mimetypes
 from pathlib import Path
 import openai
 
-image_path = Path("assets/robot_153.jpg").resolve()
+image_path = Path("basic_examples/assets/robot_153.jpg").resolve()
 mime = mimetypes.guess_type(image_path.name)[0] or "application/octet-stream"
 image_url = f"data:{mime};base64,{base64.b64encode(image_path.read_bytes()).decode('ascii')}"
 
@@ -170,7 +183,7 @@ for the full request reference.
 
 ### Notebook walkthrough
 
-[`run_with_nim.ipynb`](./run_with_nim.ipynb) is the NIM counterpart to the vLLM
+[`run_with_nim.ipynb`](./basic_examples/run_with_nim.ipynb) is the NIM counterpart to the vLLM
 notebook: it launches the NIM container, waits for readiness, and then runs the
 same image and video examples — detailed captioning, VQA, temporal localization,
 embodied reasoning, common-sense reasoning, 2D grounding, describe-anything,
diff --git a/cookbooks/cosmos3/reasoner/assets/action_cot_driving_scene.mp4 b/cookbooks/cosmos3/reasoner/basic_examples/assets/action_cot_driving_scene.mp4
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/action_cot_driving_scene.mp4
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/action_cot_driving_scene.mp4
diff --git a/cookbooks/cosmos3/reasoner/assets/action_cot_trajectory.png b/cookbooks/cosmos3/reasoner/basic_examples/assets/action_cot_trajectory.png
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/action_cot_trajectory.png
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/action_cot_trajectory.png
diff --git a/cookbooks/cosmos3/reasoner/assets/assisted_task_next_action.mp4 b/cookbooks/cosmos3/reasoner/basic_examples/assets/assisted_task_next_action.mp4
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/assisted_task_next_action.mp4
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/assisted_task_next_action.mp4
diff --git a/cookbooks/cosmos3/reasoner/assets/common_sense_reasoning.mp4 b/cookbooks/cosmos3/reasoner/basic_examples/assets/common_sense_reasoning.mp4
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/common_sense_reasoning.mp4
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/common_sense_reasoning.mp4
diff --git a/cookbooks/cosmos3/reasoner/assets/describe_anything.png b/cookbooks/cosmos3/reasoner/basic_examples/assets/describe_anything.png
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/describe_anything.png
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/describe_anything.png
diff --git a/cookbooks/cosmos3/reasoner/assets/drive_scene_next_action.mp4 b/cookbooks/cosmos3/reasoner/basic_examples/assets/drive_scene_next_action.mp4
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/drive_scene_next_action.mp4
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/drive_scene_next_action.mp4
diff --git a/cookbooks/cosmos3/reasoner/assets/grounding_2d.png b/cookbooks/cosmos3/reasoner/basic_examples/assets/grounding_2d.png
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/grounding_2d.png
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/grounding_2d.png
diff --git a/cookbooks/cosmos3/reasoner/assets/physical_plausibility.mp4 b/cookbooks/cosmos3/reasoner/basic_examples/assets/physical_plausibility.mp4
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/physical_plausibility.mp4
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/physical_plausibility.mp4
diff --git a/cookbooks/cosmos3/reasoner/assets/robot_153.jpg b/cookbooks/cosmos3/reasoner/basic_examples/assets/robot_153.jpg
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/robot_153.jpg
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/robot_153.jpg
diff --git a/cookbooks/cosmos3/reasoner/assets/robot_planning.png b/cookbooks/cosmos3/reasoner/basic_examples/assets/robot_planning.png
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/robot_planning.png
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/robot_planning.png
diff --git a/cookbooks/cosmos3/reasoner/assets/robotics_next_action.mp4 b/cookbooks/cosmos3/reasoner/basic_examples/assets/robotics_next_action.mp4
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/robotics_next_action.mp4
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/robotics_next_action.mp4
diff --git a/cookbooks/cosmos3/reasoner/assets/situation_understanding.mp4 b/cookbooks/cosmos3/reasoner/basic_examples/assets/situation_understanding.mp4
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/situation_understanding.mp4
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/situation_understanding.mp4
diff --git a/cookbooks/cosmos3/reasoner/assets/temporal_localization_1.mp4 b/cookbooks/cosmos3/reasoner/basic_examples/assets/temporal_localization_1.mp4
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/temporal_localization_1.mp4
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/temporal_localization_1.mp4
diff --git a/cookbooks/cosmos3/reasoner/assets/temporal_localization_2.mp4 b/cookbooks/cosmos3/reasoner/basic_examples/assets/temporal_localization_2.mp4
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/temporal_localization_2.mp4
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/temporal_localization_2.mp4
diff --git a/cookbooks/cosmos3/reasoner/assets/video_caption.mp4 b/cookbooks/cosmos3/reasoner/basic_examples/assets/video_caption.mp4
similarity index 100%
rename from cookbooks/cosmos3/reasoner/assets/video_caption.mp4
rename to cookbooks/cosmos3/reasoner/basic_examples/assets/video_caption.mp4
diff --git a/cookbooks/cosmos3/reasoner/reasoner_prompt_guide.md b/cookbooks/cosmos3/reasoner/basic_examples/reasoner_prompt_guide.md
similarity index 100%
rename from cookbooks/cosmos3/reasoner/reasoner_prompt_guide.md
rename to cookbooks/cosmos3/reasoner/basic_examples/reasoner_prompt_guide.md
diff --git a/cookbooks/cosmos3/reasoner/run_with_cosmos_framework.ipynb b/cookbooks/cosmos3/reasoner/basic_examples/run_with_cosmos_framework.ipynb
similarity index 100%
rename from cookbooks/cosmos3/reasoner/run_with_cosmos_framework.ipynb
rename to cookbooks/cosmos3/reasoner/basic_examples/run_with_cosmos_framework.ipynb
diff --git a/cookbooks/cosmos3/reasoner/run_with_nim.ipynb b/cookbooks/cosmos3/reasoner/basic_examples/run_with_nim.ipynb
similarity index 100%
rename from cookbooks/cosmos3/reasoner/run_with_nim.ipynb
rename to cookbooks/cosmos3/reasoner/basic_examples/run_with_nim.ipynb
diff --git a/cookbooks/cosmos3/reasoner/run_with_vllm.ipynb b/cookbooks/cosmos3/reasoner/basic_examples/run_with_vllm.ipynb
similarity index 100%
rename from cookbooks/cosmos3/reasoner/run_with_vllm.ipynb
rename to cookbooks/cosmos3/reasoner/basic_examples/run_with_vllm.ipynb

From 6502b16dab4e8a04f077ee0a14b298625ba1700a Mon Sep 17 00:00:00 2001
From: paularamo <pjramg@gmail.com>
Date: Mon, 15 Jun 2026 14:27:34 -0400
Subject: [PATCH 3/4] Update README.md and cookbooks setup README for
 basic_examples/ paths

Fix all notebook links, nbviewer URLs, and asset paths in the main
README.md Examples table (11 entries) and the NIM curl example to
reference the new basic_examples/ subdirectories. Also update the
cookbooks/cosmos3/README.md vLLM server section to point at the
relocated run_with_vllm.ipynb.

(cherry picked from commit 669ba5c53c1990f9a37cff2e246aa04a93d138dd)
---
 README.md                   | 24 ++++++++++++------------
 cookbooks/cosmos3/README.md |  4 ++--
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index d54eaa07..a788f1a0 100644
--- a/README.md
+++ b/README.md
@@ -522,7 +522,7 @@ docker run -it --rm --name=$CONTAINER_NAME \
 The OpenAI-compatible API is then available at `http://127.0.0.1:8000/v1`. Query it with `curl`:
 
 ```shell
-IMAGE_DATA_URI="data:image/jpeg;base64,$(base64 -w 0 cookbooks/cosmos3/reasoner/assets/robot_153.jpg)"
+IMAGE_DATA_URI="data:image/jpeg;base64,$(base64 -w 0 cookbooks/cosmos3/reasoner/basic_examples/assets/robot_153.jpg)"
 
 curl -X POST 'http://127.0.0.1:8000/v1/chat/completions' \
   -H 'Accept: application/json' \
@@ -631,17 +631,17 @@ We are building examples that show Cosmos 3 capabilities end to end, including w
 
 | Example | Surface | Workflows demonstrated | Open | nbviewer |
 | --- | --- | --- | --- | --- |
-| Generator (audiovisual) with Diffusers | Generator | Text-to-image, plus text-to-video and image-to-video each with or without synchronized sound, via `Cosmos3OmniPipeline`. | [Notebook](cookbooks/cosmos3/generator/audiovisual/run_with_diffusers.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/audiovisual/run_with_diffusers.ipynb) |
-| Generator (audiovisual) with Cosmos Framework | Generator | Text-to-image, plus text-to-video and image-to-video each with sound on or off, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/generator/audiovisual/run_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/audiovisual/run_with_cosmos_framework.ipynb) |
-| Generator (audiovisual) with vLLM-Omni | Generator | Text-to-image, plus text-to-video and image-to-video each with sound on or off, against an OpenAI-compatible vLLM-Omni server. | [Notebook](cookbooks/cosmos3/generator/audiovisual/run_with_vllm_omni.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/audiovisual/run_with_vllm_omni.ipynb) |
-| Forward dynamics with Cosmos Framework | Generator | Forward dynamics: action-conditioned future-observation prediction for AV, DROID, and UMI, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/generator/action/run_fd_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/action/run_fd_with_cosmos_framework.ipynb) |
-| Forward dynamics with vLLM-Omni | Generator | Forward dynamics: action-conditioned future-observation prediction for AV, DROID, and UMI, against an OpenAI-compatible vLLM-Omni server. | [Notebook](cookbooks/cosmos3/generator/action/run_fd_with_vllm.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/action/run_fd_with_vllm.ipynb) |
-| Inverse dynamics with Cosmos Framework | Generator | Inverse dynamics: ego-motion trajectory prediction from input AV video, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/generator/action/run_id_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/action/run_id_with_cosmos_framework.ipynb) |
-| Inverse dynamics with vLLM-Omni | Generator | Inverse dynamics: ego-motion trajectory prediction from input AV video, against an OpenAI-compatible vLLM-Omni server. | [Notebook](cookbooks/cosmos3/generator/action/run_id_with_vllm.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/action/run_id_with_vllm.ipynb) |
-| Transfer with Cosmos Framework | Generator | Video transfer: edge, blur, depth, segmentation, and world-scenario controls with captions, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/generator/transfer/run_video_transfer_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/transfer/run_video_transfer_with_cosmos_framework.ipynb) |
-| Reasoner with Cosmos Framework | Reasoner | Text and image reasoning: detailed captioning, robot task planning, 2D grounding, describe-anything, and action-trajectory prompts, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/reasoner/run_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/reasoner/run_with_cosmos_framework.ipynb) |
-| Reasoner with vLLM | Reasoner | Image and video reasoning: captioning, temporal localization, embodied reasoning, common-sense reasoning, 2D grounding, describe-anything, action CoT, driving scenes, physical-plausibility, and situation understanding, against an OpenAI-compatible vLLM server (Cosmos3-Super on 4 GPUs by default; switch to Nano per the cookbook README). | [Notebook](cookbooks/cosmos3/reasoner/run_with_vllm.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/reasoner/run_with_vllm.ipynb) |
-| Reasoner with NIM | Reasoner | The same image and video reasoning examples as the vLLM notebook, run against the prebuilt, OpenAI-compatible [Cosmos 3 Reasoner NIM](https://catalog.ngc.nvidia.com/orgs/nim/teams/nvidia/containers/cosmos3-reasoner) container; local media is sent as base64 data URIs. | [Notebook](cookbooks/cosmos3/reasoner/run_with_nim.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/reasoner/run_with_nim.ipynb) |
+| Generator (audiovisual) with Diffusers | Generator | Text-to-image, plus text-to-video and image-to-video each with or without synchronized sound, via `Cosmos3OmniPipeline`. | [Notebook](cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_diffusers.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_diffusers.ipynb) |
+| Generator (audiovisual) with Cosmos Framework | Generator | Text-to-image, plus text-to-video and image-to-video each with sound on or off, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_cosmos_framework.ipynb) |
+| Generator (audiovisual) with vLLM-Omni | Generator | Text-to-image, plus text-to-video and image-to-video each with sound on or off, against an OpenAI-compatible vLLM-Omni server. | [Notebook](cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_vllm_omni.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/audiovisual/basic_examples/run_with_vllm_omni.ipynb) |
+| Forward dynamics with Cosmos Framework | Generator | Forward dynamics: action-conditioned future-observation prediction for AV, DROID, and UMI, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/generator/action/basic_examples/run_fd_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/action/basic_examples/run_fd_with_cosmos_framework.ipynb) |
+| Forward dynamics with vLLM-Omni | Generator | Forward dynamics: action-conditioned future-observation prediction for AV, DROID, and UMI, against an OpenAI-compatible vLLM-Omni server. | [Notebook](cookbooks/cosmos3/generator/action/basic_examples/run_fd_with_vllm.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/action/basic_examples/run_fd_with_vllm.ipynb) |
+| Inverse dynamics with Cosmos Framework | Generator | Inverse dynamics: ego-motion trajectory prediction from input AV video, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/generator/action/basic_examples/run_id_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/action/basic_examples/run_id_with_cosmos_framework.ipynb) |
+| Inverse dynamics with vLLM-Omni | Generator | Inverse dynamics: ego-motion trajectory prediction from input AV video, against an OpenAI-compatible vLLM-Omni server. | [Notebook](cookbooks/cosmos3/generator/action/basic_examples/run_id_with_vllm.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/action/basic_examples/run_id_with_vllm.ipynb) |
+| Transfer with Cosmos Framework | Generator | Video transfer: edge, blur, depth, segmentation, and world-scenario controls with captions, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/generator/transfer/basic_examples/run_video_transfer_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/transfer/basic_examples/run_video_transfer_with_cosmos_framework.ipynb) |
+| Reasoner with Cosmos Framework | Reasoner | Text and image reasoning: detailed captioning, robot task planning, 2D grounding, describe-anything, and action-trajectory prompts, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/reasoner/basic_examples/run_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/reasoner/basic_examples/run_with_cosmos_framework.ipynb) |
+| Reasoner with vLLM | Reasoner | Image and video reasoning: captioning, temporal localization, embodied reasoning, common-sense reasoning, 2D grounding, describe-anything, action CoT, driving scenes, physical-plausibility, and situation understanding, against an OpenAI-compatible vLLM server (Cosmos3-Super on 4 GPUs by default; switch to Nano per the cookbook README). | [Notebook](cookbooks/cosmos3/reasoner/basic_examples/run_with_vllm.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/reasoner/basic_examples/run_with_vllm.ipynb) |
+| Reasoner with NIM | Reasoner | The same image and video reasoning examples as the vLLM notebook, run against the prebuilt, OpenAI-compatible [Cosmos 3 Reasoner NIM](https://catalog.ngc.nvidia.com/orgs/nim/teams/nvidia/containers/cosmos3-reasoner) container; local media is sent as base64 data URIs. | [Notebook](cookbooks/cosmos3/reasoner/basic_examples/run_with_nim.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/reasoner/basic_examples/run_with_nim.ipynb) |
 
 ### Inference Benchmarks
 
diff --git a/cookbooks/cosmos3/README.md b/cookbooks/cosmos3/README.md
index ecf78a06..48f6474c 100644
--- a/cookbooks/cosmos3/README.md
+++ b/cookbooks/cosmos3/README.md
@@ -203,7 +203,7 @@ export VLLM_USE_DEEP_GEMM=0
 All Reasoner cookbooks talk to an OpenAI-compatible chat-completions API. After
 [installing vLLM](#vllm), run the commands below from
 `cookbooks/cosmos3/reasoner` (same working directory as
-[`run_with_vllm.ipynb`](reasoner/run_with_vllm.ipynb)). That sets
+[`run_with_vllm.ipynb`](reasoner/basic_examples/run_with_vllm.ipynb)). That sets
 `$(dirname "$(pwd)")` to `<cosmos>/cookbooks/cosmos3`, which matches the
 notebook's `COSMOS3_MEDIA_ROOT`.
 
@@ -221,7 +221,7 @@ vllm serve nvidia/Cosmos3-Nano \
   --port 8000
 ```
 
-**Cosmos3-Super** (four GPUs; default in [`run_with_vllm.ipynb`](reasoner/run_with_vllm.ipynb), port 8001):
+**Cosmos3-Super** (four GPUs; default in [`run_with_vllm.ipynb`](reasoner/basic_examples/run_with_vllm.ipynb), port 8001):
 
 ```bash
 export COSMOS3_MEDIA_ROOT="$(dirname "$(pwd)")"

From a10ecd9fe77125f3f01498b4891655e5933253f0 Mon Sep 17 00:00:00 2001
From: Alex Sotelo <asotelo@nvidia.com>
Date: Mon, 15 Jun 2026 19:53:53 -0700
Subject: [PATCH 4/4] docs(explainable-palletizer): add scenario walkthroughs
 and refresh architecture diagram

Document three control-loop examples (CALL_A_HUMAN, heavy base placement,
mixed-SKU stacking) with UI screenshots, and update the workflow SVG to
show App Server as the central hub.
---
 CONTRIBUTING.md                               |  64 +++--
 README.md                                     |   3 +-
 cookbooks/cosmos3/end2end/README.md           |  12 +
 .../end2end/explainable-palletizer/README.md  | 168 ++++++++++++
 .../assets/main_workflow.svg                  | 121 +++++++++
 .../assets/scenario1.webp                     | Bin 0 -> 41752 bytes
 .../assets/scenario2.webp                     | Bin 0 -> 53344 bytes
 .../assets/scenario3.webp                     | Bin 0 -> 63564 bytes
 .../run_palletizer_with_diffusers.md          | 185 +++++++++++++
 .../explainable-palletizer/workflow_e2e.md    | 254 ++++++++++++++++++
 10 files changed, 778 insertions(+), 29 deletions(-)
 create mode 100644 cookbooks/cosmos3/end2end/README.md
 create mode 100644 cookbooks/cosmos3/end2end/explainable-palletizer/README.md
 create mode 100644 cookbooks/cosmos3/end2end/explainable-palletizer/assets/main_workflow.svg
 create mode 100644 cookbooks/cosmos3/end2end/explainable-palletizer/assets/scenario1.webp
 create mode 100644 cookbooks/cosmos3/end2end/explainable-palletizer/assets/scenario2.webp
 create mode 100644 cookbooks/cosmos3/end2end/explainable-palletizer/assets/scenario3.webp
 create mode 100644 cookbooks/cosmos3/end2end/explainable-palletizer/run_palletizer_with_diffusers.md
 create mode 100644 cookbooks/cosmos3/end2end/explainable-palletizer/workflow_e2e.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 48c67c1b..d6dd005e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -73,35 +73,42 @@ cookbooks/
     │       ├── run_<task>_with_<backend>.ipynb
     │       └── assets/
     │
-    └── generator/
-        ├── audiovisual/                   # Generator: T2I, T2V, I2V, audio
-        │   ├── README.md
-        │   ├── basic_examples/            # Shipped starter cookbooks
-        │   │   ├── run_with_diffusers.ipynb
-        │   │   ├── run_with_vllm_omni.ipynb
-        │   │   ├── run_with_cosmos_framework.ipynb
-        │   │   └── assets/
-        │   └── <your-cookbook>/            # ← Community contributions go here
-        │
-        ├── action/                        # Generator: policy, FDM, IDM
-        │   ├── README.md
-        │   ├── basic_examples/            # Shipped starter cookbooks
-        │   │   ├── run_fd_with_cosmos_framework.ipynb
-        │   │   ├── run_fd_with_vllm.ipynb
-        │   │   ├── run_id_with_cosmos_framework.ipynb
-        │   │   ├── run_id_with_vllm.ipynb
-        │   │   ├── run_policy_with_cosmos_framework.md
-        │   │   └── assets/
-        │   └── <your-cookbook>/            # ← Community contributions go here
-        │
-        └── transfer/                      # Generator: video-to-video transfer
+    ├── generator/
+    │   ├── audiovisual/                   # Generator: T2I, T2V, I2V, audio
+    │   │   ├── README.md
+    │   │   ├── basic_examples/            # Shipped starter cookbooks
+    │   │   │   ├── run_with_diffusers.ipynb
+    │   │   │   ├── run_with_vllm_omni.ipynb
+    │   │   │   ├── run_with_cosmos_framework.ipynb
+    │   │   │   └── assets/
+    │   │   └── <your-cookbook>/            # ← Community contributions go here
+    │   │
+    │   ├── action/                        # Generator: policy, FDM, IDM
+    │   │   ├── README.md
+    │   │   ├── basic_examples/            # Shipped starter cookbooks
+    │   │   │   ├── run_fd_with_cosmos_framework.ipynb
+    │   │   │   ├── run_fd_with_vllm.ipynb
+    │   │   │   ├── run_id_with_cosmos_framework.ipynb
+    │   │   │   ├── run_id_with_vllm.ipynb
+    │   │   │   ├── run_policy_with_cosmos_framework.md
+    │   │   │   └── assets/
+    │   │   └── <your-cookbook>/            # ← Community contributions go here
+    │   │
+    │   └── transfer/                      # Generator: video-to-video transfer
+    │       ├── README.md
+    │       ├── basic_examples/            # Shipped starter cookbooks
+    │       │   ├── run_video_transfer_with_cosmos_framework.ipynb
+    │       │   ├── preview_helpers.py
+    │       │   ├── specs/
+    │       │   └── assets/
+    │       └── <your-cookbook>/            # ← Community contributions go here
+    │
+    └── end2end/                            # Multi-tower or application workflows
+        ├── README.md
+        └── <your-cookbook>/                # ← Community contributions go here
             ├── README.md
-            ├── basic_examples/            # Shipped starter cookbooks
-            │   ├── run_video_transfer_with_cosmos_framework.ipynb
-            │   ├── preview_helpers.py
-            │   ├── specs/
-            │   └── assets/
-            └── <your-cookbook>/            # ← Community contributions go here
+            ├── run_<task>_with_<backend>.md
+            └── assets/
 ```
 
 ### Where Does My Cookbook Go?
@@ -112,6 +119,7 @@ cookbooks/
 | Text-to-image, text-to-video, image-to-video, audio | `cookbooks/cosmos3/generator/audiovisual/` |
 | Robotics policy, forward/inverse dynamics | `cookbooks/cosmos3/generator/action/` |
 | Video-to-video style transfer, edge-guided generation | `cookbooks/cosmos3/generator/transfer/` |
+| Multi-tower application workflows or external robot/simulation stacks | `cookbooks/cosmos3/end2end/` |
 
 If your cookbook spans multiple towers (e.g., Reasoner analysis → Generator synthesis), create a new directory under `cookbooks/cosmos3/` with a clear name (e.g., `cookbooks/cosmos3/end2end/`).
 
diff --git a/README.md b/README.md
index a788f1a0..6c29d092 100644
--- a/README.md
+++ b/README.md
@@ -627,7 +627,7 @@ The Cosmos Framework requires `uv >= 0.11.3` (enforced via its `pyproject.toml`)
 
 ### Examples
 
-We are building examples that show Cosmos 3 capabilities end to end, including world generation, world understanding, captioning, temporal localization, grounding, and physical reasoning. Each example is a self-contained script or notebook you can run from this repository.
+We are building examples that show Cosmos 3 capabilities end to end, including world generation, world understanding, captioning, temporal localization, grounding, and physical reasoning. Each example is a self-contained script, notebook, or guide you can run from this repository.
 
 | Example | Surface | Workflows demonstrated | Open | nbviewer |
 | --- | --- | --- | --- | --- |
@@ -639,6 +639,7 @@ We are building examples that show Cosmos 3 capabilities end to end, including w
 | Inverse dynamics with Cosmos Framework | Generator | Inverse dynamics: ego-motion trajectory prediction from input AV video, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/generator/action/basic_examples/run_id_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/action/basic_examples/run_id_with_cosmos_framework.ipynb) |
 | Inverse dynamics with vLLM-Omni | Generator | Inverse dynamics: ego-motion trajectory prediction from input AV video, against an OpenAI-compatible vLLM-Omni server. | [Notebook](cookbooks/cosmos3/generator/action/basic_examples/run_id_with_vllm.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/action/basic_examples/run_id_with_vllm.ipynb) |
 | Transfer with Cosmos Framework | Generator | Video transfer: edge, blur, depth, segmentation, and world-scenario controls with captions, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/generator/transfer/basic_examples/run_video_transfer_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/generator/transfer/basic_examples/run_video_transfer_with_cosmos_framework.ipynb) |
+| Explainable mixed-SKU palletizer | End-to-end | Cosmos3-Nano and Cosmos3-Super Diffusers validation for palletizing-scene artifacts, plus a Doosan Robotics Isaac Sim/cuRobo full-stack smoke path. | [Guide](cookbooks/cosmos3/end2end/explainable-palletizer/README.md) | N/A |
 | Reasoner with Cosmos Framework | Reasoner | Text and image reasoning: detailed captioning, robot task planning, 2D grounding, describe-anything, and action-trajectory prompts, through the `cosmos_framework.scripts.inference` entrypoint. | [Notebook](cookbooks/cosmos3/reasoner/basic_examples/run_with_cosmos_framework.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/reasoner/basic_examples/run_with_cosmos_framework.ipynb) |
 | Reasoner with vLLM | Reasoner | Image and video reasoning: captioning, temporal localization, embodied reasoning, common-sense reasoning, 2D grounding, describe-anything, action CoT, driving scenes, physical-plausibility, and situation understanding, against an OpenAI-compatible vLLM server (Cosmos3-Super on 4 GPUs by default; switch to Nano per the cookbook README). | [Notebook](cookbooks/cosmos3/reasoner/basic_examples/run_with_vllm.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/reasoner/basic_examples/run_with_vllm.ipynb) |
 | Reasoner with NIM | Reasoner | The same image and video reasoning examples as the vLLM notebook, run against the prebuilt, OpenAI-compatible [Cosmos 3 Reasoner NIM](https://catalog.ngc.nvidia.com/orgs/nim/teams/nvidia/containers/cosmos3-reasoner) container; local media is sent as base64 data URIs. | [Notebook](cookbooks/cosmos3/reasoner/basic_examples/run_with_nim.ipynb) | [![Render with nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.org/github/nvidia/cosmos/blob/main/cookbooks/cosmos3/reasoner/basic_examples/run_with_nim.ipynb) |
diff --git a/cookbooks/cosmos3/end2end/README.md b/cookbooks/cosmos3/end2end/README.md
new file mode 100644
index 00000000..210a318a
--- /dev/null
+++ b/cookbooks/cosmos3/end2end/README.md
@@ -0,0 +1,12 @@
+# Cosmos3 End-to-End Cookbooks
+
+End-to-end cookbooks combine multiple Cosmos3 capabilities or connect Cosmos3 to
+external robotics, simulation, or application stacks.
+
+Environment setup for reusable Cosmos3 backends is centralized in the shared
+[Cosmos3 cookbooks environment setup](../README.md) guide. Each cookbook below
+documents any application-specific services, ports, and validation steps.
+
+| Cookbook | Backends | Entry point |
+| --- | --- | --- |
+| Explainable mixed-SKU palletizer | Cosmos3 Diffusers, Doosan Robotics simulation stack | [`explainable-palletizer/`](./explainable-palletizer/) |
diff --git a/cookbooks/cosmos3/end2end/explainable-palletizer/README.md b/cookbooks/cosmos3/end2end/explainable-palletizer/README.md
new file mode 100644
index 00000000..90e15f63
--- /dev/null
+++ b/cookbooks/cosmos3/end2end/explainable-palletizer/README.md
@@ -0,0 +1,168 @@
+# See How It Thinks: Mixed Palletizing with Explainable Visual Reasoning
+
+This cookbook shows how to validate an explainable mixed-SKU palletizing workflow
+with Cosmos3-Nano or Cosmos3-Super. The live Cosmos3 path uses a Diffusers-backed
+generation endpoint to create auditable palletizing-scene outputs, while the
+Doosan Robotics reference stack provides the full Isaac Sim, cuRobo, FastAPI,
+and React control-loop smoke test.
+
+| Model | Workload | Use case |
+| --- | --- | --- |
+| [Cosmos3-Nano](https://huggingface.co/nvidia/Cosmos3-Nano), [Cosmos3-Super](https://huggingface.co/nvidia/Cosmos3-Super), [Isaac Sim](https://developer.nvidia.com/isaac-sim), [cuRobo](https://curobo.org/), [Diffusers](https://github.com/huggingface/diffusers) | End-to-end | Explainable mixed-SKU palletizing: visual scene generation, handling-policy validation, and simulated robot execution |
+
+**Source project:** [doosan-robotics/explainable-palletizer](https://github.com/doosan-robotics/explainable-palletizer)
+
+## What You Will Build
+
+- Run a Cosmos3-Nano or Cosmos3-Super Diffusers smoke request for a palletizing
+  cell and save the generated media artifact.
+- Validate the Doosan reference stack in no-token mode with real Isaac Sim and a
+  tiny inference model.
+- Use the same prompt family to document why the system places, delays, or routes
+  boxes for human inspection.
+- Review the source project's damaged-carton, heavy-box, and mixed-SKU
+  walkthroughs in [workflow_e2e.md](workflow_e2e.md).
+
+## Prerequisites
+
+- Follow the shared [Diffusers setup](../../README.md#diffusers) if you are
+  running Cosmos3 locally.
+- For the Doosan reference stack, install Docker with Compose V2 and the NVIDIA
+  Container Toolkit on a Linux GPU host.
+- Install [`uv`](https://docs.astral.sh/uv/) for the Doosan full-stack smoke if
+  the source checkout needs to generate `uv.lock`.
+- For full Cosmos3 model runs, authenticate to Hugging Face and accept the
+  relevant Cosmos3 model licenses.
+- Use a host with enough VRAM for the selected model size.
+
+| Profile | Model | Suggested hardware | Notes |
+| --- | --- | --- | --- |
+| Nano | `nvidia/Cosmos3-Nano` | Single NVIDIA GB10, RTX 4090-class, or larger GPU | Default for smoke tests and widest accessibility |
+| Super | `nvidia/Cosmos3-Super` | Multi-GPU Hopper/Blackwell-class system | Higher quality; launch the serving backend with the Super checkpoint before running the same client request |
+
+## Backends
+
+| Backend | Entry point | GPU requirement |
+| --- | --- | --- |
+| Diffusers-compatible HTTP endpoint | [`run_palletizer_with_diffusers.md`](run_palletizer_with_diffusers.md) | Nano: single GPU; Super: multi-GPU |
+| Doosan reference stack | `make docker-test` in the source repo | NVIDIA GPU with Isaac Sim support |
+
+## Quick Start
+
+Use the Diffusers entry point first. It is the fastest way to confirm that the
+Cosmos3-Nano or Cosmos3-Super service is reachable and can produce a palletizing
+scene artifact:
+
+```bash
+cd cookbooks/cosmos3/end2end/explainable-palletizer
+export COSMOS3_DIFFUSERS_BASE_URL=http://127.0.0.1:8000
+curl -fsS "${COSMOS3_DIFFUSERS_BASE_URL}/health"
+curl -fsS "${COSMOS3_DIFFUSERS_BASE_URL}/v1/models"
+```
+
+Then run the Python smoke-test block in
+[`run_palletizer_with_diffusers.md`](run_palletizer_with_diffusers.md) to write a
+local media artifact and verify the response can be decoded. Use
+[workflow_e2e.md](workflow_e2e.md) to compare the generated artifact against the
+operator-review criteria from the reference palletizer scenarios.
+
+Then run the full-stack reference smoke on a GPU host:
+
+```bash
+git clone https://github.com/doosan-robotics/explainable-palletizer.git
+cd explainable-palletizer
+cp docker/.env.example docker/.env
+test -f uv.lock || uv lock
+make docker-test
+```
+
+`make docker-test` starts real Isaac Sim plus a tiny inference model, so it does
+not need a Hugging Face token. The current upstream Dockerfile expects
+`uv.lock`; generate it once with `uv lock` if the source checkout does not
+already include it. Change `SIM_PORT`, `INFERENCE_PORT`, `APP_PORT`, and
+`FRONTEND_PORT` in `docker/.env` if another local service already uses the
+defaults. See
+[`run_palletizer_with_diffusers.md`](run_palletizer_with_diffusers.md#full-stack-troubleshooting)
+for NVIDIA Docker runtime setup, single-GPU sequential startup, and the cuRobo
+`warp-lang` compatibility note.
+
+## Architecture
+
+<p align="center">
+  <img src="./assets/main_workflow.svg" alt="Explainable palletizer workflow" width="900">
+</p>
+
+The Doosan reference stack launches four services:
+
+| Service | Default port | Role |
+| --- | --- | --- |
+| `sim-server` | 8100 | Runs Isaac Sim headlessly, creates conveyor-box images, and executes cuRobo-planned pick/place trajectories |
+| `inference-server` | 8200 | Serves the model endpoint used by the application server |
+| `app-server` | 8000 | Builds prompts, parses structured actions, maintains pallet state, and streams events |
+| `frontend` | 3000 | Shows camera frames, reasoning, parsed actions, and execution status |
+
+For the Cosmos3 Diffusers path, the client only needs an HTTP endpoint exposing:
+
+- `GET /health`
+- `GET /v1/models`
+- `POST /v1/infer`
+
+The request is model-size agnostic. To move from Nano to Super, start the serving
+backend with `nvidia/Cosmos3-Super` and confirm `/v1/models` reports the Super
+checkpoint before reusing the same prompt and payload shape.
+
+## Results / Expected Output
+
+A successful Diffusers smoke test writes one generated image or video artifact
+and prints metadata similar to:
+
+```text
+model: nvidia/Cosmos3-Nano
+backend: diffusers
+decoded media bytes: non-zero
+seed: fixed integer
+```
+
+A successful full-stack Doosan smoke test prints healthy endpoints for:
+
+- `sim-server`
+- `inference-server`
+- `app-server`
+- `frontend`
+
+and exposes the UI at the configured frontend port.
+
+The companion walkthrough includes expected actions and screenshots for:
+
+- damaged cartons routed to `CALL_A_HUMAN`,
+- heavy boxes placed on low pallet layers with firm grip,
+- mixed-SKU stacks that keep rigid goods below fragile items.
+
+## Dataset
+
+| Name | Source | License | Size |
+| --- | --- | --- | --- |
+| Synthetic palletizing scenes and box assets | [doosan-robotics/explainable-palletizer](https://github.com/doosan-robotics/explainable-palletizer) | See upstream repository | Small source assets plus Docker/model caches |
+| Cosmos3 models | [NVIDIA Cosmos3 collection](https://huggingface.co/collections/nvidia/cosmos3) | NVIDIA Open Model License | Varies by model |
+
+## Safety and Limitations
+
+- This is a simulated proof of concept, not a production robot safety system.
+- Cosmos3 generation can help validate scene prompts and expected outputs, but
+  real palletizing deployments still need independent safety controls, guarded
+  robot execution, and site-specific validation.
+- The upstream Doosan project currently keeps its full closed-loop stack in the
+  public reference repository; this cookbook does not vendor that source code.
+- If the full-stack smoke test fails on a driver, CUDA, or container-runtime
+  mismatch, fix the host runtime before treating the robot-loop path as passed.
+- If the Diffusers endpoint was just restarted, the first Nano/Super request can
+  spend several minutes loading weights before returning a generated artifact.
+
+## Resources
+
+- [doosan-robotics/explainable-palletizer](https://github.com/doosan-robotics/explainable-palletizer)
+- [Cosmos3-Nano](https://huggingface.co/nvidia/Cosmos3-Nano)
+- [Cosmos3-Super](https://huggingface.co/nvidia/Cosmos3-Super)
+- [Cosmos3 Diffusers setup](../../README.md#diffusers)
+- [Isaac Sim](https://developer.nvidia.com/isaac-sim)
+- [cuRobo](https://curobo.org/)
diff --git a/cookbooks/cosmos3/end2end/explainable-palletizer/assets/main_workflow.svg b/cookbooks/cosmos3/end2end/explainable-palletizer/assets/main_workflow.svg
new file mode 100644
index 00000000..14afea03
--- /dev/null
+++ b/cookbooks/cosmos3/end2end/explainable-palletizer/assets/main_workflow.svg
@@ -0,0 +1,121 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="640" viewBox="0 0 1200 640" role="img" aria-labelledby="svgtitle svgdesc">
+  <title id="svgtitle">Explainable palletizer: Cosmos3 validation loop</title>
+  <desc id="svgdesc">The app server or smoke client connects to Sim Server for robot-loop evidence, to a Cosmos3 Diffusers endpoint for generated palletizing artifacts, and to Frontend for operator review. Frontend also connects directly to Sim Server for the camera stream.</desc>
+
+  <defs>
+    <marker id="ag" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="6" markerHeight="6" orient="auto">
+      <path d="M 0 1 L 9 5 L 0 9 z" fill="#76b900"/>
+    </marker>
+    <marker id="ad" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="6" markerHeight="6" orient="auto">
+      <path d="M 0 1 L 9 5 L 0 9 z" fill="#4a4a4a"/>
+    </marker>
+    <marker id="ab" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="6" markerHeight="6" orient="auto">
+      <path d="M 0 1 L 9 5 L 0 9 z" fill="rgba(79,195,247,0.6)"/>
+    </marker>
+    <pattern id="grid" width="60" height="60" patternUnits="userSpaceOnUse">
+      <path d="M 60 0 L 0 0 0 60" fill="none" stroke="#191919" stroke-width="1"/>
+    </pattern>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1200" height="640" fill="#080808"/>
+  <rect width="1200" height="640" fill="url(#grid)"/>
+
+  <!-- Docker network boundary -->
+  <rect x="60" y="108" width="1080" height="440" rx="10" fill="none" stroke="#232323" stroke-width="1.5" stroke-dasharray="8 5"/>
+  <text x="80" y="124" font-family="'JetBrains Mono',Courier,monospace" font-size="11" fill="#404040">zenith-net</text>
+
+  <!-- ═══ HEADER ═══ -->
+  <text x="75" y="46" font-family="'JetBrains Mono',Courier,monospace" font-size="12" fill="#76b900" letter-spacing="4">RUNTIME ARCHITECTURE</text>
+  <text x="75" y="83" font-family="Arial,Helvetica,sans-serif" font-size="38" font-weight="800" fill="#ffffff">Explainable Palletizer <tspan fill="#76b900">Validation Loop</tspan></text>
+
+  <!-- ═══════════════════════════════════════════
+       TOP ROW: sim-server  ·  app-server  ·  inference-server
+       App-server is the central hub. Exception: Frontend
+       connects directly to sim-server for camera stream.
+  ═══════════════════════════════════════════ -->
+
+  <!-- ── NODE 1: SIM SERVER (SWAPPABLE) ── -->
+  <rect x="75" y="130" width="270" height="225" rx="6" fill="rgba(79,195,247,0.04)" stroke="#4fc3f7" stroke-width="1.5" stroke-dasharray="6 4"/>
+  <rect x="75" y="130" width="270" height="3" rx="1" fill="#4fc3f7"/>
+  <!-- SWAPPABLE badge top-right -->
+  <rect x="225" y="138" width="108" height="20" rx="3" fill="rgba(79,195,247,0.10)" stroke="rgba(79,195,247,0.38)" stroke-width="1"/>
+  <text x="279" y="152" font-family="'JetBrains Mono',Courier,monospace" font-size="10.5" fill="#4fc3f7" text-anchor="middle">↔ SWAPPABLE</text>
+  <!-- Port, tag, name -->
+  <text x="92" y="175" font-family="'JetBrains Mono',Courier,monospace" font-size="13" fill="#777">:8100</text>
+  <text x="92" y="193" font-family="'JetBrains Mono',Courier,monospace" font-size="11" fill="#4fc3f7" letter-spacing="1.5">SIMULATION / REAL</text>
+  <text x="92" y="220" font-family="Arial,Helvetica,sans-serif" font-size="21" font-weight="700" fill="#ffffff">Sim Server</text>
+  <text x="92" y="240" font-family="Arial,Helvetica,sans-serif" font-size="14" fill="#4fc3f7">or Real Robot</text>
+  <!-- Description -->
+  <text x="92" y="267" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Isaac Sim + cuRobo MotionGen</text>
+  <text x="92" y="285" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Doosan P3020 · conveyor</text>
+  <text x="92" y="303" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Box image capture</text>
+
+  <!-- ── NODE 2: APP SERVER (central hub, highlighted) ── -->
+  <rect x="465" y="130" width="270" height="225" rx="6" fill="rgba(118,185,0,0.07)" stroke="#76b900" stroke-width="2"/>
+  <rect x="465" y="130" width="270" height="3" rx="1" fill="#76b900"/>
+  <!-- Port, tag, name -->
+  <text x="482" y="158" font-family="'JetBrains Mono',Courier,monospace" font-size="13" fill="#777">:8000</text>
+  <text x="482" y="176" font-family="'JetBrains Mono',Courier,monospace" font-size="11" fill="#76b900" letter-spacing="2">ORCHESTRATION</text>
+  <text x="482" y="204" font-family="Arial,Helvetica,sans-serif" font-size="21" font-weight="700" fill="#ffffff">App Server</text>
+  <!-- Description -->
+  <text x="482" y="232" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Control loop</text>
+  <text x="482" y="250" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Prompt builder</text>
+  <text x="482" y="268" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Action parser</text>
+  <text x="482" y="286" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Pallet state + constraints</text>
+  <text x="482" y="304" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">WebSocket event stream</text>
+
+  <!-- ── NODE 3: COSMOS3 ENDPOINT (highlighted) ── -->
+  <rect x="855" y="130" width="270" height="225" rx="6" fill="rgba(118,185,0,0.07)" stroke="#76b900" stroke-width="1.5"/>
+  <rect x="855" y="130" width="270" height="3" rx="1" fill="#76b900"/>
+  <!-- Port, tag, name -->
+  <text x="872" y="158" font-family="'JetBrains Mono',Courier,monospace" font-size="13" fill="#777">:8200</text>
+  <text x="872" y="176" font-family="'JetBrains Mono',Courier,monospace" font-size="11" fill="#76b900" letter-spacing="2">GENERATION</text>
+  <text x="872" y="204" font-family="Arial,Helvetica,sans-serif" font-size="21" font-weight="700" fill="#ffffff">Cosmos3 Endpoint</text>
+  <!-- Description -->
+  <text x="872" y="232" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Diffusers backend</text>
+  <text x="872" y="250" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Nano default · Super quality</text>
+  <text x="872" y="268" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Prompt + seed + model ID</text>
+  <text x="872" y="286" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">/health · /v1/models · /v1/infer</text>
+  <text x="872" y="304" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Generated media artifact</text>
+
+  <!-- ═══ HORIZONTAL ARROWS (sim ↔ app-server) ═══ -->
+
+  <!-- sim-server → app-server: box images + state (REST GET) -->
+  <line x1="348" y1="220" x2="462" y2="220" stroke="#76b900" stroke-width="2" marker-end="url(#ag)"/>
+  <text x="405" y="213" font-family="Arial,sans-serif" font-size="10.5" fill="#76b900" text-anchor="middle">box images + state</text>
+
+  <!-- app-server → sim-server: pick/place cmd (REST POST) — dashed -->
+  <line x1="463" y1="238" x2="349" y2="238" stroke="#4a4a4a" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#ad)"/>
+  <text x="405" y="254" font-family="Arial,sans-serif" font-size="10" fill="#555" text-anchor="middle">pick/place cmd</text>
+
+  <!-- ═══ HORIZONTAL ARROWS (app-server ↔ inference-server) ═══ -->
+
+  <!-- app-server → Cosmos3 endpoint: palletizing prompt -->
+  <line x1="738" y1="220" x2="852" y2="220" stroke="#76b900" stroke-width="2" marker-end="url(#ag)"/>
+  <text x="795" y="213" font-family="Arial,sans-serif" font-size="10.5" fill="#76b900" text-anchor="middle">scene prompt</text>
+
+  <!-- Cosmos3 endpoint → app-server: artifact + metadata — dashed -->
+  <line x1="854" y1="238" x2="740" y2="238" stroke="#4a4a4a" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#ad)"/>
+  <text x="795" y="254" font-family="Arial,sans-serif" font-size="10" fill="#555" text-anchor="middle">artifact + metadata</text>
+
+  <!-- ═══ NODE 4: FRONTEND (directly below app-server) ═══ -->
+  <rect x="465" y="383" width="270" height="135" rx="6" fill="#111111" stroke="#2d2d2d" stroke-width="1.5"/>
+  <!-- Port, tag, name -->
+  <text x="482" y="409" font-family="'JetBrains Mono',Courier,monospace" font-size="13" fill="#777">:3000</text>
+  <text x="482" y="427" font-family="'JetBrains Mono',Courier,monospace" font-size="11" fill="#76b900" letter-spacing="2">FRONTEND</text>
+  <text x="482" y="452" font-family="Arial,Helvetica,sans-serif" font-size="21" font-weight="700" fill="#ffffff">Frontend</text>
+  <!-- Description (2 compact lines) -->
+  <text x="482" y="475" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Camera feed · Reasoning trace</text>
+  <text x="482" y="493" font-family="Arial,Helvetica,sans-serif" font-size="13" fill="#cccccc">Parsed action · Execution status</text>
+
+  <!-- ═══ VERTICAL ARROW: app-server → frontend (WebSocket events) ═══ -->
+  <line x1="600" y1="358" x2="600" y2="380" stroke="#76b900" stroke-width="2" marker-end="url(#ag)"/>
+  <text x="614" y="373" font-family="Arial,sans-serif" font-size="10.5" fill="#76b900">WebSocket events</text>
+
+  <!-- ═══ DIAGONAL ARROW: sim-server → frontend (camera stream, nginx /sim/ proxy) ═══ -->
+  <line x1="280" y1="355" x2="470" y2="383" stroke="rgba(79,195,247,0.45)" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#ab)"/>
+  <text x="358" y="378" font-family="Arial,sans-serif" font-size="10" fill="rgba(79,195,247,0.55)" text-anchor="middle">camera stream</text>
+
+</svg>
diff --git a/cookbooks/cosmos3/end2end/explainable-palletizer/assets/scenario1.webp b/cookbooks/cosmos3/end2end/explainable-palletizer/assets/scenario1.webp
new file mode 100644
index 0000000000000000000000000000000000000000..1d409ea1ca76c668ca8284804b4376fe8cb80c4d
GIT binary patch
literal 41752
zcmb@t1CS-_)-Afqw$){H*|zQKvTfV8ZQDkdZQJT{RhNyokM`OBIrqMIZ^X-(vEqx2
zjEu~0YK%E@DN2ZnA{GJwsv?5&Kjhg7K>t|N--BcWQSyTaf$&<hrb>_yQ&JSzL#gw_
zg`3-K9{${We$^)ey>YMAIv5LE0&I;^__lwoIqb+Bn{_DK_dIr|9@D!|=}E7S_Gsz;
zFbh1E8-5Aw8Y!2x`)s5JQ0IJTfA%aOO!S0*nSb)#vMup3@8Ep={y_Nned}|gd-0-r
zzVoJg$s_k^_$>GGwewNr>-kkWq?^)n=bQNm^Q3!$pLBH+nR|kFCARft>O1Rh@>TmO
z^}*M?Q}z}7)%Yp23-glt*z=6P`_cI|wEydQ=cT9h3y?eeHS#&@+3{8W7JP<s;j1sV
z21KnW5FySW0sfs}hy=4J5H-#q0rvmLQ^=iL@pb960^lx3D$+y8BgZ2t0nhNGt1|z0
zX3VI39GdZT!5{oX$xdDw$VS7LyKvr!xehl$8Uww}>x`ZN0r90~1}jg1L^pXTPI|8h
znCpe?>~1@J&}LCe{&>6YAXXaFC`0o3?WR5WaU4R5X#Ts3(f!&`^8eX;5By4=#LHbx
zp@uYDWqsTCV+QKhE~=7$kLs6Q@Xh-_+qnFn<oPumDxnGk1N5nXw?7vDG$^Ilt3`dn
zCobF`1CT2h_6DlV&C{a*p7U0G`wVB6nO#_;v>~#Gf~~yCk17lpqBHNs6+S<P1cL!T
zI3m@0;rqAzvq-CEEqR=#zHQ+1@wr;!@f9z%WwL)b6&XR%z=oinJKF0HKLgtRmW~@o
z$(HioEDfWk%|EJIiPIl7uGNFP?~Ofbe?ek_%?RIJCxDnQZ68+G&Lyj}6Gy$9`f+MD
z;}>Mh@$gYyR9W%=ecuo(?4qSfDY<DnNd06N-oVe;^|a>|AWM%+t7rExwQ;DYWG<V2
zU0d9W_S^hn-0@rry57d**RO?a-_m6$YR7yE#&AUkf;u0fO-PorEtj!zPjbr|#E|N?
z;4Iv$cJ;$r#$fF#)jSD+tV=l)fgl^tER*rJ#uQg(kry3~>x({~sJu&j;?pJ%@uutg
zSy}wJg?aRH`CuWzq06Jmf46JaV2V<A+IQkmW@}*b&3G=bjx0&EJiP|;FR@kCvKd*C
z9lS%8TtxdJM+a^G<2Pz3e)lULKi*apuDsiKA=x{+ve9SE5A~#EXk!2cQH_moi{jWT
z*b?Nsa#p~6d4q2G79FZ5W~DfK>(%x-<)ird#;k}}hiw7s%M8;2^AK2XrJc6xyd~@R
zUzOKlFBz6wb12a}=0t<{J!nl>S+g?EaGMf_%PK-!q~9VdDj|u#2bOQt#0Fwng*6mM
zhy9PNR4_u8(+4pcJRu1}zY@c;c74{60>&KML)_$av9+L19QkOj_SE(J3d#8VNtwnn
zUpg6)dK4OfPgxaB{0!~@qmdY-+~WB%Nl=t90WqXJ9jKz#%5t5mC11h!VLaduedIy7
zKAizVNd#kb@xLnu@WBQPLkZ9RC=?Gry4T=Y_uqBGb5pMEeMGDJ{8y_p;Y*zq)a~^y
zfaz!uunl88H{_jDE3_ulT8F9*Qnot7*y!VD+0Cp!?yVObxmDcOn5FN$f^KgXOy>FG
zzsX0B_G1}Q#IqW`j^?s!Sv+0<pRB)91yl12Ozq#N#sVtTR{j57u{>oLz-QEGgozkk
z{;Xq)fjmCbIP()Q?#mjN@N*gOp&6FI3dx9?r6H@9pVM|uA6-waVKEcPaT@>=><M5Z
z18@b%SA7B(Hx7E!QZcF$D2)|i7^<bm&b!Bcg5|XU0X{F7@^~2QOLomCC+irV-pH>o
z@EB4leUW79f93&dcvbCbQP-M?6v%ffE^5EfMpR*S#o@t!*3$W~MaIj98>34tFJk<b
zS<#3d^E+*C0b&>6e!`zf^u1S|E#$DYB)mLZ0go!ht~ifA(SvxB9!E&K&N_ksGN2Au
zJ3VO`v9pqJYS8@UYaZ~d^i^=%1GZHL(D7yLWRZ1-4pDL&?oS&WP(TN#RjD4|&#X!}
zsmh99H%^#T{98P(g<pT&H;gCU4|~4WjKw1lmXnREC9>@4(LbBOskyFWVk_O;fp8dW
z`uSdeVhGuB&HamTJ9qXfWB;B1zDmX8Tn`vi6p83+%PlmcK86B@&y}nCfLz>-BN^v$
zvF^T3Ic;!XR7zAVF}(7}HxOV&p-~L5WZ~t+2P@CuSN<S@U%>GM%{x}IQ%7ToNl$F>
z#Uk+(KG#Fr*8}g34d~te*U{WSth*K{2h*)puV`5FzI1-jY+51Rn0(mYA#IDJrnK4b
z7csLCI>QH;E~PZcRxs`jSCm{0`V!ld@Xncp4_v3Eav6pO|L$w*iz7FTRE4h(_*4BL
zV$54l#EloX#c>z%N+upYs%!t;o%z!{F>%QYgMj$?D?A+%p38pakY~LF$9Tiwk4azP
z;LFwtfSxefT)l_p@8BMB2zz$&sB1e7I;zLO4y(gEo{NITl3Lm+CqMtS!febGu4uO|
z=c$%4P%;Tx5fk_$(g-w^;l!L6k|H=u4YAtM(O3VJlA7dbxsdXx9SLX3HP?L<Z6Pag
zq>^cmsfVwFvfC2=qpE`;31ur&Bb~(3iN|21y-%;sC&sN_g=EEyelr)<n!5S>vYf}i
zlnO+}hWwoUIfI6X5<Jar)#bNBkb}mCf3<bWP=Ou1$9Q?SVrn%MPXIpjF52$E#VBI@
z6=d}SpESE(x~|Ea6RVV>-%eUszawhbo@HlanMd5x9b*Fx!$`AWi02WUd!5gs>`NJV
zPnI-WB^${EaTCkj-k}&=l7lib-Qkn9X#+cK1;b|LfXKlP@j)WDcG23T;+$p4;Q@@{
zwil}8K~t&Im-X6XJ9{;uZ9Mm3V#Hz7inh`XK=iLbM1CTI{FfQd;$7aKO&Z=|BjMMe
zLuz9JTWi#0Es42NuW$y{fUHVsOD~MsYy|wbX_$E0U^a!?yNs0hOG3zMX6ic91HyO=
zQ04TZ1NIZ5<!Br4WPnrk=Vc_V41F5aYy-@R`?%PUW{zTrQ}(#6sLIAf0EQ>&(q+je
z*nYu&tOHxTA#$6N!3=%#Gnd9U^J(`i&!c09Zp4~cFEc!q{=SkOiQkTFK$<sTkV~y@
zM+Rx<zPLXQQw@>r@4YZzs2-<(vl=8W0D005L-^%AB6QU#Dw|5JY_b?g8;{v$;_FqO
z>3I2-{_;-#SFw-BCG~zwtll-DtitfQ(*Z!<2=AdQ*Vlvm9iF*6U>fu$G=*ph1~c_@
z<iJfq+~yjjjag&a1OJGdAhZXlQ++pV<x--`M$>ChixS-l2FJ=l8U?Ki=x+Hl(Emt`
zagE8J1tIq*c{2zeRBkDGPGjr;ZZ{08u8fa;yg9MrNs-b4+_~#XA8^HV6E{jEeZaA?
znVQaZ@4{KOB|?7C7u(MXiL<)K%sUM=g$3CRmS}ZCZ~1Qsgyyo(ikldi1<T|1)GYW`
zuO+oqy~Chqm*n5lnCc|#LKaDsINM5O&m1K<#!f+Fz<RAKWeDC1M6gSOXyaXjn+@sL
zTwJ<ooi6ol0`w_%d3?fK|Aw3zT!)U%?`1lo6FUf#(Xwr(O_?}lIqL=*fZ2%k|7FSr
z)c6L9n)y}Xeu`z8rJi=%GXZ>wx{?~+=GRr?E+&`&-fc!+m7@&2Be8VEu}l%zEtv{+
zv2ngZvw1wRPTlDKMIPI&>XT-<l5vkw+{ut(+%9kdZQUU!)cqZ+$hbh;=13E##ZiyA
z`>E27uL9QLBL+TW)E1-w77M%&hNWCg!IcjAvhf(vST-)Zac0NIrFa*Rdq6{7X8fO)
z2l0<}>~3bj5H_?k`YXjx<#U0~cUSn|xk*%_X!0)zSG0OPMAz8iMQlzyKgX>XHw`9+
zS!g8flLM~Zh2=zVj2^UAi1(WiFDy$^$=o*r!O2XkB8Dk~R^Lb;R?jV+LBVsf7(2K;
zMmf2O<1i6E`1*nZ+m{D>&Hoy2e}nv{-h3)fLUBXq>!|mtW690=Zrzmd#i}_@TMK(3
zNu5BKo?j$Z>qs|o1CFSIu#zTL_!^DJB*_x7$`c!`IHhn`nDn3yoh-ZYEr1f<)R1x<
zsP_Ld{UxhN3x@b`J*AY+4PR4({2_7K&lxVu0Brfk-@vMkan_OIN9`VqxDoQiGq31O
zYF^{V?oo03PpBJ$-O-yLfOVLke*`KizY*Bp?V*M8u`a6ksLnM%VqzPigmA`wUDPfF
zQ&hj#w^J}_WxHR`D%nVry0|w&J95npAn&c!M)~=R^(4@eRWOVi&#i+I3zB`KN=gll
zv4Lkl;wmHY=IV>ATI<%`j$6=QCerF4At`lb{J;y-1K3Rr;}WIE#H9lDG6|l|*-omL
zLScM03$;rZuGTXv+_h|=lF263qpD^tL0u-CjPPcY$6Ma)`l0lk#fcSKNe;yAIzhto
z9!Bc5&f`&Mbm@59pmL?yQods089^2GX_H+LUkSWTPsi1p1u1KUtVs?<GM>`6K+Lcs
zbYgz>onf#!-3vp_fq{z4Z`y|nx^Fp=bX@{FX}jlJVSzWG<qsPygIZ<5+Vuc!JDZJ?
zB>RD~Kc%BXVMg*^B15T<ue$c9okX1d{CuY!qcooNrdX4Q3^}3fsjvw)-jVh@=9C{{
zBqWC$rh<0#IMkc1#bTOiur{MoIO_eqODcoTUtdkmurb}66@UI7<qgw-KA0#2xub17
zy8rzg$dP5ml6@i_TVrh*`}r36jBPFFsTS+Pk@YspuslkGO1yX+zpTku9`)~(ffQJf
z=*Qo%nnYO9T==>98gX3XX@z%b4%(K7Ge=~`1_G0;_+A$l<lH1IcTC*KLAo#_a+-=l
zt9pR|hyyBYszN!N+iaI>BMqo1+(zp=KVyW*=*=F<8)qq;*(X`Y8b+zn{{YN?Fk2U=
zez6t>k<=`fB)?VKcG2}%Q2^JE9nGwXQtoe>>gdeCjXK3Etr8P8DCz^Pei)HKZO*I9
zu1yM)y_=-ZcF?Tg$h(SOdB>5yO^#o}`Z$Vjm|H|CHt6xrHc^rkf9bpb=&&|2y7%tG
zBq?W;j8TwBNfQk4FSxA3G8}YT_ht5S?*nTGdG)G(A-9qj7B4j#DER8;`w>hkLdI@H
z-<P;Kpqdh4&*c;~qo2~bn<O4dE;L2<l2ELQq>wIJh~w5fm@QOt2*H12`C*7rN0!jv
zh26(}(~kiCJpXU@K6wA~C^m~ZNH(!{dw#{pTCcGE+xUQ9H)5#=Y88CnDOcs;yA5t6
z^`|B_J}<+R<u(Sd<#b};+<9!V*e)+XQc?VH`0(eiL=Nqy8mE$`zNj;Ug451bGkNOs
zZDD^{phPk$9UwB`<6!}MJ+PV*oJoZHV*?c;*?GbUrz<z7(_YBO0OQ1><;3Pax^=rL
zR<O*_!d0m!q(t9_D#$1`72yLG;!-4)w9769XnF_c2?15qZy_@0%T6BSPX7Wce?bEx
zUzWSCpFMVPU9JHtBq`b+E$QqtacQZ+-!18sNs89L;Evs=;^s-Id|WiT(}R!oG)?{G
z1~0ss&4_<h;RYq=qaqL{n4O`&`<azZ4>sq4&VP_2P{SlMvt_Ma96f($Mt#YRK!>-k
z<eeEgPv_(>Aw&?rJ$9fojX^(nKY0R+l{cB&>DtB#%@+Xq9#O9zD<`rA3Z98Rkk%v4
zHZ1#Z{QOVe#N#d+q9PMXZv-L7*$S10PYZJ{SctAHi0U|N>>DMgmXr;pzhP(=w7$`O
zyb8mMy2c!R4xuE8y}W9K#D_)H62;}9$<r?)!uOWo*eu&iXfT!T$jDD|qoYaHJ(bN9
z@9Y{zPKZ_i#xBiBFE@h@i7ux`qP96IKYrs_G-*KT_kjsR%;%XKG*q{6Hh2QH)z&k)
z6Zx$_lJc)a;BUDi@x=~GfBu5wDj8E6LRMmN3^m;K4#KAilm*kkJpe>sh9FYMo_gw%
z_XsoRExu8{RJ__D*GR$=Mw$9GWuZc(18(wNOisxBbEO`Q)A!3$6GpuxD66*6iTOc3
zO<w88rGdUO4H9yz95oc`VGmoX`mx46$Sj(6%Ufgu$SRBjipmPX{dJfBn5#aGn;y+Y
zUdO&oBuDDt%6!}wC)0j_p6bPHoIt2^^cs_LKc4He`SwT-gC2~DW;+TP|B*oN%^<=0
z@{ld26A2!+7V1Mu&yc)3+Hteu-4-2i0DhQM?4_|34&tBm=I`!-DUeM!^_ZRsItx;q
zz(Hu~J#HkO@AGb*bn@IU;%!2LEnOvycK`hoTc;x4=MJ@h8tY;<a;<Hm>iY+;JInHZ
zLE|_h0Cv;l3TtH0g@G@L@{&#(WwC8N!YIQg*(LH<zwPt43=mzZX5WHIw)7*{yxqCT
z*h_{ANQT0AZ`q1YgP22;(MnpZiF-N@*ObHpEeqN+11{*g6!MHlsFUoc{RZzAG<%A+
z#9+uSQO_l%x^U4|UJ3RkMfnr7&Gr0{xka6%9V$<%|9mf4`6<&%C*WHBYzeo(lPCCF
z&uKRFfKrp{+;mMSqA2q`wtghblP`REE%<Y7*>B|9c8d~R@pEnAbSHQr%bZ4CqUa}r
zBf^W$Z;${Av?4Hl!Z%<aM{?Weyl)L8{Nh`*TVBacXknlXOWg*IkAc7&nkONP%9s|C
z`xgUN(ptwi6*7lhtfid^Q_eC(PfRqQ%k7h7b`dQe?j528XaS~(aK~DjYTvG;;$J4}
ze{;ZmhoH}n9EPlpT>p0aFMRvg@ndmN*9&s0H^k0QCg6#gkaWf2k)q#O3=(85qDR~<
zTw{x+dxC$VZ~vluXwD{XB!(&gK6#tPyxNBPy0x(S7bB7tYEct1-d-@~Gu1WK9aN(6
z6jp-&Iq$@R#w=^VAKOfxmnedQWSa1?ff+cc(k*KMN2+_SMi-xV`Q}zCfGavex2R6Y
zFxvWhAZ<o8o0Q<ASp3!UC98k&6T2f4s;wj@oipdZo~!93PkeDZQr7#|OL23wr6Hk#
zV0B<(F!k949+oqWTp_Jv`Tnt*9A(cqzLhfg-JFAWAL~1X+KFZ<jXo<y<{R;X!iD$)
z%HpVgIE%iBCMq>1w^sWERUtKF$BU?3$ga0K-71VY%J08TwGRK=wB42)+UutyY%|fs
z{k;v_l&g$diS@tChB{K~EQh_`w9_}dRmR2*9%*FIXm+}JK^|24DZ77Rc651Ddq5jh
zEMcw2ZkL7~Ej2CT1G{t|dm|llh(3IwK5awT3CIE0>Ce-r)E6qWJNZYnV*ajhe@Uf;
zl&oc++`dSCgE)zGKYh_P{wpKbtR(`aDY8UY7-sNE_TAK(oPwD?J|s=V&!9q*xoS+N
zhP|KMnmNE!p!jW%J}^^>O%%XxXMw|IPV+5dIBDYa1J3TsxCMIPhYR#lSQ@g`J4%%S
zi#`iGirhfz(f<;GVkgJn-bDm|bIUhGUqf4wES`4e)@ojjfCnb$zEydTOdOghw{UA&
z$d<#Pb&N9DJiY$o!qp9fY*xRGzc1Gll^}xoHVc?;X@81*<%XAS?Xw`hnFr`mUOm6U
z{>Hpme_4ZssQGg3P|tr=tiiKsYkRRmv(j`+t~Y>5{@(TNEoYZJ8P!U0kT(8wbS9_{
z1&Qb;i_V!)ApGokM3H~9_(EW=4>8M^7r)CrOSmcWHNvp`vLNiTu%2v*{0>l>lbihb
zgO$KmK_Pnjtt6R=-*^tJ(8vxMki`Fn4cX%ek^+qj;j*s5e0@zs`LnveUuM`vWqva5
zEBH>DnS_Plj6Zz{Lq*t`&0|6l^wkRai_ved-w24#7Gi_TI;YLm$10eBv0@xR5sk0h
z)Qk6ZpIjI7lrqmP=VMny1GHp4KwtoBJb9B<d`b!LVP0FSEYM|LyA4mfkmU*JxJ8Aa
z3r@|HPM%>tYyK<<a&?w6^cP=g6v_ecYY6bw!i8~nhye!%5GEFHkEz{-%<Bedb6rIj
zKzC9eBDmGry!!)h2m(x*>c+<)eB@deZo9|-oS^+Hv;QGb1h+ib0JC7-+e%gi?jC-U
zt<>&oRCFpA+G@yhCjWBm*$(@p0Bh4w=AXDFRERx=uhT)122HXZJAGp0=Rx8#7b1p=
zcpU<KCKH%R87R`QdZ50(*ln&}%=ECU{y4J%{Y9q>wy%QAL24Q0^>#=vTAm6l(tBNV
zJ%<<`{>`<?+F)?ZJWGJxMBO2E4K2^=4q+sLr2Lt+4{KYnFF7ar7^Ie1S+K>~6~{%U
zJkvU2xiLe@2BA0EP_Y^qTTvng`P1$9zh~(Gp}A0KYM3Ma`k91vs-CoRQ7J6P-jib2
zu6SpHu+C%aI-7&s=o?&Q(a0mf#*>JB2+!IXYd;pJ8yCB0CIoMgB^-=R4a>ev^X)P@
z10x=*rYHlIUWn<FY0WvuL6g`y7EzX&eaNhV#L?Lw87m^8QD;I}oT8YSFiOi6HH5i6
z0ygwOdQ+4m%O^`S6#t$h@2kA#+r4<h)+G6V;p%@YMofY1sHWVLWVRQ)v!It_jeStQ
z!a@2MEgY#7<w9Bh1iwFk$${E|smAgFRP?VTbACtE7kPr#w`%ake&qKjv`YD+Z2S(A
zDkt-nK|o}bjBTj^v&c{nGR?R3px`#E&y{^%J)*31kPSCRqXISY2ZnI?)n8#CTxxpx
zFT$6Ig(^Xn@V|T|QWFT0(J8xW&3iQ;IOAkNH~#&E|A{B_t;d1F<p>RcWH#I`jO!jJ
zEz_3awnLFBXfkX4wuu3k_^$j61shVApiR~X`3QC#K6PZsIYo}Tx!s_%KGTBWgkGyO
zd5(!?vIcQ;F)Y!Tf>gk|H<jtT=m>3kf}*U=Dbkg(3~6`AE*NJqKxctwjM6?-+NB$@
zk_H(^VSc+Ij>jMb<zObHG`W@iuGp*)unJJw>MV0ZMM}Lop%_@mt`I>}haTJ!z7PxL
zUW?KVtQ#mB`yXeiOzovpd68Lj%<gv2z0EccC`uW+{}DicWdc2IFo^p7O=tHaZ0dVG
z!05id2}|bZ_XRG*moTE=lil_L#$9}cN}AgZpEF{<_RekxX!eiFeND<-a!;dWhCFzF
zrlvp$=o)*^|DoVm{&jlv=S1!wTl*uy!kc*o>utvP-(#%*cO`LD{y%Q<{~<zFTHawD
zXxbj`W9*7oW?g7&`TO=INDR{T#;bCycC-V31(GC&>G~7ZIMzEmfPH~WkR$d0i)bAi
zoE^e^!Y0TP`hZ5XPY*4PV!UIKWC^}Qp*dzpR>sjiGfJ=rKO<8fa}h6;AOGiA<eySQ
zYalFn5S}KiM|YGxb&&>g%<dD03>P4hcYV@u>E1Bh_zw`^3NbXJ>6bW_q^X{w>+3@A
z>#iz@BAGO>M6y!@HY0-x!6Cp&=+TQ~NZtK;?F9Lv4fela4gXXzaO$SCNvaCiJ3Zi3
zSND{(F;A(!{A<bh&xTS%bXs|ugVeWwmztI!%e){$`wVwDwMq-6S2F-}vh8qkAuCEc
z>h}HbeT7v7Zzb5Onpyu2kYq)1ponBLX_z#9ztpBq-miorADF7bJQtKWt_&bZoE7-H
zME1V`6Mw=Bv%f+O(x`p6ihhZkD=8Ds*#s|-_0qqHApf(3|0&n}HC+F1m1toA;Pb2I
z8SozmP|vF{AJvV*hvTI`_2jmah2PvuYK}T3SfCWvgW`{WUj05Q_`O|OTh)>a{6LQ)
zB<o3p-XE*teR%HvcNOLcZnjyNjv47xF4Rpi_Y1E+Y^f9(@Vf7`H+oV*TdcxtfF2k@
zH8&t=i!l{>0eE{$M8XlYhhqA(e%Sl`jq+1NcU=;*w;gNZ{M7i#{Z7>kZLJ^AQ_P?#
z5;Ac$1cK0OLq&DHm4#^pO}ikw*21LW`ZRAB!L#ZOedItF_9`M#V_@+arWSQo40@hz
zlONgeUB5~+B4(C5Ub;2if-amTHabGAE9^=HTseRx2T$I4Nc?1@S1iO=iuN<E<*fH`
zT>z*T*YlkMLTfe;_FB;9p8b<-zcK@2g{jTO=qeI#2>GnoP$?UK{eHyS^Q=v_A*5pp
zlbCB04db*)NZ(Xu5|6IHOcvaj04Li#@8TmRjY+`vT${Y@aEW2-8^*$2Y@C!`BekR2
zMo7r(x(>$?$|N{iSs;m6aBWX@tIZu-&!WsNzGl9c>y6{DYWe;5V)w=_*0BPoT<kEo
zJj$NNm=aTTP%E7u?lW@?%QrQ0%Nritte6i2TpXg5h+(nd(6Kv+Ff~bFZT^?fw|DMx
zPdmY%vk@Z$WSpX=mTsu#Lp_RpuvSLn`$)vxEo@9Q1|ThmAQbSPG$teHPeV5_ICj6j
z6Q4m>*~lj)W*|NcF+604U5-8#m6|dA!cJtEV3l%gUn)6xku3$a1hYGlXi;g-rJ9)x
zsc=0qM(`Eph}^h44|f?4N8dM(f`UkQ8HhVI{j%-a#Ev~55sbg&Gr}zuLt!0Em_SGV
zG(Kuj-w{fMF_m`Y_hY+K2?qv=!`A{mBR42Tum`A8-fQ*ww{O(cNG#7M)s%GVgDm8m
zdmKEZ9_-CIau+o`%EgN0Tf_JE*#X{=iEM{>`Q+QDJN=c-9v%U=tjF9+Ae%UM&CZK@
zUe@oi@q{|g>FqbiT>JtBqcLN+0|=U}cd;)T4tyR3Mm_FeL+6LRW;c1o^(hQu&fchP
zN>varc^E2tDMcXq1N+>>1stt~x-;wbq}C_w`oBXmO?jhyaBd|ZWVu)GbjTfRXM}dn
z`%E-2z&-(DYH;n#W!pZ-TMUf4bF|j__nTj9c$Zdmyr8K}AaVUFX>!HyeC^Ut{Rlzr
z_b{Y7OT9#-FxL0WY##h<04Mr?<Qdjjqd%5Qo=&V`OZ4x-DzwxXST||ZuL?H+;3iTE
z=EGqyW`G|a<b-&1l-QqLb>&r)AF6&oKz_UZ32c-;JCSTZFC|-KY-xuGSyIIT=V#VG
zZVOki#K&SmIci4Q{B~P__{T}|2Wx0$ye81kJz&OS7#~nCnrEcz)?Kmw9e;cnixZ>o
zS)_eoQV)!NAwJFAC6){D{SN<i*v)THfGt_XdZ}GmA0f88uk+8`kIHF$kX$6WNmK}>
zgV!0T_2%b&aP>cq8V9|;Ud9p-4Udz&2fA$w9Sfvo#0(XBprcRT=Rmr;dh3Ic0HjVG
z9vZ3!A6AWMZMw#iX~4^{Tj^l!cj{A08$)Yv?kBT$j#ZAssH-KVrXQJ8K(yygW)@k$
zXNz5xLnIw7yH@YfgrI4>L{L`S4^$iI>_$;Ke>^6>ZFwHU`T_0+k&rmX3%w^|gi1qy
zCGw!i@<$Ui$;|N&((aM3Ss~i$lSaOpJ7Bt}&!H>ZB~h~W)_K|9$Be2pq%I%=MQnx*
zAMRG+k<|9zHCpiIU_+}fZQv<{*_v0Gm+6K2AMj*EP%u<Dh+r{TsNp(W749n@Gs`~C
z5Z~q24k0|+Wyt+V_NUnr4^L{_s!siI<GuA7Pkf_x_YO_N%{ULb3&_O&STh6w!6@is
zkSi&_m<%{KXCkLire0rr{gT3pKrqQYxE^TZ+9XL$tq|}eqV37_X2!ULKqMP9yPRPw
zY)f#Uos^l5{5&FWeZ2@Ah!*9=-F;CV5|!l@SX?$9#<wcvg7dV|%(pSw;CS=z9qxw5
z5A|UPNAj;4XcCGb;HKM=5L?GYn2Jw+qpRi>(6Fi?t~uM}$WNJj7}Yq3mn~_3^X1S|
z5uU|?j85oxKN|>qaB@^WXLECmwO&XS_;idhzewcyrDmOg-lcG1&CCBskcmp4T0Ci{
z^3_#sg|1ttD~c<nDMpL;0A464sofD7hrQdU6iql#L)d-9TV_vy*Jlg^M5n%HM99Z;
z>A*>esa_oro~8}~faZzLU3;!A6)EcNzQHMkg&%euqIL;C%ouqw+Lh6s3a91{2J}g<
zeBB?A*;kRqWx7GAtB8n|yW7fK#>vyXR+9HO0bR=G={kA=uzhsiwLwOgdjN2(Pa}zR
zNXw&};3%vOBk=P*M*z1mIDp8;fxwXAhu#mutYLL{+72)Qb7Hx^UByb3yZmvQ?c}67
zWz<_gsa2k%fT}aayClN~$WSPUK4TQ~)pN6aF3*6H-MJ%R;90HuWH22N-54#GLo46=
zt}1*`HMId}r=!d9o%&(}FkJ`G@X>Y*<MzV1Xn~)N-r#1ELKG5Els0R{tV37($SPn!
z9%-|;))IgC&)8scH$@Q}8mK4h5L0s8f(sk$B<6Y-RQJcKh%+D(?1_(2RoEmzr<H7S
zGp*>E%j()q(NPJG7$F%+EF?a3e3v+7^%X+nei{wQ()p>KM$xMORD=WmcN@;uq(DrT
zG^aT7Bf{m#Y%dkhrFpX#OZ-6V*pg>98CONM;Dnlp&JU0AOCMh>59QlD8yONr7+{!w
zjg_aJ+OT7pz-y;Cy?T}1=Lb`vT6Y&7cP}v^h>6z8Nj0}BjGl1mMDY2%U!YtR3WHw`
zfiJa{_#W|-2QN>si)K0w!fG4JdcEvF#bJr|`qc&1eWX;W)AS!C@s=NTck=ixM`W_O
zmIxSxdM7!MR8f$X){wF4eF#h7SJY#BMu~%SCopf1eHW42#kRLA9@P1oTeioV6^%%|
zn{-Az*f2UnJDDM1i<gj2zvB$T%t=|Hbz1&zrR}hFt_46aiZIb^r{9Y3Xx44?3`xMb
z3HaUH7oDv<^nc-^v+X(l3d3hPDpHRgu$y9dm{rB=&Upyn)*@Ms^X`C5AE6)UzDCqy
zN^etcnTAW1o`qp3b-GsG6|oQN&c_0h4VlRz4^3&SKuINycWNb`txvyMjrG=O2u=?v
z07I>_^^hP<E}U`V2{mzVMj<n%QM)TQfv_CmRR5B;wJL+dMbsU8#p_;<R}`#FZv)}3
z)#(%7aPsc_nRsK(hO}^&NWkHHfMHD{PbOGd#ZbT^f!FQ?naV|(Z#(^2%_nJA_4k_Z
zGA&;&6YOWzSz14<A{(QnriMKIb0=t{NlEs4^SKEy1hvDpNtHk$B_qRUMV}G;W3IzC
z&?UJ)lC)ISTXhn)El-6Q9dc{BVni)wdZxa!euyr_J?J6T>#642<-$*ei_u+yMqe)a
zQ?K1Owlu0C$F@ywpS4R|uY=yq*b**<%fpkJWPB9;IZBz>!l^M>Ybxgeq_zC5GfOc`
z)!1UM!WY}xHr>X@EKRa?+=D{j&Ekx&dHC6ZSo%rgk=w};JF+EHEjJp19z$|if%`_n
z?`SFakhv$;kpq2I5D`UKcsh#MafBTx!MdLbwXh)a=yQTqjz%Nd$qtIecEOWm!?|AW
z#a;S(7Ua<DB(@YJp<icB$YOxun?5eG`bmxLx~QlT=mq^LFf`4+V>K)WbMM)u0|bBg
zn^w}-*2*^;GUmbMC~=K;1oA{o;q-{ZsET@LI`%4R4`emM^uEFT+W7IMit~r>vl$-<
zkw;yD@&4=Fk`T9kdM?)$e{%pjhpAdTTtVu|kt{A`E2j)bflZz7ELYP~9y-9pn}DXT
z9JZ4AOLQ4P!>Pyj1yfBgG$$!T7-FVh3A?ztu9tib{KW#N{+o^=QBx)POZ7V#T7-_A
zj1Mu6n=xuoNqc_FCZFh_OV?s1aZS%?j>x?aL7!bqAgoVhb#5(#j)~5v0Iu_{(HxwM
zq#QUzw_hHUH~fzbmgdyk^3wWBG=(Y<TFCWLkMtoz$TOUcI(9+XJ8=uLi#~C#LOS#@
zGbBsWETl^+qoJ@}V%jq4gVFXVP|mz@CmQE8_hmL}m~Cw@5o+^%kdHJl)XkCBHdwq+
zu=FQblG3+_P(uqq4$NwP3vLKpsh-i47qPX67r}g?hyCnj*0jH?k@*cbA`atI#`GMV
zbD*l_93%wX&x|H|$u)(kxAJ#TS<Ash5c0bu@+6KFs4V(b&Nd=ovGfeuXr8&|YGQ7>
zmNIxE#~FwTxypK8X0p6%hW)R;xMmMA`PO(%Rfc*DsO8CwnwP{MDFPWZy+42aMz+fi
zW=l#LX9;`_W%~|1@*5hsdmMdDNKRh)v*FR@c!w$ec=55`nP+OPm%+zK<Kx!po1Ne4
z&r-?aeE1MnJ$#*erYm~F#UxtbU!rtu5O2<7Z4#3L$)Lb>^R~vYSw5<7q*2J29hz;X
z_eC!WIh|LQ$Z|cH0oe4xXB-Tfl6c%F9N@87p+OnP#2ZHOq~t6HC>JZSnc;5g3w#fA
zWvw8ypQ%#ih*xC(eOQf1dgU543OgbQ@)MAI79w>-yPXyGu{dCFyuH`}U|3D=rY8^I
z{`Z}AZL`yFg>c-+7W)LNuUr5e^5wf7O>BK3!tlar0D$hQyFAXDkSV#Er&^^=J$CdI
zq9m$bXqdmd#5dK@Tv~n1r8S)#+pxi?7<kj;B}Z@1GDY{M^{0dVQ^8eXS7xLkV-{g1
z6$AT-Pgaznal@muW_YGc(rvm~>L6zAgKN;mtY~zq_6(9j1X9oh;X{1EZr*f-LI}NA
z7vU$|8I*Maf;hlIWGd|`(yUzfiytpvV!E?05&qM0GhsApkD8Cm<#5z`4NqY(?+nb5
zd=>z4ic+aF?$`ohV|ljKH&qf5IN5h}O<s>+idfchKy=+S88H{U8d8B<-e~83KrUHh
zyOT<ZhETi<iSkMImPY8Nj)l>lfL$u~E8^EfBmXK7fXnX@Sz3$hruIa|?JS6Vi0Toe
zReb3^1-(K}rvppIEE7io^&6vR?BqARgoKNdiPz!9!DYoRzEZjkILIvP;-4tsu<USc
z-$_*Kvv0u1A7%U2Ta+^)@U{@QSDz~c9P#p^QF<vxyNc8Su4c?<n1u(jENXN#R4vF?
zvyA}fjE?BjTZYex!)oa0Z$U682lfB~9fV0owXE$#^ft8N_aUM<s@q|I30F2{bI^dt
zW1y|?8sle&1mMTE=#4AoBmRW3K4w;=5$N+n_R$KU!rx)zun1>1zkbo_i0kdURQ>1^
zR=*^yxVd>mf2cXj*+ZHg^q~&p)ZJB+wHRy%6HCp=>%16S31JPwK&Ythqmd?V;L%S;
zonYtEqwkkN=bLF6?LNUg^lmZ;wgdV>#Ep2do14e%w|6|MY`QfP74ePxZS5c(7qM75
zl%D#-q%$nFg(l&1((f4q(g6T8IU6AS>w*@gnw^91WKP9xob7v7P7AS1?Ac^=vFbs{
zrzdQhpu}ZsNlxOg1uP$ToNUS>hhS5-{kCeb73KJhZr5KJP7~*T!EXGVD11FDARd-t
z*<}!>I${`gTtDr?f3qaB_0-k@P_{wlt5@I)lQbx6S{Zz$YUzo7_iqCOPk|A12)o$|
zpjB9Yg3iCbxw#B9pLC6Na$s@o+LwlX?1$RSf98Ca3IGEI`?K7?Wu%RZ!3odK9c)@O
zjy~(G`c=r`IDjU7`oI}+^0dy4S$KyC43sWLwe3ZJ@H+aMVqfx4EFQE|{AR^|v*k;U
zqQg=m<OEI8pAZ~MJ?{A9a}S$>BjK=6drj)uAegdBo#a>=)+;O@ZUKXsUz_xcyM|?Y
zh^5;dqRO*g(HJ%Y{QcbIuYQ!>$~P%nOj|$&MQxU2;}}B7DWNNE>$_?tpLZ7WMVJ~K
zK|@%yWtqv@D729{oE*@cL$C`4C!L;pyN?UU_B)v=_Z2(xz-IH{`?l?{wxp@9CrJ9@
zTpMqb{tNZ-FlwhOXW&c9bkX)r4fp2xIGn9vqHkt=K*a^=Kai@mY3A_*zzZyam``=Y
z@OrXMDCY4!I0n3<1XczNoC*W1^$3nEFgP@wg&?;T<i3Oxx^gXr3VMDuckOMllwQwD
zqk;V9(<tL|s1?a7{$f?g+m4W4iYn_qhgy&ry8L(`{Vthlwqdy(Tb+_9YtunT2nSWJ
z3)$*xYVsw;Df-n3lM@!9vJwgOTagK2tJZ4^3`%h+YB?2BGb@EA?RjpZ3@)|jxZgOx
zap&r}2DvzvVrq3%<h7B@J=31N>oEqwEMr{n^oVQJw-xJmejo703o~V(tQc1Q=DMGP
znszk-{DBkF(57wXPekG!KIT3?K2oINfd#eIkJVcpN$x@xzw(KnQ+9<EdR<YU^U-+n
z*gtjE&mXohbZQ1w2$NB&SbAJCnGo@mCO&WC(zfh|(S<qZa~iB~H+7x)7b59{oM>kG
zwAuP%kLB$Pio4zi>Ld)zOM4Y4_@^*K@{1WW_?5mucU6fIkb?`D!ldjCrk|c%X=B75
zV1+TDzvK4?EF-P)H)7CI?*Epnr}IDP!LbEuZMu{+&tJo0DBpxP8$<#Z6xJwSCZ0of
zl(|S8Q|rt^{J2J1dqOS8Qcr|1{fPQ<A*uOnlJYTMs2?(1p!tlw(jm`$U2W>x1@PAR
zG_PM~rk7m+h2>(N2bplU^z2Nq9lhs50Vzd~O>7X77%*M3k4AOnB30wd%&tpXEk?GJ
z(rtrr@jQU#D(V3^ASZ<Q$x7~hyJ*7-Bj-qq`<3T+vsDo!v{&O(oMb$2lYv67gLPqM
zs@FjkDv=BL+@fWFzh8L5+70u^s%X|CCc_}rj(+2HM+mOA?sJD-Xd(jAs`8ELXvjRZ
zz)Cx9=dbBJk_y%@tAI)4@?e%<1cAThNeq%sva0zJSw+2R`po#|U5n+HOBbBCn$i%p
z`9rMWmao6Q;98bxa^!no<XqKZr$h%>Gz<kub193%eMrx)PE-M;f|i?%JgS@TW_8SM
zZvoEd*+9stUi$<x1fiH!$u^G&>0wkla$ANp#|sMCm4~T?i#}mdcN&3}6o7B9XiOcP
z(>VvaJ-**xul-mV*L@DHrx&tG8CjUHaXtVZC%P7C5DR#MU<adW8Nl{jAsYRIoMSD7
znYC!@)ecH{um0kri$4?Ubl!*Q+9gu?mQ?I{=}y!D@D_*}#d|A2%?4+{4D!Vr$BQe!
zq0q~fQ+#&Q;omOY`iEF1^>`AXGtY>LqP?oMtQ0@ndbU5r+Qca372R62v&jX4QjjvD
zGmInE;Zpkb<gUu=v+bJ)VZp)LAU1U~os$0nbMb7QfEvi{zvnh4HYcTo$=EirxA9Z>
z@P1yGbqa4_V|bOy+<r?nB+&M@fs|2P)zh}*^(8}!g1ME;5?pzYxVV`Ov>^&^?PsLU
zF|2Q?rMW<3ID7dK!B4|09L?O1#$!EbQ2>8{QC}i*Po=ZlD>rfNG)DoEQp(H7$d>O0
zo!eI$GCWG{jKDL-*(zi^8n+Cpa8|h@J~Cz#6e~f1FvpK}(J%z*pg^a-jVip2x+PD=
zAEHhB5vd`ETzb|^?2rY|HU^bFJkc#j@-EgTMfd2+hoy<MMo8Fu(6Mc1pk{%uWiVK{
z1e+66A&$dM+4QTofmsI9XfJ4`4vpM;XR<C5^Hg+fP&W_l>E?WH7McvuG-)5!xc1tk
zqdL-{ZS^ejlopif;zlR_nP)?2f$_j%-S*1Jv+usTch3Ak+Ln=G6bCj9J-I!&jtV0x
zZ<Z8C)B+iK=;Bdt^n~>C75Ec8#rQ@+LIGj3YUKIQQE>Z_$=JcW&i0{H?tX%d9f3iU
zz{-@zBpz*-&lE2sb>8uyBJF8Tp%I(0nWpY148`8pN(|r7b^L+<C=-%sBN*5cXo-?E
zgy5Z;_B;(oXxTEcQuBe+xD?~%`0`_j_lop0*~Z6~GAv}NckE-bbC5ZzVbKd@aqE(-
z&mZ+KKMXsS#{{M3f??cn1u};gLk?abl4UofmVA{s$)qp`zn9(V_ijV>Q^H#F@2^TE
zfq3{uwdYPLR|T>c9$d9!Ov_MkDbJm=W<w7+s%9T6(w0lv`&-K7;IhZKl7*(y+c+c`
z`il|0`5cju){cD!K%BdxIp^EH?X-Wc(@D0g1^l7MDC6$O^%*eSy8lePwRYyTvS*A9
znfDF*Ecq}|FA=f8nV(<geBM?~^Bzp&X}ibm`9Adc>poLmMu{zW2dV=b>ditfH!!4$
zX_%kgDZEaAiEhZAMHxeafh!S$Cdvdcr`zqQa16=vyeZcU?j?N)PN`P~(t7ELt4R2V
ze<XdGB5zxktOfiJW&i+eoMHsnVE<7N$2AAD7;tUQo0-_CD1787BfY}eb3dTT+?~l7
zV|)h+6k2zNQm`FV1TkQo)LIdGxC`%E1b;#B(s(ZtXDn8Ry`gTzGDAu`2=O7ORC>4T
z2f#Q(1ICtwF42_)vENW&*TOr6#pHjloKA%Z2<ObIBMjEAiK)V{^L3FcH-J0g++PkO
z5MNTY7nw|U7YCQmhD1#-4HGVyPqtYimnyG;N44If-jd#^)!t=<1)bLTxl{i2z>y^%
zlQaVcUxmr9wG>)*ZL1L!sSpV3mY(gi-<o4ej6R8C+sJMvfkM}+F=O6s6_#9&^MJ)X
z_RWiUUkkYX(xuc>axlz2qFdyOflF+bx3a-sFQm>~IUB}-xVQ}G=V3tecOisbGCUdh
zn60sIF*$Uk?&X&U*7m?q`3=C-$=?>tzaapbWZyQ$W_0*Jn%?egj2UH+@8|o5e3et~
z8cX}$03m%kT9{9O22tk~hco6RLDlCKWXKS^RWbRTj!nFC9xV=Q=0}8xx5f4+a%^Qu
zS9IAcPQGC?p^B)t@tnZij?d*hBfUM;{ltW#3=D$m#^gY5FS{C+FR6V`LW5k+_Jj^K
z#kI}Qdh;xeH?k+&<38fxc^q=zCuo?htW-@g#8h_`<ee6E5uUpqf@2R`cE+Z3mM=Nf
zYN&vs%RJEre+sYESdH6kS>F~Q2!N<*n_ls%W>MQjAI8NS#G@5&tL9_;<J;71=*+Q@
z%z3m$2$}pF5V$#bUccBWqN3(H6cA|Rb<PGJRgEz9l(gRUan;2=?uX=3|I(SNw}ON)
zbal4m1Fd9XXHEOmtp(amb7hQVFNe(g)sD7$G0t|{v4+)Tekr-QT%#^wa&wq`aq{4O
zl#Z`y{nt$Sj(K%NiW&lBrK96_58SXrePu|ZH!#wiTIL_ksaflJ<S!CC3cr|y(a2>=
zqRqhYJe}lpdX0<3A?dg;VMqaA*&)sRo+~#tGTYbFxRogy@&-hqy?aEz=ODzJo<J?R
ze@6nj$$iG@wo&x<SZd$f_x(D(+anWzwp#}wCK>6`1XTYJF=BVy&3jAG=Bv!=v^rQW
z>Me*&CWQz^!d&6Azv*HW`=J{Qv?aM|2+Rd4B^`)S1mlw?5txp_Eh3gJNkoQ=i;1|C
z%;pzVFL<DFjVEcy!}Eg=R(EZNFT821liIq3nD*r|L>-oJWD&>r-n#toQz^rM5qS+l
zVwn8B@5XXs2e$wr+jS&OXN3Xg@NHQ=sJp*Q6b&m8Oq6eWj}Nryuzo4XqW5kh#KMIv
z<fUC~Rdtj?Xz6<)OMPbmZ(DmF7Py?T*OFCAlzKs2QH<*Y+vb$!X{IeaoQNfST)44s
znMp)(o<j|P8C}M;esxj;S?0p9hrZJeBMYj;E;9xyQ|@mAQt4qnbf%}nr85W~hgNy6
z6ZB+lQls#wE^$(g;@wzXxg-xha>X!MCI|cXY@mHR;!jtRR-jqyYug`_#kTz`;c(ca
zzTSe6joouUlnHRAWS?5<z}$Mz_b)zdbzWn*Uct;Qd^F@<rEhv0U8XU}9^Fzp%~LQi
zN&@O*YTaBX`PUR0sl*~&;Azqbr6iXg1QUGky0HxAu~G^jVvai-s1$Hig!6~_tM;-}
z?sh*Jc6ZJV0?-_-)xMRdU6gl;I5r3<Su4KyKIeWC(&v<3iWSFhk&JUvlY2*|AquuY
zgSasSq*ORaocCQPiO4l?3J!YnaDzI|F6r7xgLYen^WIo+5lXI3n&*aI4!gIxks58d
zT|wCjLP5I0cxyI7=wD>dV_F)<;+#PZBti1In;<tjP2_7#uYPar*Nh|LwNV2AW-%mv
zb?w`accFGAkDdv>n=`TKRZDJ$W}Tp7X{z{!<|N<1Jq#n=<k?|>WuzFK0;eFc&-zCA
z+3l-$|MABTd1&)FZ*$U)G}xw_ONOONP$D9?KL!R^NdRE+$ESPzvft2kB6I65$F_vt
zI-Jwd)na|WVGPWZ8q5@-9pSpy0J5+~T{8rMd4h!Z3}_1qXn3mqtOr7Uo3SnF3oJaY
z@;8CkXpl^&H2UPk91%kV3Y8)u1T6^-^UW*rKu_@<=vg7c>>m{0tahd4n7J^@{dP$x
z#xO&_c6FNb#$(AA@t{(E43RT>fe^T`P|gbv)FA}rY4rKn-;9b>!^u_!5KFCaK!Ko7
z!$GE(C8t4ld<l-VllO58oUvXFA{tzktt8iaf--R8OV(8JPGVa~wUfZ|RQYYarR*l<
zA~F#`eg(Z%*mQhat6|x)YfW1p1XB}XFiv%5rvE-b#ckK_!qPt6kRTt-ujh7A=s=el
zv?6p%?TPA-h!={+z)r2|UOAXM!xW8N7xdbIq}k~oTC{i~MjG|+zk&tH%I*6ynKLA?
zF={XItTc$275(8-wI>=n?D0GHvuW-du#W)zt$H^u)KEg^6C0_YRDdeT&aSqsLSBXk
z>uqaLPod)bXmCw=eT2@aX(i_F16ZhnLR|Y~C4<tYm$o|9eN_cN$D+I9oAnsUqRL);
zd5(EtYU8kr5h}mBriCVkOD3a-7@itVqdrlYZ&clRGg!Wd?{_~E@_bdl=uWG+rpBlY
zf`-sQjDCUX8Q>VNsSDn+W|P;pfOvUZk`e;I3g7dvV+|6_MjBDRMv6vR+CwlZd>A6S
z+QwtJewGRb2^OX@96Y+KfQCFB@;YHSv~ULbg!#*i?hJq7o_4H!Z%ZewI!<9(P<O5`
z2naAfO&-xt574iq;=QV6CT_UJdb6L-W4{Q>K6PC4nUuPI<v42<HaMa2cBhTBM~Wrn
z)nbsfj8kA`mIIR;G2)4cfG-0jvP}O{UpY^73H}5RF5vUoHRFAwpm1MSuq=Hx18DiC
zMD=tFul=xE@>7VDJ7$Iop@e!B|MB7P0xh+z@-?cRZy3`K%9qhJh^F45?joLe{*`e)
zd($V%33<3PD)`Z?2?nov@0lrpf!ZR7%fvFhFmlaSrm75&<6d2P7K82}*fM_^aNaM`
zXjVP5w>I5(kw88u3$5wSPTwj|f8!FEIOb}9=>sc;z{<}O9LTVCGzAj8Gtw-Mc4>0(
zyzxK~sc_x2IsTLBWk1B9gA+CsrQdRo(8zQg;n3Nu#PuCB;xMIzr@&JTFPeczx)?NO
zR0)<Xh1AP>hDW}<&$>Rb^O~ggK2m4=b^Sg_ojFD*VZJH^O((NyJ<KX)kxM;GO*vi1
zhf&^f(%o2)i<K16Y8%Tk6jn`$!58bn>Fyw+$3mhogy#SvOPe)jYL3PNWs$j}itP!{
z7;aI@5k6+hTI%x+CRmva)L$Bz`ZqI=5XD<yx*q^&2;!r<1vYw4wA-&sGm{BB55N@v
zCP)edmyn5#uq33>UW(y){EctOv^a<=Fjfo3l%Wm@{X5GFvr+g(E$B}=S$IUOoIIC+
zJyr6j7pb=<VLJRXXjI+132sK76wGf4K0$PX1t|k>a9O7xz?Ya|Q~W{!y^e}w1Tj%x
z^QE|?g^z5;9v9zzejy|#{RG7sT63dy;Cby|?RK&Gjw4(|x{f01ri$bF*h5*KwV5t)
z-*DK@$DO;x;dW#lA(U%IaP;)@WaMNS-vTpRErVVmgW^AzNrZiw%J?%GQrr~JW+Sih
z+d5<NxY~&>m|{+^H#ReLkIziIMR8_*)`Me>wWmfH*R`MCy9q&I$JsqF{6caUupZzV
zt(;cPZSmClv^R|0;XKk)lefU}><}x^VEG&+^x!;OGwRsI0!r&wKR8xqLx2JXm)M9l
zf;sd)Ydvaolf3<qWNdtS@(A3~;JT}`ux*kO|6&PoK`C6kaB-#_M~KDf9WYr3t%6~h
zAN|tiwk3|kx8qu}t#G*M4G&2mwSLH=QrbK8eTYP77I)PznaqbaeXlNbrn5Bjbgv<u
zBHL1W>Q8sG8d^wG<{r8pZu$AakfTS>R=pM_(7AXIM?l62Vk{RhKV%;)1<<%60pvEB
zZKeUucWz{x;abotI6RW$J)`}=8z1y>J$M;7DUh^0EW@;k3UUD$xLBSRNieqWAi`yA
zVbRK%S&5O2TngZz{5#6GXx+<lU3bOd!I$G-BPuR?2iRI%I#_GSS)xv3=00?_4Ykvs
z9hF4?4**?2qQ7%R-ek22ERT!1oJYaiA1&J&6bFMLAuA`Q+ppCvQanVKvo6u!E)VKV
zXJmZA2JA^y<!-$C2m(+t{TNCeCZZsDm7tqfDc&}v3%0cN-uc6TX)hAB1Yh46GK9~Q
zS24h75e`C0j_m~{%XSm%R)sa++l_6;(Sr>yw;>z6iKkRCr!dtJ_xia)n+u8>*qbc*
zt8qI`I_>Y0Y6wN^$6?;&jpYZrbsH_SdV@FH(7KzaDB+~&CQ!XPz*+7))7rPs2`4nH
z=xygR#Lqjej0~#uq724eW0>!MV#ZRS5N7XUXbphA=SpplcNeq?13IH9DARJ6zYwX?
zCGiT;gF#M}?jGy?mt+4aO6G>w82(9oxm1wh%@>n?rXAjcn}LrC$x82!U<VpB!VDZ5
z-_m?&GX}+tyPDs9e>>9pg(5lVLu|uw#rAkpi7oTw80<48XrGL3ZOy6`2|F0gYkOJ{
zUqlXJz0V2Sjqi7rqXqr6lMFEEp($K+A)@;STeU-S126b$lWqMavXf$&aYL7e9{-ZK
zOEDuQdkskIV8iUuvYd8f?I107G&zNEOy=&L8`+nJPM~iUHU!1T2aaPr5qiRJHLxrg
z$G&9D4)RD&^-$F`nk&{WL<+@~znaN)(~&lO1ShYun&-f&y0IO1%H;YMM8`d}r{mMp
zbSYq(Oc?ktQ>aieXg9odL31Edw6lAMtBdo%loI<u;&<Gsy{YK^J3#Fs&j0H>vpyVO
z!sfco4xO9`uobvX;~1L}=QO<}snVC-b|g8}!)b0n^%;v4j}jF%^TLT9Nr59{d&GpN
z=j(FQ4+1gDoVE(#m^<@V$A!%3J{q?%XvR|wmv;0!)u^m2-AdhOE#L6;{n7Xmap9dn
z1g7WKdUbV>r7?o@Lg(dskJ9LSLG3kjT_f)pF4|OL)t)M~emE5Q5%S`pA|Q2rvk5|j
zK4(SEk+<919ww^*a*lPvCTJG=Gz#|6F*U8}ZU6yBy^9S+yrU3=DK5C2bj>5!EC6(!
z@GNN#o+rG~di{;8kwOKA14Uh*D^opE8Neo;1TA3Hj)ke(yj?fYVUAo=w*2Q>fkHIA
z>fduYIF-fc#g0740JRGz1AdH$Cpq$<A>vxDfB;YW8~;+3Lm|-d$yOYt@J63tfU-G-
z5CEpY2KQCsfmrUdkGXI{>>7iTpYLZ*rV`Ud?q^j%i(&vp9B=|l80R5&ps7~NT%MPr
z*IuY%{_{3NDni83?^jpf{;zw$2^qBLnSt$31GcG|9ZP1)#P9$B1hA3Uq(bck)d+9_
z6Qi2pjgHHY@v=>JVVyq>9oD`UNVc<ukV3txe=buxt`oYt`4sI_qwK>c5m5KXsR5(2
zWjYErp9DkSa(Dm$0VqN|XlhD~xr#zuaugZ|kVrSZjaUzQ9({tLwvue{+a2McJz<@i
zWMI)7;2G*J@e-KD6a;|U@go$fYXhiJp6oM9m&_@`FdpawVWJwm?*%CDG8jWAb2q=;
zea<zUBPf21f0e1veYk@xUjhKoZ~dA@WKT_AXth#%P>x3IfuH(vv|;df!pMZ`7Qrq$
z!Nktk@KlNZvnwV$MA1jNI>7P@WI$IBR4keZzcz4SwKh!0LqhxaBqLwGx=f|~qA-+C
zu|)h!ksW2;`M7*Wile7ZEf2_?PU@g46Vem~oCTg`bl+M3GUZf8n8n^W_~4gchRK%J
z%^ju_&6~G!_yc@q@KcbUq^RnwdG#D;(Ak_HK6~)zM$JpsQpzJE?t*y$e0=vCcB!N>
zhdR=ar~4S82<hvt+Siu-Gk6zn2sN@2(Dz6BhHM#tv4h5iS~Bj}+G_m5PB61@%&Mvl
zGO@V;XKI9%`TeJ-H3fvJ2KP|hBu`7;1+^gq1rSnu0ycBsW?>u@dRE!DY#Dl+8{s$F
z;%p4>=R_|Y%bTPs45B?`jW*LGkwFnAJ6QUbP}kY-%DLyajYz>4zSD|-9^vv0%Dl3x
zmZyeZ=b+K&jQOwk<%n{3Rn?Z?2(@~1!#yY7{R*Q?T0%Hl>0&f%Uc&Je#fS;m@@fFY
zQJSYTQ#4=J-VhxnNjYF+2OBvJpM?r=B^c^k{^_d#Q(211SSBc?sIuB8+HCe3<3gh_
zVz+PC<#UyBcwL;)bKh<>h`0Hfc_kL$lMoTa_<-duM7R(755M*Zt}PP+QRC#b*)eRj
z#mv{l51FJg-BC&*>wC=(R<bDyVjOL4R`#l~8`jnmm!7Lkt@e;iudAwl{(cPHm@BP*
zDk9MK@&^nYv&J6UFnZ0fDs3E8icloTqa8ia^)j{Yc5SnC5}h6`YrPQEfrs|w_*FhR
z``kKIJ&k{*ud-QQdR;0|I&~pJafzSW24J=z_5e8|twP#^ZiFwtI|QMUr*I0}V!~EX
z<R^y{w)gaYs7`!}-{d9$;RQvoFQE6u&%#!YF_z!1B_FSZ0>6vCi$VM!fCDSX^b<P`
z>t2Tu$!;Zmxe{d|&N}Pcf5ifu9|<hl;U$nnCrW22-~ppq58CC=c-t0Wd;h7=Ii6iL
zxA{!gAN4qE?O=XeEgC7e5NkRgA7Q#Zx#%^a=>MKZLiZ+}7RwVb3ES7=qOjG-fDP%$
zX3!(`T`|J7!ZB?q6>8_1kJ-~I?l-ET4&DA&<P}j3)%e?PqhUs14OIOBeGYo8jGM1E
z)CEM=o-&cx*lCHm$qxn4P}g;$=GF)z@1n&UB9Dqj)ffEI`CvoF-jt>P)W(*|GZ9E2
zjwnz8AyR|a3V5g84)t<o44x_~Te3)1;)h6chB3YZIqV5-{sOz;aCImNiXpQkfg>uS
zsaM5i;Wwz#vw%SMNC5~s3P9in*?*yJ2P?|r6eM~ul`o(UkUnSqj^4e$w8y;tApbu<
zceia;_FcaE2i%$1p7u{`{!%C#2j=WakVPJDo~8MADCNu7K};md*0R+T3>aEoTii;S
z{6JD&#psgx(UBd(UFgF)gl3mcUfjuu_cpR9?1W#~_@U|i5OOjWz@1t*vEBsO;1-55
zQn}#eA>|3tXo}#EiobpqH(=waiXBVA%q7s?{h!74)|{xMc)^9F4A=ob<<;X4)F!*2
z^3EpQEdL`5tgFfa?)3}ANjz4Use6J=&{p~A5(d1#c+2Cw?n0Z(8!7lEDsR!Ki+7Gg
zU?lo0;9zd$y76j^uP6>eF-1WcX{OLQT?k%?1_zl3uj#?>sIu9m!yZ?B=6NPL_Ihvc
zctbFo8b2+hFR9H|e}jVxk#zRJ-WEQ%Weu#HSMR`HwLtRH47fzQ-Te>%1z7`4mzXhw
z0za?koz@5!N?p$+Sq`$vTEGAR000^p8Vc>}4jTe5QvGC<!g|fjyi8TVua_+oMcU|o
zEE?kG;NEsHmeJ~sx!1zBQ$C-AdX;tfL48y8_XEXnkGe~TilPMbj_vZ<snqNiBv*$C
zksU5;nv;=J@<d<vbp3d|t=o8lx{fx(SoSv2zu#W$n4LZycShrA``yf!Q)u;AYb<5}
z)2{V@!=SGZW&xjzgofKq@Ve<N$s55blnqM!7CY>iT-gw{M8<5hGBm`b$NMq@<F+Hg
zDm2dMc^rh`XIy(8LZu6_ofwrzKm55NVVCjt93OpVDQ78@@O2lmvhex@(hhyNPOgC9
z(Heg7{iy)P7UI5)h(pmQ1q^N9nGNK`*yU(AXY)%;r!9XFXnbo@JXc`u-lbf>>wln=
zy{&`5-PSjcRomzN%829Ymy)H*M>0G85Q~%RT!J=g3)7m(Wnz(%!b1B)#|$f?FcI~m
z&hV@SW_aUMd6NsIS>VS^Vr(IlY%OV^OaK4?KjT-w=!Try;qcKqA~bc|C0OlRKqr1S
zLF$sV2G9N7I)7KFAbiNcy>h7VAvZuhDc{sa$Pl*W&m}d*G5Gj5ghB$GY#1+q#Jn;}
zl*tCC&Xu@LRC2|5L5PHEdQHdvT4%TZ+{8saGS-SL;v;rLfC51&hhJ7dG<=#7uB)c#
zpwG~&(%5m~y8MMHn(gfD@aE{%5zVf?d8x=6t5$q_*Fl(;y~aXX`db|kWM}mPs(M?!
zrr}4z1_iaGPVdbB4AI*R0001sP`}ac!u^j$-b7^ricn`v<}9ZA>CO0I^At>!(&%+m
zaXE!@4(gjU2X?SMeOdx>eqx&9d|dHsLD(3V{aYl7h4<vJxP-K-q0pcLTn_P(DU1u<
z7d+xTh~FWHapOVa$QMggXH>#x`h<TZ$+<D@cKRFxXeMvMs~(8}Qnmr5!hHi%#eS<*
zk&I+d*Qe)VdNZrETU}3BU_DO{TFs(m(VX=(Iv#<f85!I6X;2QWr-h3L3H0YNLo>QP
zQDvK%<NU*juz_)Ln84$aHQkiZ8rqG!0of$jNbm(bX;>QlgaSLNq>Tv^*8yEnnP-Ea
z!82Vl3Zf=_0%$JgeS~Bk0Jy+DD$5Q^w@JGq4sW}fTA4cGP$}##z`<c4)z(-qF@D(J
zg0C9}+D4WZk|GY(y7c$QeK4h)*O7A|cr1=9_dJZ|rBE#vd2|vlCG1II&#Aha=lzPe
z)~s|%9=C|OC#)c^dyv0!<a(Gqei;(V8vtw-$pjV+x0t%a$;wdxe1uG+UDny@Iu7))
z)4HWYMti|PCb?fsW955j%6wBC#zErM6}R<%>){8YQd!=bSNOK~+(7cz?U((G%+k_U
z^L1Y*{ttMop%XhcC}^YaD4x7yK|XT1eJz#AQ>i6T{Ym%!E`O@Mmo5Ax0EaaeHu3+j
zDQ8Z^Fz3>T8dn7FA5c$DsxW|hCH-0{Z{>@&yZp1~VJBr}9AYlNCr%^(ha-aCs5LTL
zPx4;Wdfs6;@K_7hg)~m*avt$0;#?X+^pV-F6<Ni0x%y~IQ(z6X%DU1*m;Pd5l2M-A
zM-2AlRSOKZ1#wm%Pg?QZ(vB}?UTotz<H|t9@Yy`J4|uTBP+9oe&RTAq0cEV(@X7xD
zy_*H#+#?9SNer5vW8-LVe~Dw5d_-E%6hg(4|9Le(pS1)Y4>&ad;uT4BHMep^m}K-|
zSnK>`1SUy&2-ux$w!wbmJe-NSPWQglkDE8p4IufNDBYl*n>jZ6!xN6lcC^DM9U&1w
z{8|aIG6r8k0IOZ=EfH+g#6kVKti_gyjGu{D&Jm=_Hl5)TVU!8*nGja_r{!M1ZRjh}
zQ#TL5L1CCG{NbM)TW=br{qODWALB}BBg%nW7ajTTmFtGnN-3d%uXd1Pksq&-@x0Zu
zVVFQ%pz-ojxaPM0d7VtUR(*&hu-CwzETL$sBRjh&K^nl==f!&M8=CbX3`ruy4KNnf
zE8F>j9n2=Y(A^{L<VY~0)Lx}iM8!n3^mffxK9GWI+Hyph=pm+HWwW39(V}#>8Qk+6
zF_^<lGEZqi5APoXmMXS`CNvhnr0_v!t?{K5&cA8HnstC4p~rFnEbkbr?VD2kYyy#?
z<!oZvESYP1K<)YX3&2opaw&6w97j2Ufz8(_w8)h4mhkS<AGDR7+IseVa1eL*6w~+D
z-{0^BvOeK&FF5;sM<&0}Jbqn^{ny6<bc4b+*|y|MF9dQ}jy(Wy?ZXE$ik7c||6uW+
zHxWOXPRjz{8{}(<J+(sN%d7~OgY}&NTBiJ^Bec|RV8f>pk~E9b()r&x7>Xk#jl`z-
z3ZiP_pFSd$wEi0DFcvNC_4?uFvN_3Ca7>P-x;`CT?IxWr;>>>(o}y%fJ8l2DZ8;Zn
zcydFW+eSo*rxoYp5VTW3L*gib8&wtB50R`%T}jhudc(o1ym=3>DaJlU$_pUM-F4yQ
zS0`fr*mkM<j41Ej9LiJeTIi{tvvuX6FWeQeq`C7upI&i7oK-sp7uZIMp`dv0U$7(q
z>o(WceZJWgOxi0n0b0U#tmtSq!CO8f&4MV~OiC#Y;u@v_(DOfpZC+=EBPJx1Hm&pv
zYqN+vO{)=7lpsMD&Ts?cWUcnk3vxYKr|^z}I9dfw`n0fLYxS4_S3O4O90aE)v4thE
zi;X5dgF;-a96LD&<j_7dtkmx;j#fe?D@=%oa!<0_zrn$-7U9N+PXDh?mZ?=X>a)+5
zICoGteGwqbEj8c68_fbS2aG|NK)Pdapm3d#^UdZIxfM{$Oc4atbx!|>>RD)e6OtpI
zdf8%Uaa^Fhy#5Hgl=yPvL00RBMUtHTBMBzWJtLrzNa;E3;aEl6@FpPj>t%9pY7J_q
z8qkNOp1KYoG_cx*|6@MAo*+C`v7gYheafLibpX@gz0lX96E)qcd%wy#``RpwPSz!O
zi|9r_$2%H~Hd=XED)GF6jq(0EXt?gn9YNvdKIcVaBgeJZ(&++Yz*C@6H5vct6+5-Y
zqeFLx3jslWJ>0jT8=!}rmPvBIIzu=xe9%Lp+X|I0JijY@_6GOWj*Le#ksVN<QTXcn
zh@>Zk7}x)Ac$e*qBMucBx^ytOlK0gX@EGPnEV<gtf|{O$oFe~Yr&ZfkRv}7z?;ijG
zT6F=v{Q{#N4jzBscURXi7&V(%HfxW1_{VbL5|=AkJ!LkaqL==5IZuM58&ye|^vk9x
zT09l{U=%eAGW^H^T5q2^zW8wWjI}{<KPnWr@iXw(ClowHCP(3KngH=R%y4LNM!h=3
zuwBzS_Q;G5kxr66z5%g!1Fzs!77m4I8f!Wg-_@x_+)#|qO*q9rTpB-gkDc4!6H3KJ
zg5!m4pBYl!Q_0*SBL9T(9Zl=7w*~!U1|wTgsR+IHsJV7(w!h>VAVkD3lv9cpBHgJQ
z5ntwRbLq1obxb$PSVTLChwWCE6ajK9Cxmu8r)@+YGB<5ej1XhT;!hwSE3b6Sz9I%G
zA`2F&!>C1?3wvBZq<~pV%>KvULkC28nD#O7YJp-Q4I*=SL@(~;H~uMI{WDBl#uEbd
z*}se!IzEQW%}k7E-g@a4q-%K5Tsxh~^y4fshj;!<3P$1yXlzy2hcaf71`VelqlxHw
z%F7mlspWsgPSQ9lDc2_vv8?u<K{%K7*h?e-GucB1IV$A<Gv8L`FuD*)rF67?Ro{fc
z_F#MpF_WX@oddh8uj@VkfJ|^SIz1QnGlfPZ5oF<HK_OU%y|D~`h$b9wW%?B6D`1-@
zoHRxxhi`;pOL<Nv@;}_5O;EIq{z$nV1*p53?hNni4&=IxwqEGtt{x%Kd@itRS)I>o
z=#Amu)J0SfvRY#nWNR216l{Xbd}>jPsf1*w{slxvuYjndzErFpV453)kF#jm<Rz%7
zk4sz~QaKM^B~T>^cK}TG&dzY<J6!*f5f%<ozFPlHcEWQm$@73VAux!7{$Le6C{;&{
zl<3QskymVx149Ha{{eKd%6o7-Vrt%u43BrKuAD8?ka+<BvCF5C3dpv2hc=jicNhb(
z1@mqNqRg3Y)42TeJD$fcI^zv7_T;Ng@a|u^Qb@utjlFPlb$+jCuK?GZb~96rPSTxM
z_;;hUvi>lBI8h@I#f#lEu6qsl3N>rGFAh<RQkyFFL~-yJPy6FmM6`ty+{9^Bb!ssE
zyIb|7$@Vw;i4DjCy!w{}hl*B1&?Sh`uZTZVJ%})8eB4Rt`B@t0R+Iz(K7{$8MiFuB
z%>s=cR2>@$BvS|Pc(vYR2}vJWtOHp#j!l%ge1KW3d~Ffn>sdrV^;0Xg;zBhQHbkW0
zPh0KF>o$iCPv?cEu8TvXM87%j3Cxe&ccWQwF1<z>p}s~5;+}cXypf(apx*?bm7<w>
zLtSjQ|DOxABJEh>e$k?sjVS2#zv2>O3YCuQ*vO0`PF|@i=FVB~*m<uCKAck)tc&;R
zC1|*uMEx;(vBFMvLBpkZpyJE5ZL$%203SVmiKbr^?oc@+^NTe}a@`tsIZ$X?aOesJ
z1Ru?C%TKg)SjVjBM}mMJy0#wv9Gy}t8KR=UW?UttFJd0DRsj)e&SftTDP6^sz@&r}
zU<5BuBu<qB<@LX-GoMO@d)c0PARIVo`Nt<&DuMOLRX5c^(ZQ`HVlrCrhOE}$mugt;
zLrMbE*rzfvXONq?%Gdk#B)pf!rxgT<Ayt9Dya<_@?Z~=nHL%Iw*v<nSVT+1xFxI_X
z{STREs)H8j=_th0fA>ZG>@|Z8Z}qN8KJ#!U&|<HmV480?pOP+Im|rPq1Q2OjG84}8
zPY*6iw^AF+L;azi($`4Q{P1xw)7E&ky(y8Nvb_1BdC=sr6bRa!nNUy8-I!k}jpPTt
zcG5Kbyv_VVg4O|U<YpFdz{r|abh&;L?XX!aos$YEAK^?;QI65^bN}c5_Ld6L#jxjm
zlwOyMd|fs{o+~Ga4rM7k{!s5R7kRk75IrOa{z5Lj6j3b=4iFsx000DdvzS+eIN2&+
zV<8J-V6;5_)GIpu5O>Aj!ldj7$BmDX6XR(*#}Ossr>}lUczJx>vahQQD#P$@2vH0h
zjzR}<f|{2XJX95ox)wsNB&(ZPNagQ&leWWP(Qdp4!G{B?^&RTs|Jol?hSoR0rpdR&
z=Xqa#WYQXqnAOWpgmdRr2NHz^GxJ-98g{D-qg>p=9oJIUm1Eho+?!}~)pb@_feR~2
z{#_Uo#~Ey~xY50uh&<x(I1K|=Z*4d$1S)j%<H8v$9{2MwM3}e?os3^uu8YOAAiy(@
z>9w3T>=4EDCZu`{GrX_nAGv~RZp;Lo)~mZlV!p`O@hQW?y-T@(0&1J>V{i0F^MpTy
z=sM*yLxQ0JDRadN8X8USMgu8YpPGVPI?scGS*X<L|4?aTbes<I*?<55I0V8^?R{(@
zTCS76Ta2&syCFko3;f#RH1lgx4gK}YIByM9O}^4e5O3Xpv-zA{knj$lx!B6gV569@
zMrHodnFFYy)ZKcOpzNrzZ+n(8Ltr?f(w5($J&v}Cm%W0&B0Lu0Gw&i`wqtlD{D`gl
z=UK|uj-9``lW6K#hPrLR<2_eS3&cz3J?OjQBt(8c5ye5~jA>ks!NWkusMwn-Y^d1X
zw<^^;Wg{0jQN5RDtqAMnqZ3%0drqj5lmZM9h_9!L{cI;_4r{t$8Da>AW0bVJeq0tM
zuyl$<XpgB+F(SePtxObf!!7E&t^yg;Af?e#2)ERs`XA=&4F;6CV8VwEgXaS{#vcin
zn5i>w&9{GSO_5=Is@Ky~*B&Z$c?ZHLN6&uBWZ^({%UK)dc321JX`L!mxB0RP!QdR*
zZup=802DUYEu)lC0NSj1<+=;lUe#O$e_9e};v3oKrWm<-1%@U|Yh|pKZbD{5Ey1#q
zMk9l^6n-#8FGN~&{~l@~3T5Mkgdr!rq~AtXzbmE30Ig&HDm~<+dXTqgss6tXstW2}
zE0m8ojoaH47nM(DdjT!q6dx(-CpJNm94utldKsyv^u)I3KNun!tcGy~K?d>JUA7C|
zv@=01H#5NNm@C-aF{(-sZ>k)smg6eMUN6W9Spn!f%_SDJeHi5tSaYzz+p3J`-T;>1
z7Cw0?hWJ?+4Dz-Ll-c7xK!MH4K|}=#9B3el12VtE!j~kk>>*S@DIK?VHjjfR+KoCB
z9a7*d{pEmaZ)h0unWJepv2B@mZET~j1=Y+un|AsXmcbe3-eF|GJI<OWiAC{x$>ZSW
zGuhnXvOT>X6W3H`@tzbPcbW*l&0}l|#n1e+{jP7)GvPM+Iv^y2g48d&MnwcQW}}D^
zU*@*RXa+I#{8!|4@mK6`+jAt9@=ATZpyemdl&sf}3L#C-HC<vWFZZ!CHu<j@b*{}C
zS+EQWu6bwsQOlzju7XQA(y5DJQ!9I=$4251M}7Z=Bn633fB*mwM>S<Hyqr6cbL~+V
zP#L)i<UoCX+E@mVQ^%`?xRV{Quwjeybkt}|Yyx<pulUMvL_P_ck<__Bg<r?l10`Qb
zxPs|#4E){D6cSY;bE2c%Ti=>JQ=k)Xe%f4;PfMwjuG#OlJl>52IP-SGa!ibqCz+KL
z3r%JXE6$d3a*f`0;N1n9_4RQy`>wm@u3rW|#pjXrS8Sw&>EyZ2ih?}@#-bxs9Vk$_
z_;bv-%!<nXwNl@bo#mWzGjnP0jGWo3Fu>y9-L2V(LmyHZzinQK1>rSjB<ut*LBhZr
z>5}K0gU3mr8k9erXU<5%?N-2XB-F#|z1-oea_Of88+Qg@e@&5xnR$fp3__PK-H(|!
z0YH^^o$b16^QX5^RunqylC*s1{@=|nuuqPeZZ6{&JRycJ?fRQd^T1bAkN=-%qnkRS
zi>k{&Wm{GnWrZ5EaJ<T!o6Kofvz4=fOPnDxmx`nwf4)Voh6yuVGVK$o1}K}QZ4}D$
zd#Nl{k~7t8D!9}@+nBE;*o9!>z>4jhvFgdAX_s=d%KsgxBGr-BM+}Z?yU{TYgy_Ff
z3UYzB5U2A{z-EzwCuM|<pQ}@S`Eg)gVg^$Y>K<+29xoULl>!7fFD77<xHZAS>CN%d
z-s2^)E;~b3ttr7KCU`Xk)YD+J95it3=&Tr8sDRi23fr>>Z;uonqTn;(OqMRUXvlrB
z{WX`Bm&j#2@2G_c+OHu<--vF2nX#bg1ZGtFmIX|Ge>*j5t{d+e?WbarfD{0-MR0wS
zm+?vDIpP|rDqQiwblbY2N_sah)wGdh9~d-D8ZN9KM}?DA20pI=)@6M9G-j5*3W;rB
z&j?yt#3<eaW^wSB63#++hU8u%1}U1x#uAM&fOT=@+p?*o4ZCF)Y<@S6X!~ozf^v_m
zZ6t&3+T@q1j|Ih*r8Com-TqGfvm&-HtuV-vOlt7G(}j{SikDwwkVX)_n3J@H+c;~B
zOPR_MT9prWFz^zBQYUZL%Gyv1BlYZWUKIY(<aDQyK;Pwg6+cPn`Lo_Q1$zUt-<xPI
zy!9?kUGf9Hm%!j2JzPxmb_q(?1{H>fYagXZZ~K<?lKKKeEpY;$A<l)n0{kZ0I<t_3
z)V}+D0z==t8&!W0V-B#?y=&jW3)$=vFehYdmOJlQ<(to}3f;Pa5i@{f{vn0-0bEdm
zA#{`30Y+p@N#b4jwB#@`G9<Rt00020hix*qJ`Elf9-S~R5ALc*{^J*ehC59eF%TKV
z8Ey&l5Z;|v%k{0IvUiP_C~X3L4iMui=bR<^1-r^N(+eC6uW6vk7`6i0N%1*uYpRdl
z$nwfVQ`WokP~$dv*6!0$Y<jenEscZpjdNdZ21vXjxVN9=0%d(m90gGkPt-5mOW<xj
zzND`^lrhP6sKW6<SI}WidKaPR(zjt80`!5@>=Elfo9B3trm`|m?L}}n+;qf17=hR|
z^&l9HZwyr@jN1Q_aqIKksB{PQF{Sz}(Sinb09-UFZaJEQN?***v&k*u`+2wgTM&5t
zt;z#e#lp9nx3obMASXS5HOwv?Xdvle7Z?pX?O-3`DA>b=IX``hL?2KZPzL=#hbZnE
zt2!F0gD-5yHC5zhq+LeeI5PQGP}PDhov~ll<OsqPM7^IveE9YWt%aqy^O(Lf0kXj*
zwzkykCs~H4Ar(iZ+XHug;!|Eik*Sz)g+vc*LNO-$%TrtMOqd*3I4cY(%4ee8u}UJT
z@06YV^U6V}1UL+7Af}PfM;X)&r^@@>(oegKhp)D8=LWT{zJi1sTdzEF9&2wQmaw;I
zQ(?|b@VOngJ(WSQ>S}s$e^O2sfg<AZF}+&R!eBVJ)sT3?AZN=xRC^pxzH_SRvVTVZ
zPZq5iF$uW|QtffEtOxlIrho`~kGZy<JJ;>TpRT#wX|VxlIBtBcz6>dXb=ribWI$Od
z<hKRc`Y>jD+FYq|fE_Z~!~*Za{?PI<a9og&P)GHCSJd5IK>#cB@lKJ@o%~);h$1RB
z9yOs`l_c^~#gn{(^p0`<%&m`TD?PAT5a^osct&-Sj48B4vhtz%Zl_7okJ-0@oo*uC
zAfPg(59iUI>ga^clhIU@b$_A3B4AHL&)2aD&J06w5AnkvNDa7A4D%f^9(XNQg`QXH
zEehcBm=$?Dc3U3^GU3#1@MJRaJh2iQzrINI5p<17k;GMp5eP!}l@Pqrem4d#)3k#F
zOs$`R_WCUd6vNNh&2|6ahWyF<gjmB#$7{>MenFsH>=MnfQ7VR6Wci@=Rscap;Nuuo
zkdE2I2CC#Z<;@xQDaf!y0004QW{=YXgQF36XNil1&TUMsc6{)mo_rFKV<GFMy`z9T
zD;xvbY5Lm@Nb7I`+JF(~MXLW2l?AnlgIXfnsPl8tohkgCih=m{Aoo^}nUlIQq(CCA
zb`-(pIW&`G57E0w^4%tDmB~s2%|w91$`BK=Mn_FA$5hxOWSmBX7GSq0zp;<iU)l9E
zJLvj4gQ6+?xPv9Hr0cn31$!8K-D~-M>S8eN#Q$6$R$P_c;2j=t^&2-+|G!q}TK8>7
zCkm1q2x>i|&mr%Zc2;T$ZELGnvSZ=>sLvCE-FjD~4o4l$tDVfU;)y=fo-jv|2sOO%
zLA>(bi(F)o*=q#mJi)Lzb26lPVmx!DqLt1iK)gSwj2f&d$OBpm$sLo2$v96S5AWrh
zzg)vT+;K7a<^AHTSp;7oJA;Dw*%~J6?`qM&V$!nWD&Ip<QNu{Wra;iuTJ*$d@%Cns
zM!Fk-OZAL5Sn`0|baW0_kcXWY!{HBdR(9axN(%5F9x@P^Dy{Si12Yymm;v=waAR*j
zNkW~C83+(-)_)irjz!sJ<17!|FA5RUw{jtaY%p~_?=2hhuRWC)VA#?Nr&U7!S>2m^
z=!O1}TzhWVv|oE+o*#&TuKS;&_S+06n3zQ^m=lNo+(4NrdHpPNkHSkEHm#fr@bx^>
z%+volJ(+ucTCa6CYl`5bc{F|zI4LnNYK?6cZBg$Gw<TJhjvL4UIqS4k(pI$*>qF!O
zk|RG2q~FL&c-qRa;Gdi-Ijy9eM>PI(rfogxHg=USc3Hp=W`GcZDfr${c4F|!W>9TF
zjY6|%Kz4vrU^{KCW>H*Ima~!LGc5bZy_R3a>V87ONCW_7e%gO{CX}DW)_28HzJQx4
zg+Q@Y!avn2QVKPNt>T8j-ckJ@^d$rw;z9_8q+TPNb5)@m77srxW&%Sk;A5r<Pie1c
z{akP!aEhxHwaqi8Q8l)N&~_ot3M0xb)`AuY7ANEufB*mzKGztY&fP7RFcKlBJY|Qv
zz;ubucLAwFs-vgG*7)=`En{n;|I{||_4ijVOsQQ|R{y@B6m#$3Yw~6>p_!$ce@|F%
zqj2$0T3tkQ%AmGY(9OkEmjU#etBNYUSuOTZO7p(cx_eI<x^6u{i-X+!>=OyNwb_$-
zcGKQC0TN&Hmm(woVnF4`kQInCiHn_=4Tor-L(JyLGL(!L{M^CIXbtj^9jg+1eeq%T
z05YCoaGx$(TVx^|3$_D&hd3b{N4?O>+_3C~TeqvQ&-G}50j+crVP+a&+QvcjEXbq$
zFy~kk4v{`|Hezf+(00%XPwP$XK1pS0w4`V<<KCtgM9*gT=a7Ss@ObK7%GQC8tDkcg
zUW!9$2jFFE%ez#!CDFpe!rIg^acVVj89F4d#;a;6un$A?a$)R|+J88-^JlMz7Y{Yn
z&0^r|dT`}98b2N%7#wrADwNGU^HXbWM|s)h@5P@<X2kTU8W*5W3oVWG{=Lgp)DZsy
zf?_eh4_0ItrGGwyrsy1wzVmlEd^y>8Dn9<%B;?U-A`OYfPzR%c**c*XAlsY4u~OH1
zae#Rl0}z1OLG8zGWzFgbyrx5uFnr7~kqmEZlg*B5)D<0<1CfeqUe)eC2n!#JOAyL=
zYV7*~unBw}1`4<H*AOXa3Fgl0iiH96PUwJ1Fkqc=U$PtMH_X5=-rb~!P$ce)<eB)7
zOW1YZ<y!YUc}ls0F!}Rvth@RSF8Sn@Co2n-x>Ib_z$Wy~mKs8V6V;Lx%F-GjCi-Kk
z7$5QEK<}PFPy|p>^UAPxG*$l<{y{U7dP7*TeAA=nXrePYjJ(8xbp*Pe_=vdY<`P+S
z@&S6d;RP+<2vd(kAMKo2fdRO&rSnluV^qnqG&YVc*fda^n*7@)jrf-6nA8MZc2|7^
zD>8DaXsS&?&)v0W_NHkBk^Vk_K#a4eC)3P!`(AZ!$SlKmj6Y<4F|PkI)lq|%I#kt@
zWHU&8g6dL|yuw}I-Um0lpX~s-6`W}{oxxook70DiESsBK)xTEXF9wJ2ZHrLCrLV)3
ze<N6^2T1AFaX9JI2`S<}r|viDLCaR3n}A{u`Yc&;DCRK=yCduJH&d19G8UxZvsJ1B
zN@Pg4I8JdqBEc|yU5rc6GRyh<ESqSL^`oj-ZRixm%f1y<754y|3oJ2WbV7yObJ`A`
zC!c5M$;A&Mr@`uyLYRJ4a*os85DRMnI5bJ{OgUJzaOAmy8)^_1@b(q~n?~GhGwoVd
zcQ<x1;%F!U?mrCE{OsM1U(qE51FvpQ9bAm)&$+aF9JE52AstWK+sM+V$Qxot=Th-E
zgsTs22*bTVkHqpr&>D3e5v7HN8G;|avY3B@&{_YHtI);+z}#r&Dk+Oe)+EXWiQbS|
z5uv%PpzJfL-vP@xox&(moe7#G(GYN*4O74X05t!V|NIbMtsNzifT)g)82>nrTCd4w
zpEc>wsUd6KEwOT}GRGk;b(x9Dg)`y7L!;|4XmftPmZfl-<h@$DA7A*e(M9Y-72C63
z^J4EQBXZH`!!q~K(OB)-WslYu>j}ru;LSARE}x~Q0f|m6Jvp4k?N9@mzZmL6G+|H<
z)n;A(k53G+)rgipvp2Z|8Zj4jRMNf=III%x!9YGf#Jw6Tt}$L7xRZ56kDZGW!P#Xg
z;<qH__B`8jlleO|O~Iz7DoesQcI0Z(V>8j>?g`%fgXOeFg2IpxYN1LYDx*Ov*!jib
zJCBhxj5`**_$?*gB;7?oYp*=PpTNv$B9<LZV;ZFX^JKU+=AeZylXr+<DM%c4sRTY!
z(~2}4s;?iMlb>c`m8kvZbWbYVj8S$(=JwOA^{P3x3fY={)Bxaw0V2PN7g7M2EXANm
zbh;VejD6IZT=nwdBSVF@^a{vM>3c=wR(c{Q7bf%wiAE>My-QQN9t(Wz?u0^ygv+;C
z|7VzW4aQKAyLIW2v5SdAs<`}h!#fTb-)Ht*ZllocqhgtaQPxel)gXcQsZf8@PR=ez
z9<9}oI_Hl`O)M+_#iL}a{%`CIDdbV>ITND(4gWCV%VpFGU0+|EY)$*vy<O@sM6~;W
z_sy+FhJgQvpb-hi=7qTlp?N!%q~pJnomIJKj_4FTWGC5V^Rczgm$@Y}%3nhNY^rkB
zgxQLi3*Ow*6X=ashK4z>XaZ;qj{i?X)+OEhoJ?&AVj;#Xbz{@?<QtvA+)r`1U#X}H
z;U^x-gEMNSLE5}vcF;fpMm#*Yj8o&wxJg@?|Gs>W)x*}+n!{I}$2C$@wSHdFnqb3N
z3^qA9*WrUqgy@;7R1^1jMPC*s9GzEqfI62<Vjvq{i1Gxcg`E`iaVsO*eYYi_Z!*?9
ze(OoTJzNUM6dVx{EuD-9?Tx*Ulv|&httbyg_X<|1fNhBy2Af7Wsf*c9XBKJ9s24ij
zl@n=gYo(mq`Va1vjw=e^`)=aLehY+>tyYq5siPTXHf*kpP?xAJcDi8`xp)g_K!wt%
zL}$Tb78zxi-vV%0iT?s4Ib8z2*XR+azW=NPyt6F3QkV}s<DLHTh`A;_l3WA#o5d*<
zJSzhvcVE4-mge}UJ9`#J<+0hBT8NFyJhklgrw6-J4=4@3+V|ldiqry2bR)HLl+jk?
z`OtK@)%3hjlWO+pY}{6P6#Q)k{ixI;iYWzp;y+ygGn4Ci>2Fs*{b-9`fx`G&gOFk9
zPTXyb%TK5ot4Cr~nQH2;W;am^zVcn7@r{~3RfbE$4970GO%x)&v{h$OHn3-mA%<Lo
zdHI!PccPMeDj`N0Fcx1;Wy98;m}7_GrX>dl00009_GN>zeG)^pF;5e_Jfw2TOzfBH
zNV~+njoQHJBdo>te(0N$+-Ro4GcVyL|HURN9=Fn?=OI#{>lyXBK(uY4qyYu)d&U13
zl5h#l^qIXT)N^^z)|7H@_PR-Z<;t7EQG2t22WwDNrB4K?GJO_=ASI<ffVt!=j|jZG
zSf>1*SvcTnFtol`{M#!VzK`nxMy~Axxb<dY5DxjY$X_qbA~f%7xXUIWJ-mmcMfljs
zOHSF1UjpsXhPtOc8<%OvC|*&izyJZuu?v?u1?oVg@~@ak9<$_v(nt28y8pFK2~@==
z^qzBOb2osPm~5mJ8^iThon9gi<T(J==_nzpsF1$gwm?@+{GbLK{yCP<hTTZf9r!n|
z&IvA(Xm^a_)!aHl3Jbz|cQ(nVMR35x+$pJS7!Px5d5?D7|IROnsOaN)PFWcf1KBj%
zxVR4TzVU*+?l5Rc+vpA!ucJGQR{I(zx9m~5#`o5gZSl-2_Y?JaKqki7aodQSG#)lc
z-H(bUdT%6XGF@|*Yq3jJTq-Uge<S>aS0zRgGPwn=DB7a1+vLD1?Y>QO_A4Evmos85
zAZ}r8<UPkSk|-_IuPae|$kLZ@9?81c%ylvWHFiOPddv*)Pkd096O#L!GQud;;htLo
zY@o#$q;9gGhbl{=Ts9P`CQOtGK6a>}JO`MzXU^TO=M~@@9&Q2m;=t0H2kXHXvDTc`
z7{-I1RJ+%_y~@@Y-Y+R-srtoY4y3@mbt9WJcDESbkMw_K2~s2w&gV=EK5Ewv+yB7S
zsvr~z#BLm4d$F?WulT0wowiJj<H<xT7S(CE#?oMw&}R2JVcL0myPZD`yK#kFECZ$m
zji)lnz%1g)pm<kts0;S*3FxCm4;EE5aqcrfRBX(%u4gfGY2i4SGg77W;t;&F?E0hP
z`T=Dj?Jpm~pWPX$sxl9qnE*L$9QA^oH{qz`30IBOM^;b%nbL!pJn^P2l~#rFaD`0&
z4l0%*OF&r8TO~zk(YZ##EE6D979jWNyJwNU!i~PH-b`{Rp;K|xReUW1!E@3hJn38Y
zzL1id$=G%ySYci-P~jiFJO#W9v~3z}?qB3^65!pg16G@0`;<v7<pdii`WRji=?C+`
zCO}a(VxoD$id8^t2{cvD@W22718TdXVa#)ir5D({SY7KN3?#hKgo0Cicvq&zOJ?Yj
zRhYg1g`&cvBf%O;$B1AWYNZK4B82X%GtBC;Rk<`IEcXeu*IY%Ww$7LJ44?z)00005
zCF?XOdR73$_~+#UEu67RXOP%bat~+Q;W<Vg`Un#xI6hwLBhy<A{7iJ$*~b6@AttKg
zh}KMGp~75Y2e=-T0000dZqtJ*<Xg}lixucxxq1yOZe)gOO>Sn(l8#X|6Y<^^wu!D8
zOpS8%zjE8WTh7nXqc6VU0$V2b=}8Yb-}v&LyW1g=r~bAwmo+{F$WcVExqhFzGP^$P
z0mVM*q$P(S)HG3@^Ss>8o3noN{?lE3Rx-f7meW-FU8bLD<2*Zi2CyaYZ+?<i+xDdp
zHwUiL4t)Chr*q-ua)WCZn4J&Jn$$7zd&-vc3%@?H<fuFL1vm--q4CV7hlngh_{Wt!
zDmMD`j5H(#5F2c8m3@HLg=6}gqVTg2KKV<^c5+W>?$7`L05ni;pFahCoS5ueA?XD$
zCrK(8am2=4n^+D<jlj=cA>K(L_b72j+nVVd;^96&|L*ySGaP{2s%{px%c?Ri8WTPB
zb<4@zg67_NgCxz0z58)fciah{ddrgg%X=HIG>JwANPr1bJ5PLC2dy%FTjQ`w>C1uM
zqs@`uVN#1lF=@YXd<nlEO}JRPhcyCZUO+zK6f^WHJjeG+lwY$ow%%v#LXoSW@yVXX
zJ*$v!gSuO2ARA}EXev&}F{PMgJbjdwtHXO?NoO3iWQUp)=p4yEc9%SXj_Bm3zyU9q
zJqd;~w#S>CoiYuzo^dYE)9Lz?{Rgp(`w$|b+o1vBx<X_+s%TTne>Pk$c%UcKArTXR
zg?S)t2c-&O9i<lI*PFs{4{}uKhmd&cImhwwI!)(ZknwydYW^Vss99P*@Jy3f#FSP>
zf<jQgJVnT-3^Nsd^a_?mWp88V1{-n_vS@>vVB$}$XS?N$`=6eoTQI}5csXy*08N?7
zm;e9(3(rkr(7~+pMR=~-*-oe;CE6}U#+Rr%1)Ar5O#VT}XJ;9wFm_zFn8K;=<3#Rv
zC67r&euf%d_a$3k`6zIy1)4(vRoGNW0Vq#9%hefMHt&YR7^?-l&~QVEt1)lKI?H*j
z?10$B67Y4c&0yaTYVROnv^IN5co6be@l7^{1=jQk;Oy;TJJttqU2Z~D0zbhz@C$4P
zX<Uo@ff+ub7ix#-wuQnD!C5OTs)0zvCqxRk4@?_yiLQBMqgH0K9D0+e$}mGa1;dv|
zy^Rgbb!>Ag0K)d|i2-B^h@Tx#cW}`B=|cC?=ezBsVJ9%d+fXJ}d6i6WSeu1xNg!^r
zV>cZ8bIVjk)*FOm68Gf{v#=9&@3NTr&bC~SyFq9nt2ML`lv8@8xLY9SiIE;wV*-|J
zH|38+(Z@MA;WMkgAI6KIKT27KiPscyqryd_ZS38Xi2+(hYaS4sDM+5L^JzK}dl(GV
z?mYm6{N#kpsFxeD{>h{RrzM2_jySkLvog9DK3LjOcB@YLM=5Q^BM%Bhn@*j%a&@b1
z!1xi<#Y3pdaDA0V1OA{l+U=ba2=>%09zy0sxCfEr$GkK(+HjX1ukVH&0TGKCvc#Wn
zP_E)Ty7qps-zZpqmXdtK6`+RmDGdqica`cienX?QYJ@qo$IgWbBFXrFTN#NIK?Iy8
zqW7M>!goMVU!;J&YM>B9+t49Po2IjOaL#zQRtyMguf=_Kf0$jM>V#<uOXj&}8bjQB
z_I<<71P(OMFtiEDbZ`IwCetI4CRg7x;=WiP;ZHOiug18;AMi)Wx}B0^Y-aUtK4rLE
z%Djd`jISW)tJf#aTU2xvB{ZDErE_u~iOwPdP0n~y(O3v6ptyRYm^-i1SSt~@tP?#n
z8H4Wsnp}y3iukjfVk9LCf<lQ&f*P2yLi)8F0Hc1h0MlIdPIDH}#SF)PhYG3&X=>m<
zt^wvw#8Y}*HkTk86DKUxxZ_Ra7wV{!+bbnSL^#2kFeS@I;`eateIyk$Ouu;cJ$NJD
zNkMf3oTxCx58aW<ucu3N_5HzYqE$zN8g9X0-V8U9CKOF#BO`QY&JLU<8>@mUrvN=~
z3cyU&rRspZsijM<wgW7v8vP6@)=X52_wT?8TV*p|wOxsx3C%3_9t;YO8K$q**3UqH
zn!d1VEb1P<6?iYe00005pJ&{h)_6sI^0NB1Ier$AEPqT@MO~9sPWKm&DC+1jMjO;Z
z)DO`f@?gN#<AY1VTCz8gxPEGl<Kj?+9$T>F{6j5C9rU;#ex*|qt{kFWn@1RN!f+d}
zPhtm`$g@=gexUq{`RfaseG1OUc_q310&kR3G_<w79u*LZQYJ+6iLw#Zs$&EtWxXIs
zopYwvL01|W{#){rPYR)_t-w>CZRIW3N6`@p9dJpZPR)FtfMde+MK$<vcAa|9_Sr|v
zm0+>o8FBC3y@2P7J?zTU-RP-?w)np-z3v|pc%2M-f`Y^7uysf%>f2cuA_gY%6iRy>
zjPSPTsNZw|7ZwFAc<enPFm;~fo!`2thY3{p6;4&r$0cXW-`)*lW}og_Nq&cj2Yzr-
zlg2o#2;MuhkuoHCCy42ejh05+X%nQB83d&ze!4*l43?icTJ|?5XCbWjD8ZWjX0na8
zi=Q;&QNvWi9jf5Iie1|iL$5``u~k74e&0=1i-=!bb@&F>XBoBiR-C+)z(e4hz+Z^O
zV}(-wVQ%i-GjxVIql@n<;K{Lq40X@;nXA!tm1>#AUc16PYNU<exO!XbM@^B4xa;};
zt_||lPeO$fJr+2N${LYm5d*JTO|!vJ*FW*vg`Mjnt#KX5JBB9^XUM;g!&OCwRgxt6
z!b<|bw8E7Ed317s000000000001o9zYx_iADch>d(1;BfD%O175VZmxR7`*V@wf6_
ztl4Y}cLk#W5orMN56<t>=>d%cXq~q=j)p|A<F&Wjxgis8f_$2UJ8MQ{y}Dx%3^|Nm
z1~etHXs2~0C;0H|Z@j0V2?s!ns@ALw>nJ~&4)vnPvtmDdnzuK{3u(;pN5=)79F+@|
zH9AJkp2ATZn-7nqH^CbS7WyNZOswqDkN>nfq6#%vdyZp^zm?oVPc2F1d}}S-R?OFg
zFckE+uh6lXF2Xin-l>Sd8q6v4CzvPh?oe^1C|KQu!FdHV8wC$3ybWIp)@6ATq%dH4
zc=SZ|`udh9o_syDfeCYX6Y0d#pQ$jKa#Hg2*?+hZEfFtED&;HfLFseI_TtYz0*q@@
z*h7rm0aZ!#G~8GR0A^98Vo73iC*^TBwdm2wnx{kJmU{j)iZrHnXVRWm`zM<LYoQ-5
z5c&;|tVRS$ovc03E8e8`qT{vd8M&7$gjO?jhnqgo&7x44J*1YhYNTSt-CAIFU`5>e
z7YEVn_s=;M3QuMy#U4_0^j3b2V&rNt8h~jsIkr0fBY%K7Y!!BEljYI<z`9b1j5c_r
zY#m<aXxhya1o8j?%$kKhX0FC!o7zw5RV8$Sram_ZouGc`^shlTaU@#P88?9^h(x}F
z;Kl;L#MCp(URC32X>o*+z)B+<xjnhYe@?o(FzN=Fk1Q!jZGUj7tXx-Bc~mddnDKP`
z_zdA-X`Mo3TV}Py)C=qcVSlW2;`c0ma|Dgc$!P5LLV!hL<t9qLt1f8Dd!V|Oiv?Pg
zQW|*c^$JtBJr-yQI&&k9MxKT`g62UggOF@`1r}{_BUg-G!l|yjr{=#v?{<hNlX0i@
zA|di$-Sk)4q4lpYRbc+P1k9l_Y{|1OAoEa^=Uf3^rUP}P787H8kb-M<6Jjl>AoX`f
zZH``AT3yc|RLw$7Sfgq|GFbnbuCQu@Td0{FpV!^R{yDn6rhO!kf``UVY>tr!Z|GX1
zWSVodO02qij)NkG+;mGd3;DhJAZt(MWyHiaVikN^Sg9{sh0)50XuP}zTtI0t@P0E2
zl7g?2!U^k<ljfK-p6QV5rOGceLGtIqQLffdK~<s`2Z*^~<j)Ykv-ojfsA&_u+{|?q
zXO;CVu{;^3xQ}$Vxj)*uB~aR`WbpDTmqqr*@5#q-?`5%ZvMEI96Jv#OR^1q@zJ&;|
z@KNpbOJ)~i2>(|?GDrMsNHO&lT)H=j8=vk?sD!MxC5|#;nZ^k1(Fr{W`TI(s6C$@@
zn$AjEmrlc=iVV{Cm*m^;TEBPEvrEm?A?|6+2qfij>*<#84hbwY(tT)z4pRmaWJ^Yi
zw;Edmw*1@qjwYjZOXcPyicfmbrF$bV5U3Ju^lWi-U|qa0ozV4z6vczUshRRD@!;9o
zc`X$(<VLvsET@`iHAI%|xVGKbe2HCTfus?-#irG8TC)C{c_kjZxEFeI#0iTFN8w_9
zr}F?PS_c}&S_zPfgd{@S{L`;rQMI6Ejgc1GN;?CASwHSy4pLb%jS)pRF#hq=T3QIE
z{*Y5oV6y4~X|p<o%%{Hq*>;_kT@=?6D=q(u1-9Al6vu2w=4EqYoubn2sI?lu+Tt*Y
zT}2ngg^q$S3cT69F!kv){ar#@g-}c*yh*uJ+-4dlLqXbF+wH-3Jb(e;?+RdCgXOTF
z9L6Wjf1DI2G8Js;PQP)9K_SI`UPOOFVyC%u<h`}U;_EdDGQP-Z3|%rb=aUHP#Qa`t
zR7KkqCYW-d1kxEK(_7f~K@+5WP64xL1u<Vs?ZuKMMzmG4(HkTWg*b<=^l@t!zE7=#
zSL2-#L{*FDG`c6tAdJ}#e>W|<(cOQp@MMnfh&?M1vpW~f9{Y)!JL?DrhuK`j9Fpm>
zVmXX;y;V>hOcOQ;9NeA2!QCaeyGw9)m*5Tug1fuByF0-h4(<eZhu{J7=iP6sb}x44
zVrsgodv0c`pPrtcXUtVw=93`rySLN3JBi{ohgLZV<Qwt9*=~_}DRrFkn=`?R<c;c7
zDUff)Yv&TiUmR<R!(|9WS_+!Nk~>ip9X*ja)b>|(0^65djgH2H7n}K6XQpfVWLNum
ze2GH2OVJ~cROj)brmJR@&>2U*#;96s)T+p)ujg}|diw!i5A2wKj$&a@01RyY6^yKl
zUz4B%sT!K*fdN*-tE<t<7mBfxjiORzA?}kqrk7H7mDGzy!MAEyY5bi39{$O6uEP7W
zLLx+k7=QWsCx$=iMGvBJ2KU*ks`FGZSBYl~6c|f55aRchN@X^@E_EX$WT2-UHL8Id
zMj;3Qh|@3t3t;IlIg)Q`yMCGa{4lJ%B**GnUzA<`h%$r~y0*4Py%bV~vMCYJ*+jva
zC-YsG{{fp7DABn%{o%^5WZ07eiRM#h9zn^we*pf(qf~hX5bM8n=*JvwU8D%C1*!6O
z{hk_-r~J9er+c$azDnA6EHeFq-G-D<P5ZkMKgx?=74EfZ8mA^xQP#*gv49xfimzR{
zG4{R<|K-~1{FHz8))UcU*}B#?>OUxj#JNq5Vv2xF$0#^liys{DZP8yJI4JNDM5(Q(
z6DV_nUL@DnDl_p|{Fsx%Nh?k=GMccurRUyHe(n$kC2rhHzM_&9)r$A4N+zYo9cp+d
z!xg<x+dPA}%5p|Eh(W&6xIMedvb@Mczl(o=W!jv}o2Ih7@4`LUvQRINgQN3fQ+1vw
z(7o*@69~pUo=C_G4+F8)ZU!!(ag5i!a7J=5tVE;V5SRaHk~|mQR23%M-~fKUF8+Eu
zRza}_l)2Dyb6|uQtHs9<pfz{+n+Csb=R<OnN9#r?O@TTWJ8n-Hp<J0H_~^UJdPYKn
zRwRkq*&dB1rVY~-*;0ewdTpBrr-7h`)OUzmcCGs!l7*qx1sRiurt9XovA4_TRJ@<D
zsHT3Bs5xmtf7!c_143Br`?tQ;;X7qR(}_0dk(gNu!q&-@`E$fFw(xxyLDEuf|8nmF
ziAo*WS4l(!6p@oqnPB26IN8(G7r(pwij}i<rIm#J_LW~wVbRe@!aqoRaq}48#^QZB
zuJWc{JTm{D*~lO}=99#e(8uKb8TDB1&##lvKa@qO_Qo>rKjkvYR!5xm?J%l(maws#
z6gS63b@{*Q#?>V>|GnARLc6DgiO;yn7+O!&@Lzd}UJq|Ue+F0kCzy5`)k*(?Djk+)
zA%ibYV7zWFOp-&TBaiz=-~OS#BvQc`oGBdCY`Y89;BeYMeBAgq(@kG9s%JYxqWH1G
zbsgi0YZy;$D$2p1{bh~V%9T=EueL2dt{>ikgN03bMZN3!tUBoVFMO>-sgj~CHbAvd
z0ni2aH1tx9?CS+?P-9{`RAt)GgtgNn607WF3-NG7fSi8*krzG%2`%vAE2?LVKPeWy
zHH$Hr_nkt$cp2f#?y-iV6Zbzt>hGEZI}vQ<f>%L$DEexiIF0$;`%&&Jj<(ahVIRdl
z@qCEwQykg#C6o~x>Q?XK^Y4zxTU?;EhWOmp;@2ndHzNndif3r=K`rE{7oL44Hu&^k
zbPc#jPp3Z5u#78xN*64x!c}?vjqt9)7<sPX=y}eESagbPN<AOazvS<#4kfm1Gv@|}
zx<fF<;K#xXd_0yY<N-71a?j`!nChkgVad#<0lEv=9Y>PXN#jDW1dtb9UV-}J&K`X4
z>?UU)sj9Oi>^x^u5IG6&==FmmLh|p^X0SV=m0QBo%Gwj;V`LA+Mkn<5SPL<8^>swB
znbhAv;5p$QR4=?c13p^Z=2Yo5r|Y=t?z&$^2Ev`thM%>rt=-z{cQ~pk&Xn>7W+}i~
zswmt1EQ~OiqOv?z-_$N2sRtCXC0pEft&J+1y=$%ad(UN(IiEYYCE8sK{=ul}o9*O*
z2l^PIq{jtVuBe&9o%*tj-6PlkHH47%TuiHbhx;?>+<K<J=2}h`TU{i{5&Vn1?9L=(
zIJ27w+{CI*f()yFBDfq=uZDqClaLC(JJJK$&jJ*Jf9=KY(+E{+8TBL>l*C>48B2Uo
zb<Z;c#cMN2=lx?1`SgYRyI-K2#>Hn!sVlaez<9G{6^Hp-P5b3a{<Y!aGd1Kxzks-5
zb5*g8*Z950?YAC?T5stk=jeTHf^8e2X5MAol+>a1YigA)uaUmXy2FTKNRIAgM3KE!
zvUU?T*EJ|0gT-2OE;L@`z}9Qm`SnQTod<1z)1~ig7e>GgS;k!G8-aj<Vb3Cxk3DlN
zzKsDN;^Kq0mmea;!z%IBZbr7fG2E^8Zx)*&HmD!-+ltHz!(1kVB|eDpg*AwBnraO|
zNrrF&!q?+3-$AT2(bg)?7}SNVHBgs9C>56hlC3xx>Sy0SpUCPca{=U0<bAuHEJ9nz
zB<GvgC|#g$wq6DoXCq45F$Zvh7>$?Qi3;86VYL;ZkFH|*;+|VhsTu1pREDEMbv<|q
z99=cthfXD0s5O_Re%bKQK&CD0>tdWrL%{{@q`03O6T_?m2ESDx>BEdAhi86FOO;^V
zK}VFh)KRLWJeH<s{mAEEKu^N%(i_u8&FV1F*Ll?pq=a$!9C#C0skw?I)fx%F-yTcU
zNt53AJDd$LyodlYc9fm#v547n^j@Twge~MBj7<ca4;`_4geH<oKh7@fOai?NaNWm4
z;$9?o^PG+%>7NRy&Hd4z4c7c=4lueAFtcB$j=rj0NPO!oqso$7Xm7*OmQ8+j{d6|Z
z&DK++{Q33yAK~v{vRQWxVeFdtcRxYFpxNS~+?@1|?`y+yG45IaO0)mn)FUyV11=r*
zJ}bW}p>{k}l+Fhm`({=?X5rUOQL}EL{WQ6^mxkCrVGH(<jMgF&D62a{I#U8uZENt+
zd{Pn0a_=Z%yS>ZGq`IeXvS#CH+$2(7+ugyYlvkE^ub_w)JGczJKuCzt&6Vfys<+x$
zltQ7PV*QkC2=tKY&Efjd7PgbH)KdL~3GusnO_qdkbkooQ5z=Hs19&ATKMkXDO#j*J
zG<fwi8}J`|QpnhweBhpBEX&vzX3(Ss=5hXgD+CR8Y#vZU{fg~96gs@Fc>Yxs*c$cG
zfp&JRHWUwv!sN%}75e%OU)YJkSnxcuQ&k*o!*4Ys^BpRd<ltbB@7mtDpCd3*!U4bc
zy}wTHsf>!jHwWs>ESL+vSxuGTF5YB$CL)!5w`)}3j}2V|qatR(pv2`OV(d-*N70_}
ziHx<s-7-Dno}n3bhSzxG`=+G-PDq3AIJW*w6=nPbs6M32Qqd_}$W>|K6Sl*to9XK*
z6*iNc-a?SQ$~MpQF#x63KM}%T_EvOG4ghq6jWR;(=HS9hc{>}cl5&@)A7SL`d(1KI
zrXLDL=)s_VuLlh~eRgjZ9Rii6t<s*=E(G$K5xg?OAqR~W`lM)94e01$i_r6v2qkkT
zE#uuK*9=_CzkP1iFPdHGuv0C#>~+LNsr>F&NJ@~1md}w|VOT^(xXy#D)@=6|&U)%Q
zmW^r*1J)Urb3@zZC0MCZE9m+L-8L`cbQ9TKliK9sV|+Z7S1y*eIV$6}8$yoJlhjA2
z)+r(foS3vafQ0VqIqVVKn!_S#dn_%wdTW(GoZx`uX+}oh>v0fVtrnXza2JGbD|9bA
z&(c?Kx<s~A&QEG`dDbk)RK!>WJdskUd&LI@+8#IBxFJGqzFFkYQ}Sk@Ncg?(OMt27
z?3Fb<oX0EHI^(TKQ0yW|E0lz)kGc6opE?4%1EqCGWl+Y{B`6{jc#sLDTe?(-?oA$p
z`x*m}6G-i&KT1i#M)dVLliOy&na|^b2+Gd1Yh2+tQ{yfS&eCYxoQN;8QV;7x<Ow3+
zh!3Q`yAPtF??BcD-lys|yim@~<dsg!>a$n&JkAILS*^+hdCreV^WptCjpDoHiMp&b
z4HwSCgqsvZfzJ{`x0V>2*C(i|_GZ{t)4%>I8W#NJ$VMoO7RnKaYu*Dmwsg(fUyE+Y
zzJ%vvzDoy*Gq4m(n)&UQ8HKl3V|C>6h4gk7XAe1%VkcWM*$*Pq?4c@6Fr|O6--+=<
zIbj+v6#*;&)KO#vklynt&-X)Zhg(LMzpCZajk$IRRSps0JYldJQRr(|b&eSTx}3=k
zrTyqUmGdP9;vUcY;JXxWET@(zJf|lDSrdc6k6X<UjWr+EcBJ74wCXDG=<wHUl3+VV
zSWJD?O+3x>P*)rxG@`=7Y@|zVJ4AV-I3F#f=#$F}VK#{UPkZbjAFYIrM>6i%+7J@G
z1ZTCE*57k!AO`K!`bb$YJL>PDLp%=-@YiZy|8<jwgK$=3WVNciT0YGy;^N5TR3<mZ
zEC2@gfDEWdcCm;;%RfZwk<Z`2g@k6zISb$T=bKQROEHmc6V>~v-oBx+|JzX)a>vbz
zJK<UR8o#3Hn#A5}>1Nz!Qaq_H7G*}e3yw(HXl6XVD+uw_B!c<C5sem+R1u<Bi5>G#
zIiGFpW1V5RJ;0l@Oqc7G#e8KETnI9i*haG!lYeDvG6C6Y5^`G?As7kaIK_YTHUs_@
zCF6+9;OjY0GX4>HorN>eTkwPb)y8+990QhUj*?G6ucN2ky&NL#t-n-5^q0_7(vk0q
z=48}cbPyu2ua*}qILl}HXv$!0TR%|rPH%Mo@cj3Ah04j~=!$`i@l2g-=%v_rg#esp
zDVmmMulum9q_Xf9o*S7-2ti7Ne2T2OBfPGU%i{YdL3Jp5*f^5d0~?$IIjMQPg7PH=
zccSaM5(*A2X6ZXzb{bLagU_x5lX7$HR?Z~2!in?8w~{f^@;pVUkouMQ>HnN3bWJgP
zD(&wk)Hh18)bD54xWgkZqn*cTp^P1OIQLlR(QvuGxHN7-CwplQZgv)|Rz(&F?gwVV
zJp1MzQO;b^Kn>D;k|2++0Tiu#xQPoC+)=|VBP1BF+Y;NEnh(w#@ny7KB;zm)#Ii%8
ze=t?9Z!qk^U)EH%F$Jzi*(6mKLWt^fblB0ar1I%{rO^2Ht-@E>uly)PcxYOiDm~xy
zyR4Af&KLDcf8x&4sQVtrIfQ+-U%2CUa+qX8m`Gx_h!dz&HQ6lmK@+!ag9gpqNFN^p
zbrBOG$1K`4(eP=0@)ITXmXU0LZDSJx-M~vFv$LRVs96YR<AfE0#MjYv0({R^Y)PnZ
z!ODpw>u~92N_XNm=HFhiIkd_tWPYJX+An%{rmrCiaL!^spRGs)`KNpU!;=ZIi{fns
z9*0Sc5D!XVvI2D0ISD54tXurV6zAUbe%W9LOo`glQO}}|2J0=N0fU=Z4JK&^6Fp)J
z<;)w=f5njb)85~ks3{B=SN>qevMK%*Z8>Z1rhI5JFZYxmql%IC^kClSDWIl4qT$-`
z3Yail|0|ntFS?Xg{$)>|ZExU5_9KdsWBQ(+L}1*$jUSw>A7Lz=V6nkv@9nk((gpUo
z0qjSx75ZnK77)Z)072+*Gb&fXpa#|4IxVNY{?apKw*8VAh+30FZ<)Ey(bv0NqF61j
zpGiz^M<**M(O@bp5}-}vYOtqKqXtHQfordE3@BIllih#&^IgQHB6YxopXt~!oOds*
zeZ@g2Wu}&WJuZ#P$`y}s4Ox-`zIc}<R@-7asM86DNUG^nzNHXXHC*E}^EBa)={kfy
z17D%Kgui^Qg(6#K=oHl2688E0rIv!3LHmebTGF25wufPR<vo`B5BdC%3`K>vQ}Mtk
zIHq|9<#B$jD}eT0SpsZ{%Vm89w3&Jtx~Mxiiw&FDIHKi+BJ4qwNtq_8CJc8SASk5g
z9m_}V8vB{b^2$|D3aL%?n8t5g0-vtInfd#ZFrpQx`%3a1nxEjoZLAKcfQgU`X=zNr
zfpV_W;R6$!q3pZd8p^1e(WO#3x&4LIxbAUgSU7oLRO4LHQn*lmS58~GAtvOvI^-QL
z0GwdK*K?C~!KNAj->WP|%|n(^SQJQ2+QK4pOV!UDE|7KvNm`~As6#N*Y=_F;i=gI#
z&xBz%6XIyN5Ad$ELOr))jO@$P$Ja-aHdjD;WDun<RFS}Aql0w8vuKT0yHro)DCW4>
z%rbto%*XaiSlf%V&Tg~ZVy~R_JisSB7@axyOFAi5@4i}#Chdr;2ZkpR&(1qXoGb9e
zQ1|EAm$H_iiOl8fIZ|~f4Q;A2+6igi;nrIg!R@OD`R3yrbi$xiltRnxtWbO!?5>Uy
zxL5gV4I;C|gG?uMUTjL{1AdkYU`|^SqGK_bKWz`@pwh$QrZb0N^bg*>rpg5lOd|(m
zjdxUzp%J{yTKL4DmMx>UJS#K`N%GJ%izQ@z+M`44rLlb!{O4~VOSq>6d46ONDe1h|
zEV)zF_C^aGX&O5V;cl&jknaA4zh{8t3bovslc8hlK|{2hyJ_2!SGaA`cEpSBv!T*1
z8tJix5%?Js7`PfHjJhc_R*4veK!ikkDTR@_kcFw&wfTiN+dLD*n~keOLWJ(Qsb@&}
zT-;JdQ32_;b6^(~cferyGC6UQt#UB=C!Ey;2aHo><IiT(-{I~aQGvqeefs7ecH8dS
zve&_efB=-mm}7g{tB7aaz#IL(V9Aj3#;`3JqOIq|E&4d#scK(op3exya(Qd96HbDZ
z_xZ=Kp(;TkQNQ~7H5h{Lo(dyIqWr2QV%8<AbxqTfhlSJQZR0}OWe%Y^la}g@i+%xJ
z8fk56tgIrKN9Tua<UI5Ca!Z;H{t!qC)j-vvl>EqwH4qTlM~Rla?Es2ss}|*G4;AJI
zD)U$gpE$@W^D{}}wAj~8dxK%>eL&=DRXFx5m3m{Sx3zv8GzNJNBg{>oJUE-mSl174
zT|Hh^t*caB?cp&-VZGJ!rrfGwB@eo}XYIb-{214Rz%hgO+fzyqGY<~O_;?iNp&>2Z
zw^JwtBYNKi#nsGZ7{)vDW7^^E7kDqelgc*%71l@!>2pAW5y>2#IQ=<inpMRdHBwnY
z7449<>wRHN1pd(c-jnSM;i#Mp$r-&6;!dQC++U3KPYpbm!)!$>OrOA~%|bcnGeo_q
zmZ}fsl?aUoDa<_dxYC!mN%8q}ORvvQ1TUHdZ>Db25n`uqt+GGKyFpvH-(#ue<rK54
ziBVu%Li)`#u?`%bWTq)ao~YI*IK5jz%{ea$wcFG{$xh05?RtSc(oR*hyC@(qr)&u$
zD3G=%Eajtn*l$Zk)SdS}Q8A9^aC_nMNp<G@B=j566yB9^Ee;+qSijT%&-J~`NO1fV
zHM=q~<`tIZ5vlZ{L|(YO;d6-wvA+%4<B#>v{6FR|$b{R{x6hTDVneGZ72SO<WPkM_
zmrWzE^Oh#bsmfsLP!V2udI70p;2sji;9})b+$4t<{sS)UN5!aCb(-~WOQVZ+9s@SR
zav-g&#Rs20JD*)yT{TtKf^_lEa{=kp2)s7%sTA|B{w2}R-U=i>n|i%D#*I_1pi$D&
zKTOKxROD1N(>|@M8JCb(3Axk}d()A@{}ObOx(lj-7n8lLTW-=d40LPkd^+MPXXmQC
zcx<=3_5iz=@EP@l;2~8u?=7tP6<1-Ny?Om&J<GN<&lu4CoNHf-)q*-op82}2h^eQN
z=XbKcHc}lN<FUznoRwjl8%ZL=*Ui<FI4<nNUtz@Pk<!Rn0*~FCLxFo%I58VPrpzh(
zFE1J|uFUkr9c46ugZ2@p^t_<IoRTbIn1i5`s_IR`q(D|&zP=0+hqR=c-ajAfFJUIH
z(^f|{ENeXr42+w|{#6QllA8#&kF29R#WKSQa47}W#h=)^z>Fy7;4nd}+U@;ilER>|
zbv1}KZM8Q>SX-f&2p~RGRJ#XXvrRB`m_=E1Z^!73Q`BS$d?5uvvQWl5HzBTr=87kT
zkAv5spmIz6W>bxs3)GV&v*N2YR^lD02$>*&nYIRo!^PWz6@nIP5qt-tnT|Wi0-pWL
zXLK@_BlhOM=r5ycr?Q~w;3`YOdy&Nb1(EIOXa~ZoGSu>3rFtqpgt+-+Jgg8xU&-$$
zg3kYJjQhtg_Nn?uor_t|d%gaxX5VipP^|DoaxC@`<3HiQh#Oh9pkNq6WCsh2tn^MD
zq&*?ZZLlM!dyKHTUJ+6HFNv3Q2_X25>EJ%Dnis7qsN!;j!$i<zvQusXDWju9^s2{9
zJEtZCB1_4yeb~K-->sY@=_rb0(s*3^+}O=0V93mmeCm!Y3wq0{gx}9IlQmdv#~P8?
zG=*xt?=4gYba@!kHF-!yAVFssY1}_e^^Nkj;wh;slFYJ01@Di%$-dIbHEHU`E1{qb
zaexaLf!BwjuOettGr4(4hG4(2GwcKxiOITIWLjN<Tg{Ug*y9r~V<HN}v*cWor~JFg
z0fA|}_&N#GFZk0aZ>V*<h;E;sA~TMsxnlOhbTS9YeH&CN6~|LJkQ!yC;48oeyTdGO
zVyk}xv`swzJf$*ldv6$a$8xqXD0JzjM{F&7B#rO2lCg=#s2M(@y&~fi@yIP6BH^2<
z!~caZP#C%Ld<uIG<Ufn7e@Qe&jA5eH+~Ohg7G)dRbyG?Z`+jHgZVskw@E#TOnutue
z9qFYvhZN>Pj_SW8earSj>j)BHL!=M84Q07BZ6#G*;$vY&U=TZ^M#-}0`l2=UaIrSu
zG3nU#FeHno4#_f7gyNy53Vfy)KJrvXCt|Pe%=0$nhBIK+GY=TX(;UpHk?$7kuiz~v
z;EXMR%F)cyqi{JUG^wPQhT0$YW)Stu0%VeRE)zG>**`Pg5?FSl$*##Vlv~F_Fu+D*
zYv6XtCW)p6#^LAD5Ltf|vvAw^8{*_xx#0`}k`tgwNyjsWy4Xqb3{pW4r54I%f3tmw
zb8GM!ZLf3{+hCU0aQYhOaBh|zYhAa_pUrNHk3pk<Qso{FgMq@hze~gU%XjX~acR`N
zIA8cM?0}Yskc25UjLbaruv$|=!-64~tl|yo!usUsILKZj97BG^&~U3MEMT2ZxA0sK
zUBZnuV~>JO?g?UdILQKpSjfwpg=TRNmKn@e3nNj-#fsasS$l9*FE;a{Fxz;Wz>xRr
ztEA>&ZD3{maDvyNRQxG;>0gy>4um4tw%A}jwXHk3BXN+|@I75RJ16Wb8&!17d~TN}
zsx8&hm?6S%sri}#5^#M6Nfc=tw$$(`N;YUqOwf!uF40H-s77v^>rbsY;LeSd-F;41
z<JCeMPmd*F@W~Kd(%1dx(606$U7`2e5(6!om49jq%)jK`Yj7wPpjZ3_L1s<{hb5P~
z8OlD7C0+Z!5anNxf@FOAztR7@$3C^mR+p}Pq>mvW=tT?+`r3blVi+nifN$&)Rxegy
z9Mixnu2rbaDy2<WSUp$p&lEt^K7l&FBJ#gkAT2c4(Yt6q7_I{Qyb&*H()1$&Wf#oy
z?dWzq<uRI*LXe@+4v8R6;Yr5%Am`A96Wjm=q(4Yc;Y36}Mdv63aNwhk)@e8pLVIQB
z`u|M{DHnAi$1>HI77OJetFp!Pa^!H|K3}ISrQ$|d6d@}5G;tjK#2+MqLH&5RhhrST
zR&yMqNDI&r8e>p@>|!{=7mf;jtidkr0Fl9$B(>{!qM5;Tsh9yQO%*gfhs(!nZX&;R
zH+5WC3$ZKoFW_`z;YT;@9ud=gX+solT*Pr8IV9qUee&Fc_Ovoc-G?EN74Go)yoWjd
zG>Y4lj*O-z9?9tp%`;eIOd?(rw#ogTxVuGNt@tg;0>22%Gx;L|odp2f!d%NEx%iOy
z>M60J#-0^b78;bx2>rxCUDjfAJMzJxJ<Z!hMrF7@?B+<dv85mPF6vpwX6hYl#SNqk
z_dZNY?|ET38Pwr)SvBA0{W(kKUjIf#EyVIoDOPgKQ2}|{hv;aOCxuJb*tiawa8kHN
z1GSx&ZVJw7g`W=Tzg5A?oa8Fhs_Z<6?+3)vuvjMNZnKavw9opL=qPemO%A)9&h&iG
zo}WK;yXV5;u;G(lQ=b)ltE@;av3yp~C?BP}ivpSEf63RtqVb%K+3I-AKUxuC^h5FL
z2EBIGzfe0QLE@f{O4x|c(eA4B7YB+QI6WZpU_1R!l7@<dA^e}H%(Er<|49F-N<#&X
l?w$UBsH*fAIR87N{NINEQ;mZGMDSj(8RGr7G5-JC{{c=<#)JR>

literal 0
HcmV?d00001

diff --git a/cookbooks/cosmos3/end2end/explainable-palletizer/assets/scenario2.webp b/cookbooks/cosmos3/end2end/explainable-palletizer/assets/scenario2.webp
new file mode 100644
index 0000000000000000000000000000000000000000..55bec61c1bd4a03b967dfd4089c446e31a9988f7
GIT binary patch
literal 53344
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
j0)PMj00000000000000000000000000000000000h>l!|

literal 0
HcmV?d00001

diff --git a/cookbooks/cosmos3/end2end/explainable-palletizer/assets/scenario3.webp b/cookbooks/cosmos3/end2end/explainable-palletizer/assets/scenario3.webp
new file mode 100644
index 0000000000000000000000000000000000000000..7587d4fd15bb44db71497bc7b6fd112c4dc076c8
GIT binary patch
literal 63564
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

literal 0
HcmV?d00001

diff --git a/cookbooks/cosmos3/end2end/explainable-palletizer/run_palletizer_with_diffusers.md b/cookbooks/cosmos3/end2end/explainable-palletizer/run_palletizer_with_diffusers.md
new file mode 100644
index 00000000..24d924b7
--- /dev/null
+++ b/cookbooks/cosmos3/end2end/explainable-palletizer/run_palletizer_with_diffusers.md
@@ -0,0 +1,185 @@
+# Run Explainable Palletizer with Cosmos3 Diffusers
+
+This markdown entry point validates the Cosmos3-Nano or Cosmos3-Super generation
+path used by the explainable palletizer cookbook. It expects a small
+Diffusers-compatible proxy with:
+
+- `GET /health`
+- `GET /v1/models`
+- `POST /v1/infer`
+
+The same request shape works for Nano and Super. The model is selected by the
+server; verify it with `/v1/models` before running generation.
+
+## 1. Choose an endpoint
+
+Use the deployed Nano endpoint:
+
+```bash
+export COSMOS3_DIFFUSERS_BASE_URL="${COSMOS3_DIFFUSERS_BASE_URL:-http://127.0.0.1:8000}"
+```
+
+For a local Super deployment, point the variable at the Super service instead:
+
+```bash
+export COSMOS3_DIFFUSERS_BASE_URL="http://127.0.0.1:8000"
+```
+
+## 2. Smoke test health and model identity
+
+```bash
+curl -fsS "${COSMOS3_DIFFUSERS_BASE_URL}/health"
+curl -fsS "${COSMOS3_DIFFUSERS_BASE_URL}/v1/models"
+```
+
+Expected Nano model response:
+
+```json
+{"object":"list","data":[{"id":"nvidia/Cosmos3-Nano","object":"model"}]}
+```
+
+For Super, the returned model ID should identify `nvidia/Cosmos3-Super`.
+
+## 3. Generate a palletizing-scene artifact
+
+```bash smoke-test
+python3 - <<'PY'
+import base64
+import json
+import os
+import time
+import urllib.error
+import urllib.request
+from pathlib import Path
+
+base_url = os.environ.get("COSMOS3_DIFFUSERS_BASE_URL", "http://127.0.0.1:8000").rstrip("/")
+out_dir = Path(os.environ.get("COSMOS3_OUTPUT_DIR", "/tmp/cosmos3-palletizer-smoke"))
+out_dir.mkdir(parents=True, exist_ok=True)
+
+payload = {
+    "prompt": (
+        "A clean warehouse palletizing cell with a robot arm sorting mixed "
+        "cardboard boxes, visible handling labels, a conveyor, and an "
+        "operator review panel, technical demo style."
+    ),
+    "negative_prompt": "blurry, unsafe robot motion, broken gripper, low quality",
+    "resolution": os.environ.get("COSMOS3_RESOLUTION", "256"),
+    "num_output_frames": int(os.environ.get("COSMOS3_NUM_FRAMES", "1")),
+    "fps": float(os.environ.get("COSMOS3_FPS", "1")),
+    "steps": int(os.environ.get("COSMOS3_STEPS", "1")),
+    "guidance_scale": float(os.environ.get("COSMOS3_GUIDANCE", "1.1")),
+    "seed": int(os.environ.get("COSMOS3_SEED", "20260616")),
+}
+
+start = time.time()
+req = urllib.request.Request(
+    f"{base_url}/v1/infer",
+    data=json.dumps(payload).encode("utf-8"),
+    headers={"Content-Type": "application/json"},
+    method="POST",
+)
+
+try:
+    with urllib.request.urlopen(req, timeout=1800) as response:
+        data = json.loads(response.read())
+except urllib.error.HTTPError as exc:
+    body = exc.read().decode("utf-8", errors="replace")
+    raise SystemExit(f"generation failed with HTTP {exc.code}: {body[:2000]}")
+
+if data.get("error"):
+    raise SystemExit(f"generation failed: {data['error']}")
+
+media = base64.b64decode(data["b64_video"], validate=True)
+suffix = ".jpg" if media.startswith(b"\xff\xd8\xff") else ".mp4"
+artifact = out_dir / f"palletizer-cosmos3-{payload['seed']}{suffix}"
+artifact.write_bytes(media)
+
+print(json.dumps({
+    "backend": data.get("backend"),
+    "seed": payload["seed"],
+    "bytes": len(media),
+    "artifact": str(artifact),
+    "elapsed_sec": round(time.time() - start, 2),
+}, indent=2))
+
+if len(media) < 1024:
+    raise SystemExit("decoded media artifact is unexpectedly small")
+PY
+```
+
+If the Diffusers service was just started, the first generation request may
+spend several minutes loading model weights before it returns. Keep the request
+timeout high enough for that warm load; subsequent smoke requests should be much
+faster on the same process.
+
+## 4. Run the Doosan full-stack smoke
+
+This validates the reference robot loop without gated model access. Use alternate
+ports if another service already occupies the defaults:
+
+```bash
+git clone https://github.com/doosan-robotics/explainable-palletizer.git
+cd explainable-palletizer
+cp docker/.env.example docker/.env
+test -f uv.lock || uv lock
+
+python3 - <<'PY'
+from pathlib import Path
+p = Path("docker/.env")
+text = p.read_text()
+for old, new in {
+    "SIM_PORT=8100": "SIM_PORT=8310",
+    "INFERENCE_PORT=8200": "INFERENCE_PORT=8320",
+    "APP_PORT=8000": "APP_PORT=8330",
+    "FRONTEND_PORT=3000": "FRONTEND_PORT=3340",
+}.items():
+    text = text.replace(old, new)
+p.write_text(text)
+PY
+
+make docker-test
+```
+
+The current public Doosan Dockerfile expects `uv.lock`; the `uv lock` guard
+generates it for fresh clones where upstream has not checked in the lockfile.
+When the launcher reports all services healthy, open the configured frontend
+port and verify that the simulated camera, reasoning panel, action panel, and
+execution status are visible.
+
+### Full-stack troubleshooting
+
+If Docker reports `unknown or invalid runtime name: nvidia`, configure the NVIDIA
+runtime before rerunning the stack:
+
+```bash
+sudo nvidia-ctk runtime configure --runtime=docker
+sudo systemctl restart docker
+```
+
+On a single-GPU host, Isaac Sim warmup can race with vLLM memory profiling when
+all services start concurrently. Start the services sequentially if `make
+docker-test` exits during inference-server profiling:
+
+```bash
+cd docker
+set -a
+. ./.env
+set +a
+
+docker compose -f docker-compose.yml -f docker-compose.test.yml up -d sim-server
+until curl -fsS "http://127.0.0.1:${SIM_PORT}/sim/health"; do sleep 5; done
+sleep 20
+
+docker compose -f docker-compose.yml -f docker-compose.test.yml up -d inference-server
+until curl -fsS "http://127.0.0.1:${INFERENCE_PORT}/health"; do sleep 5; done
+
+docker compose -f docker-compose.yml -f docker-compose.test.yml up -d app-server frontend
+until curl -fsS "http://127.0.0.1:${APP_PORT}/api/health"; do sleep 5; done
+curl -fsS "http://127.0.0.1:${FRONTEND_PORT}/" >/dev/null
+```
+
+If `sim-server` exits with `AttributeError: module 'warp.types' has no attribute
+'array'`, the image resolved a newer `warp-lang` than the current cuRobo/Isaac
+Sim path expects. Pin `warp-lang==1.12.0` in the sim image, rebuild, and rerun
+the smoke; do not count the robot-loop path as passed until all four services
+are healthy.
diff --git a/cookbooks/cosmos3/end2end/explainable-palletizer/workflow_e2e.md b/cookbooks/cosmos3/end2end/explainable-palletizer/workflow_e2e.md
new file mode 100644
index 00000000..a50174cf
--- /dev/null
+++ b/cookbooks/cosmos3/end2end/explainable-palletizer/workflow_e2e.md
@@ -0,0 +1,254 @@
+# Decision Walkthrough and Validation Criteria
+
+This companion guide adapts the explainable-palletizer walkthrough from the
+source project for the Cosmos3 cookbook layout. Use it after the quick Diffusers
+smoke test in [run_palletizer_with_diffusers.md](run_palletizer_with_diffusers.md)
+to understand what a useful palletizing-scene artifact or full-stack robot-loop
+run should make visible.
+
+The original Doosan Robotics proof of concept was built for a Cosmos Cookoff
+reasoning demo. This cookbook uses Cosmos3-Nano as the default generation
+profile and Cosmos3-Super as the higher-quality generation profile. The
+Cosmos3 Diffusers path validates palletizing scene prompts, model identity,
+fixed seeds, and generated media artifacts. The Doosan reference stack remains
+the source for the Isaac Sim, cuRobo, app-server, and operator UI control-loop
+behavior.
+
+## Model Profiles
+
+| Profile | Model | Purpose |
+| --- | --- | --- |
+| Nano | `nvidia/Cosmos3-Nano` | Default smoke-test profile for low-cost palletizing-scene artifact generation |
+| Super | `nvidia/Cosmos3-Super` | Higher-quality profile for final prompt review and richer generated artifacts |
+
+Both profiles use the same HTTP client shape in this cookbook:
+
+- `GET /health`
+- `GET /v1/models`
+- `POST /v1/infer`
+
+The model is selected by the running server. Always check `/v1/models` before
+the generation request and record the returned model ID with the output
+artifact.
+
+## Reference Control Loop
+
+The Doosan stack is a four-service reference system:
+
+| Service | Default port | Role |
+| --- | --- | --- |
+| `sim-server` | 8100 | Runs Isaac Sim headlessly, creates conveyor-box images, and executes cuRobo-planned pick/place trajectories |
+| `inference-server` | 8200 | Serves the reference model endpoint used by the app server or the no-token tiny model in `make docker-test` |
+| `app-server` | 8000 | Builds prompts, parses structured actions, maintains pallet state, and streams events |
+| `frontend` | 3000 | Shows camera frames, rationales, parsed actions, and execution status |
+
+The control loop is intentionally auditable:
+
+1. `sim-server` keeps a conveyor buffer populated with visible boxes.
+2. `app-server` requests box images, dimensions, pallet state, and valid
+   placement cells.
+3. `app-server` sends the prompt to the inference endpoint.
+4. The response is parsed into a bounded action contract.
+5. `app-server` validates the action against pallet constraints.
+6. `sim-server` plans and executes the simulated robot motion.
+
+The Cosmos3 Diffusers smoke test does not replace the robot action parser. It
+creates visual evidence for palletizing prompts, scene constraints, and
+operator-review criteria before or alongside the full-stack robot smoke path.
+
+## Action Contract
+
+The reference app accepts three action types:
+
+| Action | Required fields | Meaning |
+| --- | --- | --- |
+| `PICK_AND_PLACE` | `box`, `target_pallet`, `position`, `speed_pct`, `grip_strength`, `reason` | Pick one visible box and place it at a valid pallet position |
+| `CALL_A_HUMAN` | `boxes`, `reason` | Remove damaged, contaminated, unsealed, or otherwise unsafe boxes for inspection |
+| `WAIT` | `reason` | Wait only when too few boxes are visible and no safe placement or human call is appropriate |
+
+`PICK_AND_PLACE` is constrained by the prompt and by parser-side validation:
+
+| Field | Type | Allowed values |
+| --- | --- | --- |
+| `box` | string | One of the visible box IDs, such as `box_0001` |
+| `target_pallet` | integer | `1` or `2` |
+| `position` | `[x, y, z]` | One of the precomputed valid positions for the selected box and pallet |
+| `speed_pct` | integer | `40`, `80`, or `100` |
+| `grip_strength` | string | `standard`, `gentle`, or `firm` |
+| `reason` | string | Brief operator-visible rationale |
+
+The important safety property is that placement positions are not invented by
+the model. The app computes valid positions from pallet occupancy and stability
+rules, then the response must select one of those legal positions.
+
+## Scenario 1: Damaged Carton
+
+**Expected action:** `CALL_A_HUMAN`
+
+Three boxes arrive together. Two are visibly unsafe: one has an open top flap
+with detached tape, and another is crushed and deformed. The intact box should
+not cause the app to ignore the unsafe buffer state.
+
+| Field | Value |
+| --- | --- |
+| Visible boxes | `box_0000`, `box_0001`, `box_0002` |
+| Visible condition | `box_0000`: open flap, detached tape; `box_0001`: intact; `box_0002`: crushed, deformed |
+| Pallet state | Partial fill |
+| Valid placement cells | Available, but unsafe boxes should block the pick |
+
+Operator-visible rationale:
+
+```text
+box_0000 has open flaps and detached tape. box_0002 is crushed and deformed.
+Escalate both boxes for inspection before continuing placement from a clean
+buffer.
+```
+
+Parsed action:
+
+```json
+{
+  "action": "CALL_A_HUMAN",
+  "boxes": ["box_0000", "box_0002"],
+  "reason": "box_0000 has open flaps and detached tape, box_0002 is crushed and deformed"
+}
+```
+
+Simulated outcome: no pick attempt. `app-server` emits a `CALL_A_HUMAN` event,
+the UI flags the damaged boxes, and the conveyor advances after operator
+inspection.
+
+<p align="center">
+  <img src="./assets/scenario1.webp" alt="Damaged carton scenario triggers CALL_A_HUMAN in the UI" width="900">
+</p>
+
+## Scenario 2: Heavy Appliance Box
+
+**Expected action:** `PICK_AND_PLACE` at a low `z` position with a firm grip.
+
+Three intact heavy or sturdy boxes arrive together: a metal tool set, a
+36-can case of canned beans, and a 25 kg set of rubber-coated weight plates.
+Both pallets are empty, so the first heavy box can seed the base layer.
+
+| Field | Value |
+| --- | --- |
+| Visible boxes | `box_0001` (tool set), `box_0003` (canned beans), `box_0004` (weight plates) |
+| Dimensions | `box_0001`: 2 x 2 x 2; `box_0003`: 2 x 2 x 1; `box_0004`: 2 x 2 x 2 |
+| Pallet state | Pallet 1: 0% filled, pallet 2: 0% filled |
+| Valid placement cells | Base-layer `[0, 0, 0]` on either pallet |
+
+Operator-visible rationale:
+
+```text
+All boxes pass damage inspection. Heavy, sturdy boxes belong on the base layer
+for stack stability. With both pallets empty, choose pallet 1 and place the
+first visible heavy box at [0, 0, 0] using firm grip.
+```
+
+Parsed action:
+
+```json
+{
+  "action": "PICK_AND_PLACE",
+  "box": "box_0001",
+  "target_pallet": 1,
+  "position": [0, 0, 0],
+  "speed_pct": 80,
+  "grip_strength": "firm",
+  "reason": "Pure Harvest steel tool set is heavy and sturdy; placed at low z on Pallet 1 to form a stable base."
+}
+```
+
+Simulated outcome: cuRobo plans the pick, and the Doosan P3020 places
+`box_0001` at `[0, 0, 0]` on Pallet 1.
+
+<p align="center">
+  <img src="./assets/scenario2.webp" alt="Heavy appliance scenario places a sturdy box on the base layer" width="900">
+</p>
+
+## Scenario 3: Mixed-SKU Stacking
+
+**Expected action:** place heavy or rigid items below fragile items.
+
+Three intact boxes arrive: a 10-pack of SPAM cans, a 4-pack of glass kimchi
+fermentation jars, and a multi-pack of honey butter chips. Pallet 1 is already
+partially built. The next action should preserve stack quality by placing
+heavier rigid goods at the lowest available stable slot and reserving higher
+layers for fragile goods.
+
+| Field | Value |
+| --- | --- |
+| Visible boxes | `box_0008` (SPAM cans), `box_0010` (glass jars), `box_0011` (chip multipack) |
+| Dimensions | `box_0008`: 2 x 2 x 1; `box_0010`: 2 x 1 x 1; `box_0011`: 2 x 1 x 1 |
+| Pallet state | Pallet 1: 44% filled, pallet 2: 19% filled |
+| Valid placement cells | Mid-layer slots on pallet 1, plus top-layer slots for delicate items |
+
+Operator-visible rationale:
+
+```text
+All boxes pass damage inspection. Canned goods are heavy and rigid, so place
+them at the lowest currently valid slot. Defer glass jars and chips to higher
+slots with gentler handling.
+```
+
+Parsed action:
+
+```json
+{
+  "action": "PICK_AND_PLACE",
+  "box": "box_0008",
+  "target_pallet": 1,
+  "position": [0, 0, 2],
+  "speed_pct": 40,
+  "grip_strength": "firm",
+  "reason": "SPAM cans heavy and rigid; Pallet 1 closer to completion; delicate boxes deferred to high z."
+}
+```
+
+Follow-up delicate-item action:
+
+```json
+{
+  "action": "PICK_AND_PLACE",
+  "box": "box_0029",
+  "target_pallet": 1,
+  "position": [0, 0, 3],
+  "speed_pct": 40,
+  "grip_strength": "gentle",
+  "reason": "box_0029 needs gentle handling; placing it at the top ensures it is not crushed by heavier boxes below."
+}
+```
+
+Simulated outcome: the Doosan P3020 places `box_0008` in a mid-layer stable
+slot, and a later iteration places fragile bottles at the top layer.
+
+<p align="center">
+  <img src="./assets/scenario3.webp" alt="Mixed-SKU scenario places rigid items below delicate items" width="900">
+</p>
+
+## What to Check in Cosmos3 Output
+
+For Nano and Super Diffusers runs, inspect the generated artifact against the
+same operator-review criteria:
+
+- Mixed boxes, pallet grid, and robot cell are visible.
+- Damage or fragile/handling cues are legible enough to support review.
+- The scene leaves safe clearance around the robot arm.
+- The prompt, seed, model ID, backend, and decoded artifact size are recorded.
+- The artifact is treated as validation evidence, not as a production safety
+  decision.
+
+Super should be used when the Nano artifact is too small, noisy, or ambiguous
+for the review objective. The full-stack robot-loop outcome still depends on
+the reference app's parser, pallet constraints, and simulated execution checks.
+
+## Limitations
+
+- This is a simulated proof of concept, not a production robot safety system.
+- Cosmos3-generated artifacts help validate scene prompts and review criteria;
+  they do not certify a real robot workcell.
+- Real deployments need independent safety controls, guarded robot execution,
+  site-specific validation, and human-approved exception handling.
+- The public Doosan stack can change independently of this cookbook, so treat
+  `make docker-test` as a live integration smoke rather than a guaranteed unit
+  test.