Skip to content

LumenBox 0.3.1 — the first run, unblocked

Choose a tag to compare

View all tags
@fakechris fakechris released this 29 Sep 07:40
· 104 commits to main since this release
v0.3.1
2fc1262
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

LumenBox 0.3.1 — the first run, unblocked

Cut on 2026-09-29 from commit 1b5152c (main). This is the release 0.3.0 meant to be:
0.3.0's installers shipped broken and were re-published once already; this one was built
through the release gates that exist because of that incident (docs/27). The drop-in and
bridge are unchanged — fetch them from the 0.3.0 release if you need them.

What changed since 0.3.0

  • The first run says what is wrong. The Box section now distinguishes docker is not
    installed     (it names Docker Desktop and OrbStack, with links), Docker is installed but
    not running     (start it and press again), and the engine being fine (INV-855, #290).
  • The first image pull announces itself — roughly 750MB, a few minutes — and a failed
    pull says which failure it was: the registry has no such tag (update the app), or the
    registry never answered (network; point Settings → Box at a mirror, which is now a
    setting — boxImage in config.json) (INV-856, #291).
  • The setup card asks for the model key first. The welcome note always promised "a
    provider with a key and a box"; now the card grades both, and first run shows only
    Save & restart, so the first save is one that takes effect (INV-857, #292).
  • The box image is published per app version (fakechris/lumenbox:0.3.1) and the app
    pulls exactly that tag on first start (#289).
  • Right-pane display fixes: context and waiting items stay readable (#288).
  • Release-side: release:check now refuses installers with an incomplete dependency tree
    and apps whose image tag is not on Docker Hub (#293). That gate is for us, but it is
    why this page's files work.

Install on macOS

Download the disk image for this Mac, open it, drag LumenBox to Applications.

  • LumenBox-0.3.1-arm64.dmg — Apple Silicon
  • LumenBox-0.3.1-x64.dmg — Intel

The app is signed with an Apple Developer ID certificate but is not notarized.
Gatekeeper will say it cannot be checked. Do one of:

  • right-click the app in Applications → Open → Open (once), or
  • in Terminal: xattr -dr com.apple.quarantine /Applications/LumenBox.app

Then it opens normally. It needs a model key (the setup card asks first) and a box:
Docker Desktop or OrbStack on this Mac, Docker on another machine, or a Grok Bot's box
through the bridge. The walkthrough is Getting started.

Coming from broken 0.3.0?

If the app said "The LumenBox server will not stay up" on first launch, your download
predates the 2026-09-29 re-publish — install this 0.3.1 instead. Your ~/.agentbox
settings and keys survive the swap.

Assets 6
Loading