# ODS Drop Ship (ODS2)

Gamma.ai source outline for an AMD-facing ODS2 feature deck.

This brief keeps the public product story hardware-neutral while using AMD
hardware as the concrete opportunity. Ryzen AI Max / Strix Halo is the premium
showcase, and the same ODS2 flow can extend across AMD mini PCs and
small-form-factor systems from Ryzen AI 450-class devices through Ryzen AI Max
systems.

The ODS2 feature is deployed in the ODS codebase and tested in pieces,
but it still needs complete end-to-end validation on packaged target hardware
before it should be described as production-ready appliance onboarding.

## Slide 1: The End State

**Secure AMD-powered local AI, chatting in minutes**

ODS Drop Ship (ODS2) lets an AMD local AI box arrive preinstalled. The
user powers it on, scans a QR code, joins Wi-Fi, and starts using local AI apps
such as Hermes Agent, OpenClaw where enabled, Open WebUI, voice, workflows, and
other ODS services.

No monitor. No SSH. No hunting for IP addresses. Scan, connect, chat.

## Slide 2: What ODS Is

ODS is the local AI app layer for AMD hardware: a local-first AI stack
that bundles inference, chat, agents, voice, workflows, RAG, privacy tools,
dashboards, and extensions onto user-owned hardware.

ODS2 adds the missing appliance experience: a preinstalled device can be handed
to a non-technical user and activated from a phone.

- Local inference and services run on the user's hardware.
- AMD acceleration powers the local model backend where supported.
- Users get familiar app surfaces, not just ports and containers.
- Power users still get the dashboard, telemetry, model controls, diagnostics,
  and service management.
- Non-technical users can go straight to chat and agent workflows.

## Slide 3: The Problem

Local AI hardware is powerful, but setup still feels like a developer workflow.

- Many AI-capable devices ship without a permanent monitor or keyboard.
- Users may not know the device IP address, host name, service ports, or admin
  credentials.
- Wi-Fi setup, local discovery, authentication, and chat access are usually
  separate chores.
- A great AMD hardware story can lose momentum if the first-run experience
  starts with SSH, logs, and network debugging.

## Slide 4: The Opportunity

Make local AI hardware feel like opening a useful device, not configuring a
server.

- A vendor, reseller, lab, or friend can preinstall ODS.
- The recipient can complete setup from a phone, laptop, tablet, or TV.
- The first experience can be a useful local agent, not a terminal.
- ODS keeps the system open for builders while making it approachable
  for everyday users.

## Slide 5: Two AMD Opportunities

**Ryzen AI Max is the showcase. Ryzen AI 450-class systems broaden the path.**

Ryzen AI Max / Strix Halo showcase:

- Premium local AI demo platform.
- Strong story around memory, small form factor, and serious local models.
- Great for creators, labs, developers, and high-end local AI appliances.

Ryzen AI 450-class / mainstream mini-PC category:

- Familiar, broadly deployable system category.
- Familiar small desktop footprint.
- Strong fit for home, office, classroom, and small business local AI.
- Differentiates on private local AI usefulness, not only raw benchmark charts.

## Slide 6: The ODS2 Solution

ODS connects first-run setup, local discovery, authentication, and app
access.

- Printed setup card with Wi-Fi and setup URL QR codes.
- Optional first-boot access point for machines not already on a network.
- Mobile-friendly setup wizard.
- Host-side Wi-Fi scan and connect actions.
- Local mDNS names such as `dashboard.ods.local`, `chat.ods.local`, and
  `hermes.ods.local`.
- Magic-link invite QR that gives the first user an authenticated local session.
- Agent and chat surfaces behind ODS session auth.

## Slide 7: User Journey

1. Power on the preinstalled AMD device.
2. Scan the setup card QR code.
3. Join the setup AP or open the local setup URL.
4. Pick a Wi-Fi network from the first-boot wizard.
5. Scan the invite QR.
6. Land in a local chat or agent experience.
7. Open the dashboard later for models, services, telemetry, and diagnostics.

## Slide 8: Architecture

```mermaid
flowchart LR
    Card["Setup card QR codes"] --> Wizard["First-boot wizard"]
    Wizard --> API["Dashboard API"]
    API --> HostAgent["Host agent"]
    HostAgent --> WiFi["Wi-Fi / NetworkManager"]
    API --> Magic["Magic-link auth"]
    Magic --> Session["Signed local session"]
    Session --> Apps["Local agent and chat apps"]
    Proxy["ods-proxy + mDNS"] --> Wizard
    Proxy --> Apps
    Proxy --> Dashboard["Power-user dashboard"]
```

## Slide 9: Code Proof Points

- Setup card QR generation:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/scripts/generate-setup-card.py#L51>
- First-boot wizard:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/extensions/services/dashboard/src/pages/FirstBoot.jsx#L80>
- Setup and Wi-Fi API:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/extensions/services/dashboard-api/routers/setup.py#L315>
- Host-side Wi-Fi control:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/bin/ods-host-agent.py#L1216>
- Magic-link QR and redemption:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/extensions/services/dashboard-api/routers/magic_link.py#L382>
- First-boot AP mode:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/scripts/ap-mode.sh#L2>
- LAN discovery:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/bin/ods-mdns.py#L4>
- Local reverse proxy:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/extensions/services/ods-proxy/Caddyfile#L65>
- Hermes authenticated entry path:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/extensions/services/hermes-proxy/Caddyfile#L1>
- OpenClaw integration:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/docs/OPENCLAW-INTEGRATION.md>

## Slide 10: Demo Plan

Show the Ryzen AI Max / Strix Halo demo, then show the broader deployment path.

- Start with the Ryzen AI Max / Strix Halo device powered on and no monitor
  attached.
- Scan the setup card from a phone.
- Open the first-boot wizard.
- Join Wi-Fi or confirm existing LAN connectivity.
- Scan the magic-link invite QR.
- Chat with a local agent or chat app from the phone or laptop.
- Open the dashboard to show local services, model status, and controls.
- Close by showing that the same ODS2 flow can ship on mainstream AMD mini PCs.

## Slide 11: What Still Needs Validation

The code is present; packaged appliance images need end-to-end validation.

- End-to-end setup on the exact Ryzen AI Max / Strix Halo image.
- End-to-end setup on one or more Ryzen AI 450-class or adjacent AMD-powered
  mini PC images.
- Wi-Fi adapter AP-mode compatibility.
- NetworkManager behavior across target Linux distributions.
- mDNS behavior across common phone, laptop, router, and VPN environments.
- Agent/chat auth handoff through the proxy on packaged images.
- Recovery path when the user changes networks or loses the setup card.

## Slide 12: Feature Rollout Paths

ODS2 turns preinstalled AMD systems into ready-to-use local AI appliances.

- Premium Ryzen AI Max / Strix Halo showcase: demonstrate full monitorless setup,
  AMD-accelerated local inference, and local agent/chat surfaces.
- Ryzen AI 450-class mini PC deployment path: use the same QR onboarding flow
  on mainstream small-form-factor systems.
- Retail or reseller handoff: preinstall ODS, include the setup card,
  and let the recipient activate the device from a phone.
- Lab, classroom, and office deployment: ship configured local AI boxes without
  requiring each recipient to connect a monitor.
- Marketplace-ready story: once validation is complete, ODS can be
  presented as a local AI app stack that makes AMD hardware immediately useful
  to non-technical users.

## Slide 13: Repo Reference

Use full GitHub URLs. Do not convert them into relative links.

- ODS repo:
  <https://github.com/Light-Heart-Labs/ODS>
- Hardware-neutral ODS2 / headless setup doc:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/docs/HEADLESS-SETUP.md>
- Setup card operator doc:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/docs/SETUP-CARD.md>
- Hermes integration:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/docs/HERMES.md>
- Hermes SSO:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/docs/HERMES-SSO.md>
- OpenClaw integration:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/docs/OPENCLAW-INTEGRATION.md>
- AP mode:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/docs/AP-MODE.md>
- Local proxy:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/docs/ODS-PROXY.md>
- mDNS:
  <https://github.com/Light-Heart-Labs/ODS/blob/main/ods/docs/MDNS.md>

## Closing Message

ODS Drop Ship (ODS2) turns AMD local AI hardware into something a
non-technical user can actually receive, activate, and use. Ryzen AI Max /
Strix Halo can prove the premium experience; Ryzen AI 450-class and adjacent
AMD-powered mini PCs can extend the deployment opportunity.
