nvidia
Recipe card from the charly-distros plugin (Images — the deployable catalog).
nvidia
Section titled “nvidia”NVIDIA GPU base image — provides GPU runtime (driver libs, CDI toolkit) and CUDA development toolkit on Fedora.
The nvidia and cuda candies are multi-distro (Fedora rpm + Arch pac), so a
CachyOS GPU base exists alongside this Fedora nvidia box: cachyos.nvidia
(cachyos + agent-forwarding + nvidia + cuda) in the opencharly/distro-cachyos
submodule. The two are siblings — pick the Fedora nvidia box for the
RPM-based GPU stack, cachyos.nvidia for the Arch/CachyOS GPU stack. See
/charly-distros:cachyos.
Box Properties
Section titled “Box Properties”| Property | Value |
|---|---|
| Base | fedora-nonfree (fedora + RPM Fusion) |
| Layers | agent-forwarding, nvidia, cuda |
| Platforms | linux/amd64 |
| Registry | ghcr.io/opencharly |
Full Candy Stack
Section titled “Full Candy Stack”fedora-nonfree(fedora + rpmfusion — provides RPM Fusion free + nonfree repos)nvidia— GPU runtime: driver libs, nvidia-container-toolkit (CDI), VA-APIcuda— CUDA toolkit, cuDNN, onnxruntime, ffmpeg-libs
Quick Start
Section titled “Quick Start”The nvidia box lives in the opencharly/distro-fedora submodule (box/fedora):
charly -C box/fedora box build nvidiacharly shell nvidiaKey Candies
Section titled “Key Candies”/charly-distros:nvidia— NVIDIA GPU runtime (driver libs, CDI generation via nvidia-ctk)/charly-distros:cuda— CUDA toolkit and GPU development libraries
Derived Boxes
Section titled “Derived Boxes”/charly-languages:python-ml— ML Python environment/charly-jupyter:jupyter— Jupyter notebook server/charly-ollama:ollama— LLM inference server/charly-comfyui:comfyui— image generation UI
Related Boxes
Section titled “Related Boxes”/charly-distros:fedora— parent base (no GPU)/charly-distros:cachyos—cachyos.nvidiais the CachyOS GPU-base sibling (Arch/CachyOS GPU stack)/charly-coder:charly-arch— Arch Linux charly toolchain with nvidia (shared candies)/charly-distros:charly-fedora— Fedora charly toolchain with nvidia (shared candies)
Verification
Section titled “Verification”After charly box build:
charly shell nvidia -c "nvidia-smi"— GPU infocharly shell nvidia -c "nvidia-ctk --version"— CDI toolkitcharly shell nvidia -c "nvcc --version"— CUDA compiler
When to Use This Skill
Section titled “When to Use This Skill”MUST be invoked when the task involves the nvidia box, GPU base images, CUDA in containers, or CDI device configuration. Invoke this skill BEFORE reading source code or launching Explore agents.
Related
Section titled “Related”/charly-image:image— image family umbrella (candy:image entries — those carryingbase:/from:— incharly.yml, build/validate/inspect/list)/charly-build:build— the embedded build vocabulary (distros, builders, init-systems)