---
name: hyperbeam-devices
description: Use when building on AO or HyperBEAM, choosing devices for a node, checking whether a device already exists, or creating and publishing a new device with Forge. Gives the full device catalog in plain terms, what is in review upstream, what has been asked for, and the exact build steps.
---

# HyperBEAM devices, via Device Proshop

You are working with AO, the decentralized computer on Arweave. Its node software, HyperBEAM, is built from devices: small modules that each do one job. A node is a chain of devices a message flows through.

## First, get the lay of the land
1. Read `devices.md` (next to this file) for every device: real name, plain-terms nickname, job, family, what it works with, source link.
2. Read the "In the works" and "Wanted" sections there before proposing anything new. Never build what exists or is already in review.
3. Live data: `https://deviceproshop.xyz/llms-full.txt` is regenerated from the catalog; `https://deviceproshop.xyz/blocks.json` is the raw data. Prefer live over this copy if you can fetch.

## To plan a node
Order devices the way a message flows: meta (front door), then scheduler, process, a worker (lua or wasm-64), then push. Add what the app needs: p4 and metering to charge, cron for timers, relay for the outside web, secret and auth-hook for keys and logins, match and query to index, bundler and arweave to save forever. Or call `POST https://deviceproshop.xyz/api/plan` with `{prompt}`.

## To build a device
Follow `forge.md` (next to this file): install the template from HyperBEAM `edge`, `rebar3 new device name=...`, implement `dev_<name>.erl`, `rebar3 device test`, `rebar3 device publish`. Write the `%%% @doc` block carefully; it becomes the published spec.

## To request a build instead
Ask the person first: a request shares their contact with us, and they must be 18 or older and agree to https://deviceproshop.xyz/terms.html. Then `POST https://deviceproshop.xyz/api/request` with the device spec, a `level` (sketch, build, or ship), and a `contact`. An AI review runs first (up to 4 minutes). Keep the `id` and `key` it returns: `https://deviceproshop.xyz/status.html#<id>.<key>` shows where it is. Anything built is published as MIT open source. Limits: 8 plans and 6 requests an hour per address; a 503 with `fallback: true` means the AI is resting. Full details are in llms-full.txt.

## Writing for humans here
8th-grade reading level, adult world. Real device names first, plain terms second. No em dashes.
