Hands‑on • Copy & run

Tutorials & Recipes

Common tasks with copy‑paste snippets. Use the live widget (bottom‑right) to set your Hub URL and stream task output.

How to stream a task

  1. Ctrl‑click the widget title “Hub” to set AETHERRA_HUB_URL.
  2. Paste the task id into the input and click “watch”.

Recipes

1) Hello world chain

Create hello.aether:

name: hello-world
version: 0.1.0
chains:
    - id: greet
        steps:
            - use: echo
                with: { text: "Hello, Aetherra!" }

Run it, then watch the task in the widget.

2) Fetch + transform JSON

name: fetch-transform
version: 0.1.0
chains:
    - id: pipeline
        steps:
            - use: fetch
                as: data
                with: { url: "https://httpbin.org/json" }
            - use: transform
                with:
                    input: ${data.body}
                    select: $.slideshow.title

Watch the stream to see the selected field emitted.

3) Memory recall in chat

name: memory-chat
version: 0.1.0
chains:
    - id: convo
        steps:
            - use: memory.store
                with: { text: "Agent favorite color is violet." }
            - use: chat
                with:
                    prompt: "What is my favorite color?"

Ensure memory and chat capabilities are available in your Hub; stream the conversation via the widget.

More: .aether Language · Plugin SDK