Swift

// Package.swift
dependencies: [
    .package(url: "https://github.com/synheart-ai/syni-swift.git", from: "0.0.4"),
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "Syni", package: "syni-swift"),
        ]
    ),
]

# Podfile
pod 'Syni', '~> 0.0.4'

curl -fsSL https://synheart.sh/install | sh
synheart install runtime syni

import Syni

let agent = SyniAgent()

// Load a persona by id from bundled spec assets.
let persona = try await SyniSpecPersona.load("focus.coach.v1")

// First-run install: download + verify the model, load the engine,
// bind the persona. Emits lifecycle events on agent.installState.
try await agent.install(
    persona: persona,
    model: SyniModels.qwen25_15bInstructQ4
)

// Single-turn chat.
let response = try await agent.chat("How can I focus right now?")
print(response.displayText)

for try await event in agent.chatStream("hello") {
    switch event {
    case let .delta(text):
        print(text, terminator: "")
    case let .final(response):
        print("\n[\(response.displayText.count) chars]")
    }
}

let agent = SyniAgent(
    cloudConfig: SyniCloudConfig(
        baseUrl: "https://api.synheart.ai",
        authToken: { "<bearer-token>" },
        tenantId: "<tenant>",
        userId: "<user>"
    )
)

let response = try await agent.chat(
    "how was my recent session?",
    mode: .cloudFirst // try cloud, fall back to local
)

@Observable
final class InstallVM {
    var state: SyniInstallState = .notInstalled
    private var cancellable: AnyCancellable?

    func observe(_ agent: SyniAgent) {
        cancellable = agent.installState.sink { [weak self] in self?.state = $0 }
    }
}

// In your view
switch vm.state {
case .notInstalled:               Button("Install model") { /* trigger install */ }
case let .installing(stage, p):   ProgressView("\(stage)", value: p)
case .installed:                  ChatView()
case let .failed(reason, _):      Text("Install failed: \(reason)")
}