Experimental Build Framework

RadBuild Packages

RadBuild is the graph-based build framework for FPGA, Linux, firmware, software, package, deployment, RADPx-OS image, VSCode, and optional server workflows.

Version: 0.2.1 Suite: experimental Runtime: frozen executables Architectures: amd64 runtime, all docs/assets

Install RadBuild

Add the signed experimental repository from the home page, then install the frozen CLI and optional components.

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://radical-computer-technologies.github.io/RadicalPackages/keys/radical-packages-archive-key.asc \
  | sudo gpg --dearmor -o /etc/apt/keyrings/radical-packages.gpg

sudo tee /etc/apt/sources.list.d/radical-computer-technologies-experimental.sources >/dev/null <<'EOF'
Types: deb
URIs: https://github.com/Radical-Computer-Technologies/RadicalPackages/releases/download/apt-experimental
Suites: ./
Signed-By: /etc/apt/keyrings/radical-packages.gpg
Architectures: amd64 arm64
EOF

sudo apt update
sudo apt install radbuild
sudo apt install radbuild-radhdl radbuild-server radbuild-vscode-support radbuild-doc

Commands

radbuild project validate
Validate graph settings.

radbuild build os --json-events
Build and smoke RADPx-OS images.

settings.terminal.json / settings.wm.json
Select terminal-only or RADCompositor/Slint RADPx profiles.

rkconfig
Configure RADPx hostname, root password, terminal scale, and rootfs sizing.

radbuild build all --json-events
Run graph builds with machine-readable progress.

radbuild-graph
Inspect dependency order.

radbuild-hdlgen
Browse/generate RadHDL assets.

VSCode Front-End

The radbuild-vscode-support package stages an installable VSIX with a RadBuild activity-bar panel. The Projects pane lists registered projects with a focused Open action, plus toolbar access to Toolchain Setup, project registration, and template-based project creation.

Toolchain Setup
Rescans Vivado and PetaLinux roots, prunes invalid versions, and exposes version dropdowns.

Create Project
Changing templates resets defaults and disables fields that do not apply.

Project Settings
Edits baseline settings, systems, config values, and toolchain selectors through a form UI.

sudo apt install radbuild-vscode-support
code --install-extension /usr/share/radbuild/vscode/radbuild-vscode-0.2.1.vsix --force

Published Packages

Package	Purpose	Install
`radbuild`	Frozen CLI tools, graph build providers, and helper commands.	`sudo apt install radbuild`
`radbuild-radhdl`	Packaged RadHDL catalog and source assets installed at `/usr/share/radbuild/radhdl`.	`sudo apt install radbuild-radhdl`
`radbuild-server`	Optional web server, review DB, client, worker, and LLM helper tools.	`sudo apt install radbuild-server`
`radbuild-vscode-support`	VSCode extension source and compiled support files.	`sudo apt install radbuild-vscode-support`
`radbuild-doc`	RadBuild documentation.	`sudo apt install radbuild-doc`

Repository Metadata

Experimental APT ReleaseSigned package-manager metadata and package assets. RadBuild 0.2.1 ReleaseFrozen Linux x86_64 archive, Debian packages, checksums, and signatures. APT Signing KeyPublic key for Signed-By install instructions. RadBuild 0.2.1 DocsInstall, FPGA builds, OS builds, packaging, examples, and compatibility notes.

RADPx From Scratch

After installing only radbuild, create a RADPx project from the packaged terminal template, configure it with menuconfig, and build a runnable x86 VM image.

mkdir -p ~/radix-work
radbuild project create ~/radix-work --non-interactive --template radix-os-terminal --project-name radix-terminal
cd ~/radix-work/radix-terminal
radbuild menuconfig --settings settings.json
radbuild build os --settings settings.json --json-events
./artifacts/radix/x86_64-grub-terminal/run-radix-vm.sh

Full RADPx From Scratch ExampleProject creation, packagegroups, rkconfig, artifacts, and VM login checks. OS Build ProvidersRADPx, PetaLinux, and Buildroot support levels. Settings Field ReferenceDetailed settings.json, rkconfig, packagegroup, and SDK fields.

Related Packages

RADLibRuntime libraries consumed by target systems RADPx-OSExperimental OS image and kernel API track RADBardExperimental application package track