# How It Works

Producer Pal looks simple from the outside: drop one device onto a track, point
your AI at it, and ask for music. Underneath, it's doing something most projects
in this space don't attempt — running a **full, modern Node.js server** and
**complete, real-time control of Ableton Live** together inside a single Max for
Live device.

These pages open the hood and explain how, from the big picture down to the
fiddly details.

## Start here

- **[Running Inside Ableton Live](/how-it-works/running-inside-live)** — the big
  picture: two superpowers that usually live apart — a modern Node.js runtime
  and Live's full API — fused into one device, and why that combination is what
  an AI music assistant actually needs.

## Going deeper

- **[The Bridge: JSON Over Patch Cables](/how-it-works/the-bridge)** — the
  technical heart: how the Node.js server and the Live API engine talk to each
  other by sending JSON over Max patch cables, including the chunking scheme for
  oversized messages and the trick for capturing warnings on the way back.

- **[More Than a Live API Wrapper](/how-it-works/more-than-a-wrapper)** — why
  Producer Pal isn't a thin pass-through: the refinements that give the AI a
  clean, intuitive interface, and the workarounds that add capabilities the Live
  API doesn't offer at all — including a property Live never documented.

- **[Why Not an Ableton Extension?](/how-it-works/why-not-an-extension)** — how
  this approach compares to Ableton's new Extensions SDK, and the capabilities
  Producer Pal has today that an extension can't match.