Skip to main content
Run bunx smithers-orchestrator init to scaffold a complete .smithers/ project. The manual steps below are for standalone projects.

Prerequisites

  • Bun >= 1.3
  • TypeScript >= 5

Install

bun add smithers-orchestrator ai @ai-sdk/anthropic zod
bun add -d typescript @types/react @types/react-dom

TypeScript Configuration

{
  "compilerOptions": {
    "target": "ESNext",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "jsx": "react-jsx",
    "jsxImportSource": "smithers-orchestrator",
    "strict": true,
    "noEmit": true,
    "skipLibCheck": true
  }
}
jsxImportSource tells TypeScript to use Smithers’ JSX runtime instead of a browser UI runtime.

Project Shape

my-workflow/
  package.json
  tsconfig.json
  workflow.tsx
  main.ts

Optional: MDX Prompt Files

// preload.ts
import { mdxPlugin } from "smithers-orchestrator/mdx-plugin";

mdxPlugin();
# bunfig.toml
preload = ["./preload.ts"]
bun add -d @types/mdx

Verify

bun run main.ts

Next Steps