Jetson Ai Lab Code Samples

---
name: jetson-ai-lab-code-samples
description: Place downloadable tutorial scripts under public/code-samples/ and link them from tutorial pages. Use when adding, moving, or linking downloadable scripts, assets, or code files for Jetson AI Lab tutorials.
license: Apache-2.0
compatibility: Requires Node.js and npm for optional build verification.
---

# Jetson AI Lab: tutorial scripts and `public/code-samples/`

## Purpose

Runnable **Python**, **shell**, and other assets that users **download or curl** from tutorials must live under the repoΓÇÖs static asset tree:

**`public/code-samples/<topic-folder>/`**

Astro copies `public/` to the site root, so these files are served at:

**`https://www.jetson-ai-lab.com/code-samples/<topic-folder>/<file>`**

(path **`/code-samples/...`** on the deployed site).

Do **not** use a folder named `code-sample` (singular) or skip `public/` for files meant to be fetched by users from the live site.

---

## Layout (existing examples)

Group files by tutorial or feature area (kebab-case folder names, consistent with the repo today):

| Folder | Example files |
|--------|----------------|
| `public/code-samples/finetune/` | `full_sft_finetuning.py`, `lora_finetuning.py`, `qlora_finetuning.py` |
| `public/code-samples/openclaw-orin-nano/` | `setup-openclaw-orin-nano.py`, `endurance-test.py`, `multi-agent-debate.py` |
| `public/code-samples/openpi_on_thor/` | `download.sh`, `build_engine.sh`, `pytorch_to_onnx.py`, Dockerfiles, etc. |

List the current tree with your OS or `git ls-files public/code-samples` before adding new paths.

---

## What to do

1. **Add** new scripts or small assets under the appropriate **`public/code-samples/<topic>/`** directory (create the directory if it is new).
2. **Reference** them from tutorial MD/MDX using either:
   - **Production URL:** `https://www.jetson-ai-lab.com/code-samples/<topic>/<filename>`  
     Example in repo: `src/content/tutorials/model-optimization/finetune-on-jetson.mdx` (wget lines for `full_sft_finetuning.py`, etc.).
   - **Raw GitHub URL** (for `curl | bash` or pipe-to-python):  
     `https://raw.githubusercontent.com/NVIDIA-AI-IOT/jetson-ai-lab/main/public/code-samples/<topic>/<filename>`  
     Example in repo: `src/content/tutorials/applications/openclaw.md`, `src/content/tutorials/vla/openpi_on_thor.md`.

3. **Prefer** keeping long scripts in **`public/code-samples/`** and linking themΓÇöavoid embedding huge scripts only inside MDX unless there is a strong reason.

---

## What not to do

- Do not put user-downloadable tutorial scripts under `src/` alone (they would not be served at `/code-samples/...` unless additionally copied to `public/`).
- Do not invent alternate roots like `static/code-sample/` for this siteΓÇÖs conventions.

---

## Verification

After adding or moving files under `public/code-samples/`:

1. Run **`npm run build`** from the repository root (see skill **`jetson-ai-lab-verify-build`**).
2. Optionally run the dev server and open `/code-samples/<topic>/<file>` locally to confirm the file is served.

---

## Source of truth

| Item | Path |
|------|------|
| Asset root | `public/code-samples/` |
| Finetune tutorial links | `src/content/tutorials/model-optimization/finetune-on-jetson.mdx` (~lines 107ΓÇô110 for wget URLs) |
| OpenClaw raw GitHub links | `src/content/tutorials/applications/openclaw.md` |
| OpenPI Thor links | `src/content/tutorials/vla/openpi_on_thor.md` |