Skip to content

Split graphics and video, and document the video checkpoint limit - #344

Open
Hkhan161 wants to merge 4 commits into
masterfrom
harris/checkpoint-vulkan-video-docs
Open

Hkhan161 wants to merge 4 commits into
masterfrom
harris/checkpoint-vulkan-video-docs

Conversation

@Hkhan161

@Hkhan161 Hkhan161 commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

Why

This PR started out saying graphics and video were both unsupported. That is no longer right for video.

ubuntu-ami#139 (merged Sep 1) allowed compute,utility,graphics,video on every GPU node so NVIDIA NIM images stop crash-looping — they ship NVIDIA_DRIVER_CAPABILITIES=compute,utility,video. So the two now need different answers:

  • Video (NVENC/NVDEC/NVJPG) will run once Init-cortex -> init #139 reaches a baked AMI, but cannot be checkpointed.
  • Graphics (Vulkan/OpenGL/EGL) still doesn't work. I tested vulkaninfo on an A10G with the caps widened and all ICD libraries present; it fails at ICD load, so the capability being allowed isn't sufficient. Documented as unsupported, no checkpoint anchor.

What

  • Limitations: one combined bullet becomes two, since the causes and the advice differ.
  • New ## Video encode and decode section, anchored video-encode-and-decode to match docsAnchorVideo in checkpoint-agent PR Kats/increase-num-train-epochs #101.
  • The section says explicitly that a single-process app is enough and spawn doesn't help. That's the trap: the error people currently get tells them to stop forking, and I confirmed on hardware that a single-process ffmpeg h264_nvenc with no children hits it.

Merge order

Depends on gVisor #69 → agent #101 for the anchor to be reachable. Hold this until #139 is in a baked AMI — until then it would claim video runs when it doesn't.

The agent links here when a save fails because the sandbox has the
NVIDIA graphics or video driver capability enabled.

Co-authored-by: Cursor <cursoragent@cursor.com>
@mintlify

mintlify Bot commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
cerebrium 🟢 Ready View Preview Sep 11, 2026, 2:34 PM

@Hkhan161

Copy link
Copy Markdown
Contributor Author

Sibling PRs: agent https://github.com/CerebriumAI/cerebrium-checkpoint-agent/pull/100, gVisor https://github.com/CerebriumAI/gvisor/pull/68. Merge this first so the agent's new anchors are live.

Vulkan/NVENC workloads do not run at all: runsc keeps the stock
utility,compute allowed driver capabilities, so an app requiring the
graphics or video capability fails to start or fails at driver init.
State that rather than framing it as a checkpoint failure reason, and
drop the two anchor-linked sections since no classifier links to them.

Co-authored-by: Cursor <cursoragent@cursor.com>
@Hkhan161 Hkhan161 changed the title Name Vulkan and video encode as checkpoint failures Document graphics and video APIs as unsupported Sep 11, 2026
Graphics and video are no longer the same story. ubuntu-ami#139 allowed
compute,utility,graphics,video for NVIDIA NIM images, so video engines
will run once that lands in a baked AMI, while Vulkan still fails at ICD
load.

Video therefore becomes a checkpoint failure cause with its own section
and anchor, matching the agent's docsAnchorVideo.

Co-authored-by: Cursor <cursoragent@cursor.com>
@Hkhan161 Hkhan161 changed the title Document graphics and video APIs as unsupported Split graphics and video, and document the video checkpoint limit Sep 11, 2026
Co-authored-by: Cursor <cursoragent@cursor.com>

This branch was successfully deployed

1 active (outdated) deployment
staging facf1f76 Deployed Sep 11, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant