Add the SDK
to your project.

01Swift Package Manager

Add the package to your Package.swift:

// swift-tools-version: 5.9
import PackageDescription

let package = Package(
    name: "MyAgent",
    platforms: [.macOS(.v14), .iOS(.v17)],
    dependencies: [
        .package(
            url: "https://github.com/terryso/open-agent-sdk-swift",
            from: "0.1.0"
        )
    ],
    targets: [
        .executableTarget(
            name: "MyAgent",
            dependencies: [
                .product(name: "OpenAgentSDK",
                         package: "open-agent-sdk-swift")
            ]
        )
    ]
)

Then build:

swift build

02Xcode

1. In Xcode, choose File → Add Package Dependencies…
2. Paste the repository URL:

   https://github.com/terryso/open-agent-sdk-swift

3. Pick a version rule (default: Up to Next Major) and add OpenAgentSDK to your target.

03System Requirements

• ●macOS 14+ (Sonoma) or iOS 17+
• ●Swift 5.9+ — Xcode 15 or newer
• ●An API key for at least one provider (Anthropic, OpenAI, Ollama, GLM)

04Environment Variables

The SDK reads provider credentials from standard env vars when you don't pass them explicitly:

# Required: one provider key
export ANTHROPIC_API_KEY="sk-ant-..."
# or
export OPENAI_API_KEY="sk-..."

# Optional: CodeAny gateway
export CODEANY_API_KEY="ca-..."