Install Primordial and verify setup.

Requirements

• Xcode 26.0+
• Swift 6.2+
• iOS / iPadOS 17.0+
• macOS 14.0+
• Physical iPhone/iPad or Apple silicon Mac for local AI

Install

Primordial is added as one Swift Package product. Use the Git repository URL below, select the release version shared with you, and link only the Primordial product to the app target.

1. Open your app in Xcode.
2. Choose File > Add Package Dependencies.
3. Enter the package URL below. Do not paste a release download URL.
4. Set Dependency Rule to Exact Version.
5. Enter 1.0.0-alpha.12, the currently tested release. See all Primordial Apple releases.
6. Add the Primordial product to the app target.

https://github.com/fairymeadowslab/primordial-apple.git

Swift Package Apps

If the app itself is a Swift Package, add Primordial in Package.swift and depend on the Primordial product from the package identity primordial-apple.

dependencies: [
    .package(
        url: "https://github.com/fairymeadowslab/primordial-apple.git",
        exact: "1.0.0-alpha.12"
    )
],
targets: [
    .target(
        name: "App",
        dependencies: [
            .product(name: "Primordial", package: "primordial-apple")
        ]
    )
]

Verify installation

After adding the package, run the snippet below. It does not require an account or evaluation key, and helps verify package resolution, module import, and platform support.

import Primordial

let primordial = PrimordialClient()
let status = try primordial.integrationStatus()

print(status.sdkVersion)
print(status.platform)
print(status.isSimulator)

If you run this in the iOS Simulator, stop after this check and switch to a physical iOS or macOS device before using on-device AI.

Next, use an evaluation key while developing. Before distributing your app, replace it with a bundled offline production license.