Installation

SwiftReckless is a Swift Package Manager library.

Requirements

Platform	Minimum
macOS	10.15
iOS	13
tvOS	13
watchOS	6
visionOS	1
Mac Catalyst	13
Android	API 21 (Android 5.0 · arm64 · armv7 · x86_64 · x86, source build)

Swift tools version 6.0. See Build model for the full platform matrix and cross-compile details.

Intel CPU requirement

The prebuilt Apple x86_64 slices intentionally retain AVX2/BMI2 performance and require a Haswell-class Intel CPU or newer. Reckless does not runtime- dispatch this binary to a baseline implementation on older Intel hardware.

AGPL-3.0

SwiftReckless links the Reckless engine and is an AGPL-3.0 work. Consuming it carries AGPL-3.0 obligations on your application. See AGPL-3.0 licensing.

Add the package

// Package.swift
dependencies: [
    .package(url: "https://github.com/fianchettochess/SwiftReckless.git", from: "0.9.10"),
],
targets: [
    .target(
        name: "MyChessApp",
        dependencies: [
            .product(name: "SwiftReckless", package: "SwiftReckless"),
        ]
    ),
]

Xcode

In Xcode: File ▸ Add Package Dependencies…, enter https://github.com/fianchettochess/SwiftReckless.git, and add the SwiftReckless library product to your target.

Products

Product	Description
SwiftReckless	High-level Swift API — RecklessEngine + RecklessNetworkLoader. Recommended for all consumers.
CReckless	Raw C module exposing the four rk_* symbols, for custom engine lifecycle management.

Runtime requirement: the NNUE net

The network file is not bundled

The NNUE network (v54-5478683c.nnue, ~60 MB) is never committed to this repository or to any Fianchetto repository (*.nnue is gitignored). You must provision it at runtime via RecklessNetworkLoader before the engine can start. See NNUE Network Loader.

Apple XCFramework

On Apple platforms the engine links a prebuilt Frameworks/RecklessFFI.xcframework. The XCFramework is committed to main (a path-based binary target), so a fresh clone links with a plain swift build on Apple — no rebuild needed. Rebuild it only when the Rust engine changes:

# macOS only (development)
bash Tools/build-macos.sh
swift build

For the full Apple gamut (iOS, Mac Catalyst, tvOS, watchOS, visionOS):

bash Tools/build-xcframework.sh

The Rust toolchain prerequisites are documented in Build model. The manual release workflow builds and tests the exact XCFramework, runs the Rust targets and terminal-position guard with the verified network staged, tests both Swift package arms plus a SemVer-tagged remote consumer, stages the artifact in a draft release, verifies the uploaded bytes, and creates the final tag once at a url: + checksum: manifest. The source arm's live-engine test records an intentional skip because it links host stubs; the rebuilt binary arm runs the live handshake. Consuming a tagged version via SwiftPM therefore needs no local Rust build.

Verifying the install

swift build
swift test                  # Offline, cancellation, hermetic download, and net-guarded live suites

# Optional live CLI smoke on the Apple binary arm: stage and verify the net first.
mkdir -p rust/networks
curl -fsSL -o rust/networks/v54-5478683c.nnue \
  https://github.com/codedeliveryservice/RecklessNetworks/releases/download/networks/v54-5478683c.nnue
printf '%s  %s\n' \
  '5478683cb1bababde29ae8f29468a99846726548fc6a0ed54cac40ab6d38efbf' \
  'rust/networks/v54-5478683c.nnue' | shasum -a 256 -c -
swift run reckless-smoke    # drives uci → uciok → go depth 1 → bestmove

The default swift test run never touches the network. The live engine smoke test is gated on the net being staged on disk at rust/networks/: present → it runs, absent → a RECORDED skip (visible in the test log, never a silent pass). It also skips on the forced-source macOS arm (SWIFTRECKLESS_FORCE_SOURCE_BUILD=1), which links no-op host stubs rather than the real engine. There is no SWIFTRECKLESS_INTEGRATION env var or separate integration target — gating is by net presence at rust/networks/ plus not being a forced-source stub build.