Tutorial 5: Build with PatchAI

Goal: Describe a new tool in plain language and let PatchAI propose a graph you can build and run.

Prerequisites: Getting Started; AI provider configured.

Time: ~15 minutes

You will use: PatchAI (AI Assistant panel)


Steps

  1. Click PatchAI on the toolbar to open the AI Assistant in the dock.
  2. Choose a provider:
    • Anthropic — enter your API key in the AI panel (not Settings)
    • Local — Ollama or LM Studio endpoint (see app README)
  3. Start from an empty graph or a template.
  4. Type a clear request, for example:

    Right-click a MIDI clip and transpose all notes up 5 semitones.

  5. Review the proposed graph on the canvas.
  6. Click Build .ablx (web) or Build & Run (Tauri desktop) — or let PatchAI suggest fixes if build fails.
  7. Test in Live on a MIDI clip.

Expected results

Where What you see
AI panel Suggestion applied to canvas; build validation messages
Live Command works as described

If something goes wrong

Problem What to do
AI not connected Set up AI keys
Build failed after AI edit Read error; ask PatchAI to fix; see read build errors
Wrong trigger Ask AI to use On MIDI Clip explicitly

Next steps