build(docker): lucebox-hub container image + CI release pipeline by easel · Pull Request #334 · Luce-Org/lucebox-hub

easel · 2026-06-03T21:29:59Z

Summary

Containerization and CI plumbing for lucebox-hub. Adds a Dockerfile + docker-bake.hcl + scripts/build_image.sh that build the image, an entrypoint that emits IMAGE_INFO / HOST_INFO sidecars consumed by /props schema-3/4, and GitHub Actions for image build (docker.yml), CI integration, and luce-bench release tagging. Also ships workspace-root files the build needs (pyproject.toml, uv.lock, Makefile, .gitignore, README, .dockerignore).

This PR is the foundational docker stack — siblings #335 (lucebox-cli) and #337 (luce-bench) layer their Python surfaces on top. To keep CI green on this branch alone, the root pyproject.toml workspace members list, Dockerfile COPY directives, and Makefile test target intentionally exclude lucebox/, luce-bench/, and harness/ — those re-appear in their respective sibling diffs.

Files

Build/runtime: Dockerfile, docker-bake.hcl, scripts/build_image.sh, server/scripts/entrypoint.sh, .dockerignore
CI: .github/workflows/docker.yml, .github/workflows/release-luce-bench.yml, .github/workflows/ci.yml
Workspace root: pyproject.toml, uv.lock, Makefile, .gitignore, README.md

Dependencies

feat(lucebox): hub CLI + autotune/sweep/profile + harness adapters + shell wrapper #335 (lucebox-cli) — re-adds lucebox to the workspace members list, re-introduces the COPY ./lucebox /src/lucebox (and runtime stage copy) into the Dockerfile, restores the lucebox/**/*.py ruff include, and wires the lucebox/tests path back into make test. The lucebox CLI subcommand routing in server/scripts/entrypoint.sh is already in place; it just won't resolve until the package lands.
feat(luce-bench): in-tree bench harness + multi-turn agent_recorded + LLM judge #337 (luce-bench) — re-adds luce-bench to workspace members, re-introduces the COPY ./luce-bench /src/luce-bench (and runtime stage copy) into the Dockerfile, restores the luce-bench/tests path in make test, and unblocks the release-luce-bench.yml tag-push workflow (currently shipped but won't fire until the luce-bench/ source tree exists).

This PR builds green on its own. Once #335 and #337 land they each add their own slice of workspace members, Dockerfile COPYs, and Makefile entries.

Test plan

uv lock --check + uv sync --frozen pass (workspace member list matches on-disk dirs)
uv run --frozen --extra dev ruff check . passes
docker buildx bake cuda12-local --load produces a working lucebox-hub:cuda12 image on this branch alone
scripts/build_image.sh produces the expected lucebox-hub:build-env and runtime images
Entrypoint emits IMAGE_INFO / HOST_INFO that /props schema-3/4 consumes correctly
.github/workflows/docker.yml runs cleanly in CI
After feat(lucebox): hub CLI + autotune/sweep/profile + harness adapters + shell wrapper #335/feat(luce-bench): in-tree bench harness + multi-turn agent_recorded + LLM judge #337 land: make test runs the full lucebox + luce-bench suite; image build re-includes the lucebox CLI and the in-container python -m lucebench smoke path

Moved from PR Luce-Org#334 (docker-stack) where it was flagged as out-of-scope. luce-bench/tests/test_extract_agentic_fixture.py loads this script via path, so it belongs in the same PR as the tests.

… adapters ## What New lucebox/ Python package exposing the hub CLI (autotune, sweep, profile, smoke, models, config, download, host-check, docker_run) plus the lucebox.sh launcher wrapper and install.sh. Adds the harness/ adapter package wrapping external coding agents (claude_code, codex, hermes, openclaw, opencode, pi) that autotune sweeps drive. Ships scripts/check_lucebox_wrapper_sandbox.sh and scripts/test_lucebox_sh.sh for wrapper validation, full pytest coverage under lucebox/tests/, and the bragi autotune profile-sweep protocol docs. ## Why This is the user-facing surface of lucebox-hub: one CLI to launch the image, tune layer-split / pflash settings against a host, run sweeps, and dispatch bench runs. Splitting it out keeps Python-side review independent of the C++ server and Docker stack reviews. ## Dependencies - Luce-Org#334 (docker-stack): docker_run.py launches the lucebox-hub image - Luce-Org#337 (lucebench-harness): lucebox bench delegates to luce-bench (workspace dep) - Luce-Org#336 (server-layer-split): autotune presumes layer-split build artifacts

cubic-dev-ai

5 issues found across 13 files

_{Reply with feedback, questions, or to request a fix.

Re-trigger cubic}

… adapters ## What New lucebox/ Python package exposing the hub CLI (autotune, sweep, profile, smoke, models, config, download, host-check, docker_run) plus the lucebox.sh launcher wrapper and install.sh. Adds the harness/ adapter package wrapping external coding agents (claude_code, codex, hermes, openclaw, opencode, pi) that autotune sweeps drive. Ships scripts/check_lucebox_wrapper_sandbox.sh and scripts/test_lucebox_sh.sh for wrapper validation, full pytest coverage under lucebox/tests/, and the bragi autotune profile-sweep protocol docs. ## Why This is the user-facing surface of lucebox-hub: one CLI to launch the image, tune layer-split / pflash settings against a host, run sweeps, and dispatch bench runs. Splitting it out keeps Python-side review independent of the C++ server and Docker stack reviews. ## Dependencies - Luce-Org#334 (docker-stack): docker_run.py launches the lucebox-hub image - Luce-Org#337 (lucebench-harness): lucebox bench delegates to luce-bench (workspace dep) - Luce-Org#336 (server-layer-split): autotune presumes layer-split build artifacts

cubic-dev-ai

1 issue found across 3 files (changes from recent commits).

_{Reply with feedback, questions, or to request a fix.

Re-trigger cubic}

… adapters ## What New lucebox/ Python package exposing the hub CLI (autotune, sweep, profile, smoke, models, config, download, host-check, docker_run) plus the lucebox.sh launcher wrapper and install.sh. Adds the harness/ adapter package wrapping external coding agents (claude_code, codex, hermes, openclaw, opencode, pi) that autotune sweeps drive. Ships scripts/check_lucebox_wrapper_sandbox.sh and scripts/test_lucebox_sh.sh for wrapper validation, full pytest coverage under lucebox/tests/, and the bragi autotune profile-sweep protocol docs. ## Why This is the user-facing surface of lucebox-hub: one CLI to launch the image, tune layer-split / pflash settings against a host, run sweeps, and dispatch bench runs. Splitting it out keeps Python-side review independent of the C++ server and Docker stack reviews. ## Dependencies - Luce-Org#334 (docker-stack): docker_run.py launches the lucebox-hub image - Luce-Org#337 (lucebench-harness): lucebox bench delegates to luce-bench (workspace dep) - Luce-Org#336 (server-layer-split): autotune presumes layer-split build artifacts

Containerization stack for lucebox-hub. Dockerfile + docker-bake.hcl build the lucebox-hub image (build-env and runtime stages); scripts/build_image.sh drives local builds; server/scripts/entrypoint.sh emits IMAGE_INFO / HOST_INFO sidecars consumed by /props. GitHub Actions add .github/workflows/docker.yml (build & publish), update ci.yml, and add release-luce-bench.yml for tagging. Workspace-root files (pyproject.toml, uv.lock, Makefile, lefthook.yml, .gitignore, README) live here because the Dockerfile uv-syncs the workspace at build time. Provides the reproducible image and CI pipeline every other split PR deploys into. Centralizing build/publish here keeps Dockerfile, entrypoint, and workspace-root pinning in one reviewable change. - Luce-Org#335 (lucebox-cli): Dockerfile COPYs lucebox/ into the image - Luce-Org#337 (lucebench-harness): Dockerfile COPYs luce-bench/ into the image

- Makefile clean-models: validate MODELS_DIR before rm -rf; reject /, empty, $HOME, and top-level system dirs to prevent catastrophic deletion when overriding the variable. - entrypoint.sh _emit_gpu_array: split nvidia-smi CSV on `,` (with per-field whitespace trim) rather than the literal `, ` two-char separator, so drivers that emit bare comma delimiters still parse GPU metadata correctly into /props.host. - entrypoint.sh draft auto-resolution: sort find matches lexicographi- cally before head -1 so the picked draft is deterministic across filesystems (find traversal order alone is FS-dependent). - entrypoint.sh multi-target: refuse to auto-select when multiple target GGUFs are present in models/. Die with the candidate list so the operator must pick via DFLASH_TARGET — silently picking the alphabetical first has burned us on bench runs before. - docker.yml: add `on: push: branches: [main]` and include push-on-main in the bake-action push condition so main merges actually publish the rolling `:cuda12` tag (the metadata `enable=` rule already expected it).

The builder lost libcurl4-openssl-dev, so find_package(CURL) fails at configure and server/CMakeLists.txt skips the dflash_server target ("CURL not found — skipping dflash_server"). The build then dies with `ninja: error: unknown target 'dflash_server'`. The runtime stage keeps curl + libcurl4; the builder needs the -dev package for the HTTP server. Co-Authored-By: WOZCODE <contact@withwoz.com>

Adds a "Quick Start With Docker" block between the harness quick-start and "Run the Server": the cuda12 GHCR pull/run command (commands left, docker.png right, mirroring the harness section layout) plus a link to the Docker blog. docker.png is exempted from LFS in .gitattributes like assets/banner.png, so it ships as a normal blob (no fork LFS push). Co-Authored-By: WOZCODE <contact@withwoz.com>

easel force-pushed the feat/docker-stack branch from 06d1366 to 5627861 Compare June 4, 2026 02:27

This was referenced Jun 4, 2026

feat(luce-bench): in-tree bench harness + multi-turn agent_recorded + LLM judge #337

Open

feat(lucebox): hub CLI + autotune/sweep/profile + harness adapters + shell wrapper #335

Open

easel force-pushed the feat/docker-stack branch from 5627861 to cf05060 Compare June 4, 2026 04:48

easel force-pushed the feat/docker-stack branch 2 times, most recently from dcf3597 to f3bda05 Compare June 4, 2026 05:02

easel mentioned this pull request Jun 4, 2026

feat(lucebox): docker stack + CLI + bench/profile + harness + luce-bench in-tree #285

Closed

easel force-pushed the feat/docker-stack branch from f3bda05 to b203876 Compare June 4, 2026 17:15

easel force-pushed the feat/docker-stack branch from b203876 to 08f079f Compare June 4, 2026 17:19

easel force-pushed the feat/docker-stack branch from 34d96a7 to 1ab4599 Compare June 4, 2026 18:37

easel marked this pull request as ready for review June 4, 2026 23:18

cubic-dev-ai Bot reviewed Jun 4, 2026

View reviewed changes

Comment thread Makefile Outdated

Comment thread server/scripts/entrypoint.sh Outdated

Comment thread .github/workflows/docker.yml

Comment thread server/scripts/entrypoint.sh Outdated

Comment thread server/scripts/entrypoint.sh

cubic-dev-ai Bot reviewed Jun 5, 2026

View reviewed changes

Comment thread server/scripts/entrypoint.sh

easel added 2 commits June 8, 2026 18:09

easel force-pushed the feat/docker-stack branch from df5d052 to e28f4e6 Compare June 8, 2026 22:09

easel pushed a commit to easel/lucebox-hub that referenced this pull request Jun 9, 2026

docs: record PR Luce-Org#334 merge resolution

aa66b4d

easel pushed a commit to easel/lucebox-hub that referenced this pull request Jun 9, 2026

docs: refresh auto-integration head after PR Luce-Org#334 checkpoint

c938a4a

davide221 and others added 2 commits June 9, 2026 10:59

easel pushed a commit to easel/lucebox-hub that referenced this pull request Jun 9, 2026

docs: refresh auto-integration manifest after PR Luce-Org#334

bc37a41

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

build(docker): lucebox-hub container image + CI release pipeline#334

build(docker): lucebox-hub container image + CI release pipeline#334
easel wants to merge 4 commits into
Luce-Org:mainfrom
easel:feat/docker-stack

easel commented Jun 3, 2026 •

edited by davide221

Loading

Uh oh!

cubic-dev-ai Bot left a comment •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cubic-dev-ai Bot left a comment •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

easel commented Jun 3, 2026 • edited by davide221 Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Files

Dependencies

Test plan

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

easel commented Jun 3, 2026 •

edited by davide221

Loading

cubic-dev-ai Bot left a comment •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading