Skip to content

Get started

What is WizardAO?

WizardAO is the one-stop lab for engineers building on Arweave and AO. It ships tutorials, deep-dive guides, a full HyperBEAM book, and complete HyperBEAM references — everything you need to go from zero to production.

At its core is WAO, a lightning-fast testing framework for AOS, HyperBEAM, and AI. Test Lua scripts 1000x faster than mainnet by emulating AO units in memory, launch HyperBEAM nodes from JS test code, build custom devices in Erlang, Rust, C++, Elixir, and Gleam, or spin up standalone local units with a single npx wao.

WAO also ships the WAO SDK — an extension of Wander (aoconnect) with syntactic sugar, seamless message piping, and async message result validation to drastically reduce code size.

This combination — a complete knowledge base plus fast in-memory testing — makes WizardAO the ideal stack for Agent Driven Development on AO and HyperBEAM. AI agents build reliably when they have domain knowledge to avoid hallucinating patterns and a fast feedback loop to iterate autonomously. The HyperADD Framework ties both together.

Start Building

  ┌─────────────────────┬─────────────────────┐
  │                     │  Lua Scripts (AOS)  │  ← smart contracts
  │   Custom Modules    ├─────────────────────┤
  │     (WASM/Lua)      │         AOS         │  ← execution environments
  ├─────────────────────┴─────────────────────┤
  │             HyperBEAM Devices             │  ← composable infrastructure
  ├───────────────────────────────────────────┤
  │                  Arweave                  │  ← permanent storage
  └───────────────────────────────────────────┘

WAO provides five environments — from instant in-memory emulation to production networks:

  fast ◀────────────────────────────────────────────▶ realistic
 
  In-Memory AOS   Local AO   Local HB   WAO Devnet   Remote HB
    emulation      npx wao   sandboxed   Cloudflare   production
EnvironmentDescription
In-memory AOSAOS WASM in Node.js — no server, instant unit tests
Local AO UnitsStandalone units via npx wao — local dev
Local HyperBEAMSandboxed Erlang node — full stack integration
WAO DevnetFull AO stack on Cloudflare Workers — staging with WAO Scan explorer
Remote HyperBEAMProduction nodes — mainnet

AOS — Lua Smart Contracts

Build decentralized processes with Lua handlers running on AO.

Custom Modules — WASM/Lua Execution Modules

Build custom WASM64 or Lua execution modules that run alongside AOS on HyperBEAM.

HyperBEAM Devices — Composable Infrastructure

Build composable devices that extend HyperBEAM's core capabilities — each device is a building block that can be composed with others.

Agent Driven Development

Build WAO projects using the HyperADD (Agent Driven Development) Framework.

WAO Devnet — Edge AO Network for Development

A lightweight edge implementation of the full AO network (AR, SU, MU, CU, BD) on Cloudflare Workers — horizontally and vertically scalable, with WAO Scan block explorer.

Reference

Experiments

Active experiments from the lab — usable but still evolving.