# Retriever Landing

> Retriever is a programming framework for building closed-loop robot systems whose perception, reasoning, and control can run together with explicit time and data handoff.

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://openretriever-docs.pages.dev/
- Visual quickstart: https://openretriever-docs.pages.dev/getting-started/visual-quickstart/
- Debug and visualize: https://openretriever-docs.pages.dev/tutorials/debug-and-visualize/
- Examples with expected outputs: https://openretriever-docs.pages.dev/tutorials/examples-and-results/
- Retriever Hub overview: https://openretriever-docs.pages.dev/ecosystem/
- GoldenRetriever examples: https://retriever-space.pages.dev/

## Package and Import Names

- Package target: `retriever-core`; use source-checkout commands until the 0.0.1 PyPI release resolves.
- Python import package: `retriever`
- Source quickstart: run `pixi run demo-webcam-detection-mock` first from the core repository; use `pixi run demo-webcam-detection` next for live webcam/Rerun

## Repo Boundaries

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

Use the docs pages for stable public guidance; use source links when you need implementation details, issues, or contribution workflows.

## Agent Guidance

- For runtime concepts, prefer the core docs `llms.txt`: https://openretriever-docs.pages.dev/llms.txt
- For robot-facing examples, robotics type packs, and Hub-pack candidates, prefer GoldenRetriever examples and type packs: https://retriever-space.pages.dev/
- Keep public text source-grounded and release-safe.

## Source Guidance

Use GitHub for implementation details and contribution workflow; use hosted docs for stable public guidance and examples.