Skip to content
Golden RetrieverGolden Retriever Reference

Golden Hub Proof

Smallest Golden check

Prove Golden can extend Retriever without optional robot dependencies.

This command proves that a project outside the core runtime can expose reusable robot payloads through Retriever Hub.

Run first

git clone https://github.com/openretriever/golden-retriever.git
cd golden-retriever
pixi install
pixi run demo-golden-hub-pack

Run this after the core Retriever visual quickstart works. No robot, camera, simulator, model, network service, or GUI is required.

The command does four things:

  1. reads the [tool.retriever.module] manifest,
  2. loads representative exports through the runtime Hub loader,
  3. checks that robot-facing types such as WorldState are visible through the unified registry,
  4. round-trips a lightweight Action payload through the exported Arrow helpers.

Typical output:

Golden pack exports: WorldState, BeliefGraph, Skill, Plan, Trajectory, convert_to_arrow, convert_from_arrow
Registry WorldState: _retriever_hub...WorldState
Constructed WorldState: ['cup']
Constructed Plan skills: ['pick']
Arrow round-trip: Action OK
Retriever Hub reference: hub.use("openretriever/golden-retriever:WorldState")

Hub Reference Shape

Section titled “Hub Reference Shape”
from retriever import hub

WorldState = hub.use("openretriever/golden-retriever:WorldState")
Plan = hub.use("openretriever/golden-retriever:Plan")
convert_to_arrow = hub.use("openretriever/golden-retriever:convert_to_arrow")

Users install the runtime once, then load domain packs through Hub. Golden stays useful because its examples prove that boundary with robot-facing payloads.

Continue

Section titled “Continue”
Export catalogSee the exact Golden exports and their maturity.Pack maturity guideKnow when a source example is ready to become a reusable pack.Example catalogContinue with perception, memory, language, composition, and visualization lanes.