Switchyard local runner
=======================

This folder lets the hosted Switchyard page talk to an agent on your own
computer.

Start it:

  Windows:
    Double-click start-runner.cmd

  PowerShell:
    powershell -ExecutionPolicy Bypass -File .\start-runner.ps1

The runner listens on:

  http://127.0.0.1:8787

Default mode:

  SWITCHYARD_PROVIDER=file

That writes the latest board handoff to:

  switchyard-handoff/latest-route.json

Claude Desktop, MCP servers, and local agent scripts can read that JSON file.
No API key is needed for file handoff.

Optional providers:

  Ollama:
    $env:SWITCHYARD_PROVIDER="ollama"
    $env:OLLAMA_MODEL="llama3.2"
    powershell -ExecutionPolicy Bypass -File .\start-runner.ps1

  OpenAI:
    $env:SWITCHYARD_PROVIDER="openai"
    $env:OPENAI_API_KEY="your key"
    $env:OPENAI_MODEL="gpt-4o-mini"
    powershell -ExecutionPolicy Bypass -File .\start-runner.ps1

  Anthropic:
    $env:SWITCHYARD_PROVIDER="anthropic"
    $env:ANTHROPIC_API_KEY="your key"
    $env:ANTHROPIC_MODEL="claude-sonnet-4-5"
    powershell -ExecutionPolicy Bypass -File .\start-runner.ps1

  OpenAI-compatible local server:
    $env:SWITCHYARD_PROVIDER="openai-compatible"
    $env:OPENAI_COMPATIBLE_BASE_URL="http://127.0.0.1:1234/v1"
    $env:OPENAI_COMPATIBLE_MODEL="local-model"
    powershell -ExecutionPolicy Bypass -File .\start-runner.ps1

Provider API keys stay in this PowerShell session. They are not sent to the
Switchyard website.
