Skip to content

glowcap v0.1.0 alpha

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 31 Oct 11:19
· 234 commits to dev since this release
v0.1.0
37c545f

Choose a download

For the CLI, Rooms, browser assets, and agent skills, choose CLI + Rooms.
Its filename starts with glowcap-v0.1.0-. The C SDK starts with
glowcap-c-v0.1.0- and contains headers and libraries for building applications.
The SDK does not contain the CLI or Rooms.

Platform Product Libraries Requires
macOS, Apple Silicon (M1 and later) CLI + Rooms C SDK macOS 15.0.0 or newer
macOS, Intel CLI + Rooms C SDK macOS 15.0.0 or newer
Linux, ARM64 CLI + Rooms C SDK glibc 2.39.0 or newer
Linux, x86-64 CLI + Rooms C SDK glibc 2.39.0 or newer

Windows and Linux musl distributions, including Alpine, have no prebuilt package.
GitHub's automatic Source code downloads contain source for building.
They are separate from the compiled downloads above.

Verify and install the product

Download your product archive and SHA256SUMS.
For example, on an Apple Silicon Mac:

archive=glowcap-v0.1.0-aarch64-macos.tar.gz
shasum -a 256 "$archive"

On Linux, choose the Linux archive and use sha256sum "$archive" instead.
Compare the result with the same filename in SHA256SUMS.
With the GitHub CLI installed, also verify the signed publication attestation:

gh attestation verify "$archive" \
  --repo glowcap-org/glowcap \
  --signer-workflow glowcap-org/glowcap/.github/workflows/release.yml \
  --predicate-type https://glowcap.org/attestations/release-publication/v1

Then extract into a new directory and install the complete product:

mkdir glowcap-unpacked
tar -xzf "$archive" -C glowcap-unpacked
./glowcap-unpacked/bin/glowcap install
export PATH="$HOME/.local/bin:$PATH"
glowcap help
glowcap apps rooms serve

Open the browser URL printed by serve. Ctrl-C stops the service.
Add the PATH entry to your shell configuration. Keep the installed product's
files together, rather than moving only bin/glowcap.

macOS executables are not Developer ID signed or notarized. After verification,
use Open Anyway under System Settings, Privacy & Security if macOS
blocks execution. Keep Gatekeeper enabled.

Inside the product, bin/glowcap is the CLI, libexec/ contains Rooms services,
share/glowcap/rooms/ holds browser assets, and share/glowcap/skills/ holds
agent skills. Installation and Rooms commands.

Use the C SDK

Extract the C SDK into an empty directory. Use include/ and lib/ with
your C compiler, following the C ABI guide.
It has no CLI to install. Use libraries from the same SDK build.

Run the Rooms container

The public image supports Linux amd64 and arm64. Docker selects the architecture,
including on macOS with Docker Desktop. This command keeps state in a named volume:

docker run --rm --name glowcap-rooms \
  -p 127.0.0.1:8080:8080 \
  -v glowcap-rooms-state:/state \
  -e GLOWCAP_ROOMS_STATE=/state \
  ghcr.io/glowcap-org/glowcap-rooms:v0.1.0 --http-bind=0.0.0.0

Open http://127.0.0.1:8080. The web port is local to this machine. The directory
uses encrypted iroh discovery and can be reached by peers holding its locator.
For persistent supervised hosting and HTTPS, use the
deployment guide.

Libraries, source, and license

Zig users can depend on the v0.1.0 source. Rust,
Python, TypeScript, and Racket users can build the tagged
language bindings. The browser files in the
product are the Rooms application, not a separately published binding package.

Apache-2.0 alpha software. APIs, ABIs, and storage formats may change before 1.0.
Read the project provenance and the
LICENSE-APACHE and LICENSE-THIRD-PARTY files included in each archive.
Source commit: 37c545ff231ccbfec305aba4fb8efe05dae8ee35. Original artifact run.