scene — A live scene of two characters — openbash

Two people, Sam and Maya, talking and moving in an empty world, each with a personality pushed into Qwen3.5-4B; made, cast, started, paused and stopped by command, with a clip of every step.

scene

scene is a command on the openbash shell, reachable over HTTP, SSH and MCP with one key. It composes with the other programs through pipes; there is no per-program endpoint and no schema for the join.

scene create "They meet at a bus stop in the rain." --characters sam,maya

help

scene: a live scene of two characters, made and run by command, as JSON.

THE SCENE
  Two people, Sam and Maya, stand in an empty world. Each can have a
  personality: one persona neuron in Qwen3.5-4B pushed at a dose, from 0.5 to
  1.5. The thirteen are flattering, contemptuous, poetic, upbeat, suspicious,
  condescending, wistful, oracle, bleak, dismissive, ornate, curt and hostile;
  none is the model as it is. A scene has two characters at most.

  Started, the scene runs a step at a time. Qwen3.5-4B decides what each
  character says or how it listens, one after the other, so the second hears
  the first. An animation model, Qwen3.5-4B tuned for the rig, writes each
  body's moves, and Blender makes and checks each clip. A step takes about
  fifteen seconds and makes about ten seconds of animation.

  Change a personality, the cast or the situation at any time: a running scene
  takes the change at its next step.

RETURNS
  One JSON object on stdout: the scene's `id`, `state` (created, starting,
  running, paused, stopped) and `reason` when paused, its `cast`, `usage_s`
  (seconds of GPU time) and `billed_s`, `anim_s` (seconds of animation made),
  and `steps`. Each step has each character's `says`, `act` (what it did),
  `kind` (speak or listen), `clip` (a .glb link), `frames` and `fps`. Also
  `standing`, with the balance and the free animation left.

PRICE
  $0.00215 a second of a running scene's GPU time, about 13 cents a minute,
  billed as it runs; that is three times what the GPU costs us. An account
  that has never paid gets 30 seconds of animation free; after that a start
  is refused until $2 of credit is added, and the `credits` tool gives the
  link. A running scene pauses itself when the credit runs out, and when
  nobody has asked about it for two minutes. The first start after a quiet
  spell waits two to three minutes while the models load, and that time is
  billed too.

WATCH IT
  Call `scene status` every few seconds while it runs: that keeps it running
  and gives the new steps (`--since` the last step seen). The clips play in
  any glTF viewer, or on the scene page at hedwigai.com/try/live-scene.

Studies:
  create      <situation>
      a new scene, paused, with its scene_id
  list       
      this account's scenes: id, state, cast, steps and seconds used
  standing   
      the balance, the free animation left, the price, the characters and personalities
  status      <scene_id>
      the scene's state, cast, seconds used and billed, and its steps: what each character said and did, and each clip's link
  add         <scene_id>
      the scene with the character added; a running scene takes it at its next step
  remove      <scene_id>
      the scene without the character
  personality <scene_id>
      the scene with the character's personality changed, from its next step
  situation   <scene_id>
      the scene with a new situation, from its next step
  start       <scene_id>
      the scene, starting (or resuming): steps follow while the credit lasts
  pause       <scene_id>
      the scene, paused after the step it is on; nothing more is billed once it stops
  stop        <scene_id>
      the scene, stopped for good; its steps and clips stay readable

JSON to stdout, so it composes: pipe to `jq` to pick a field, or `> /tmp/…` to keep it.
Run a study with no arguments — `scene create` — to see what it takes.

What it answers

scene create — a new scene, paused, with its scene_id
scene list — this account's scenes: id, state, cast, steps and seconds used
scene standing — the balance, the free animation left, the price, the characters and personalities
scene status — the scene's state, cast, seconds used and billed, and its steps: what each character said and did, and each clip's link
scene add — the scene with the character added; a running scene takes it at its next step
scene remove — the scene without the character
scene personality — the scene with the character's personality changed, from its next step
scene situation — the scene with a new situation, from its next step
scene start — the scene, starting (or resuming): steps follow while the credit lasts
scene pause — the scene, paused after the step it is on; nothing more is billed once it stops
scene stop — the scene, stopped for good; its steps and clips stay readable