# Retriever Landing

> Retriever is a Python runtime for closed-loop robot systems whose perception, reasoning, and control can run together with explicit time, typed handoff, graph inspection, and replay.

This is the compact public front door. Use it to route users and AI agents to the right Retriever surface.

## Start Here

- Landing: https://openretriever.org/
- Builder start path: https://openretriever.org/start/
- Core docs: https://retriever.build/
- Visual quickstart: https://retriever.build/getting-started/visual-quickstart/
- Debug and visualize: https://retriever.build/tutorials/debug-and-visualize/
- Examples with expected outputs: https://retriever.build/tutorials/examples-and-results/
- Retriever Hub overview: https://retriever.build/ecosystem/
- GoldenRetriever overview: https://golden.retriever.build/
- GoldenRetriever first proof: https://golden.retriever.build/examples/golden-hub-proof/
- GoldenRetriever example catalog: https://golden.retriever.build/examples/

## Package and Import Names

- Use the source checkout for demos/examples today; use hosted docs for stable public instructions.
- Runtime-only package target: `retriever-core`; Python import package: `retriever`.
- Source-checkout smoke: `git clone https://github.com/openretriever/retriever && cd retriever && pixi install && pixi run demo-webcam-detection-mock`; use `pixi run demo-webcam-detection` next for live webcam/Rerun when local hardware is available

## Repo Boundaries

- Core runtime repo target: `openretriever/retriever`
- Landing repo target: `openretriever/landing-site`
- GoldenRetriever examples repo target: `openretriever/golden-retriever`

Use the docs pages for stable public guidance. The install page is the current source-checkout entrypoint; hosted docs remain the stable public route.

## Agent Guidance

- For runtime concepts, prefer the core docs `llms.txt`: https://retriever.build/llms.txt
- For robot-facing examples, robot payload packs, and Hub-pack candidates, prefer the GoldenRetriever example catalog and payload packs: https://golden.retriever.build/examples/
- Keep public text source-grounded and release-safe.

## Source Guidance

Use hosted docs for stable public guidance and examples. Use the install page for current source-checkout commands and package-name status.